Anleitung: iOS Ads-Conversions erfassen

Schritt 3: On-Device-Conversion-Messung mit Google Analytics starten

Da Sie jetzt die E-Mail-Adressen und Telefonnummern der Nutzer erfassen können und Ihre App das Google Analytics für das Firebase SDK enthält, können Sie die beiden verwenden, um mit der Conversion-Messung zu beginnen.

API aufrufen

Rufen Sie die Conversion-Analyse-API mit der im ersten Schritt eingeholten E-Mail-Adresse oder Telefonnummer auf, die für die Conversion-Analyse von Anzeigen verwendet wird. Personenidentifizierbare Informationen dürfen das Nutzergerät dabei nicht verlassen.

Es gibt zwei Möglichkeiten, die Analyse zu starten:

• Anmeldedaten verwenden
• Gehashte Anmeldedaten verwenden

E‑Mail-Adresse oder Telefonnummer verwenden

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(emailAddress: "example@gmail.com")
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(phoneNumber: "+15555555555")

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"example@gmail.com"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"+15555555555"];

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithEmailAddress("example@gmail.com");
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithPhoneNumber("+15555555555");

Gehashte E‑Mail-Adresse oder Telefonnummer verwenden

Die API akzeptiert E-Mail-Adressen und Telefonnummern, die mit SHA256 gehasht wurden. Sie können die Kontrolle über die Daten Ihrer Nutzer behalten, indem Sie das Hashing in Ihrem Code durchführen, bevor Sie Aufrufe an das SDK senden.

Wenn Sie gehashte Anmeldedaten verwenden möchten, normalisieren Sie Adressen und Nummern, hashen Sie sie mit SHA256 und rufen Sie dann die API auf.

E‑Mail-Adressen und Telefonnummern normalisieren

Bei E-Mail-Adressen wird in der Google Analytics API davon ausgegangen, dass vor der Anwendung von SHA256 eine bestimmte Normalisierung erfolgt. Gehen Sie daher so vor, um Ihre Daten zu normalisieren:

1. Wandeln Sie die gesamte E-Mail-Adresse in Kleinbuchstaben um.

2. Wenn die E-Mail-Adresse auf die Domain @googlemail.com endet, ersetzen Sie die Domain @googlemail.com durch @gmail.com.

3. Für Adressen, die auf die Domain @gmail.com enden (einschließlich der im vorherigen Schritt geänderten Adressen):

   1. Entfernen Sie alle Punkte aus dem Nutzernamen.

   2. Ersetzen Sie im Nutzernamen die folgenden Werte:

      • Ersetzen Sie die Buchstaben I oder i oder die Ziffer 1 durch den Buchstaben l.
      • Ersetzen Sie die Ziffer 0 durch den Buchstaben o.
      • Ersetzen Sie die zweite Ziffer durch den Buchstaben „z“.
      • Ersetzen Sie die Ziffer 5 durch den Buchstaben s.

Beispiel nach der Normalisierung:

• an.email.user0125@googlemail.com wird zu anemalluserolzs@gmail.com
• CAPSUSER0125@provider.net wird zu capsuser0125@provider.net

Bei Telefonnummern müssen die Nummern bereits im E.164-Format vorliegen (d. h. mit dem Präfix „+“, 1–3 Ziffern für den Ländercode und maximal 12 Ziffern für die Teilnehmernummer), bevor sie mit SHA256 gehasht werden.

Die gehashten SHA256-E-Mail-Adressen oder ‑Telefonnummern müssen 32 Byte lang sein und dürfen kein hexadezimaler String sein.

API mit gehashten Anmeldedaten aufrufen

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(hashedEmailAddress: hashedEmailAddress)
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(hashedPhoneNumber: hashedPhoneNumber)

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedEmailAddress:hashedEmailAddress];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:hashedPhoneNumber];

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(hashedEmailAddress);
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(hashedPhoneNumber);

Integration prüfen

Aktivieren Sie den Debug-Modus. Nachdem Sie die API zum Initiieren der Messung aufgerufen haben, muss in der Xcode-Debugkonsole eine Meldung wie die folgende Logmeldung angezeigt werden:

[FirebaseAnalytics][I-ACS023225] Initiated on-device conversion measurement

Wenn Sie den Debugmodus aktiviert und das Startargument -DebugOnDeviceConversionMeasurement angegeben haben, wird durch den Aufruf der initiateOnDeviceConversionMeasurement() API ein Spiel simuliert.

[FirebaseAnalytics][I-ACS023229] On-device conversion measurement found a match

arrow_back_iosSchritt 2: Google Analytics einbinden Schritt 4: Häufige Probleme beheben und behandelnarrow_forward_ios