Anleitung: iOS Ads-Conversions erfassen

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

Nachdem Sie die E‑Mail-Adressen und Telefonnummern der Nutzer erfasst haben und Ihre App das Google Analytics für Firebase SDK enthält, können Sie mit diesen beiden Elementen Conversions messen.

API aufrufen

Rufen Sie die Conversion-Messungs-API mit der E‑Mail-Adresse oder Telefonnummer auf, die Sie im ersten Schritt mit Einwilligung erfasst haben. Diese wird für die Conversion-Messung von Anzeigen verwendet, ohne dass personenidentifizierbare Informationen das Gerät des Nutzers verlassen.

Es gibt zwei Möglichkeiten, die Messung 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 die 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 geht die Google Analytics API davon aus, dass eine bestimmte Normalisierung erfolgt, bevor SHA256 angewendet wird. Führen Sie daher die folgenden Schritte aus, um Ihre Daten zu normalisieren:

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

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

3. Für Adressen, die mit der 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 Ziffer „2“ 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 einem „+“ beginnen, 1–3 Ziffern für den Ländercode und maximal 12 Ziffern für die Teilnehmernummer enthalten ), bevor sie mit SHA256 gehasht werden.

Die gehashten SHA256-E‑Mail-Adressen oder ‑Telefonnummern müssen 32 Byte lang sein und dürfen keine Hexadezimalstrings 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);

Einbindung verifizieren

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

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

Wenn Sie den Debug-Modus aktiviert und das Startargument -DebugOnDeviceConversionMeasurement eingefügt haben, wird beim Aufrufen der API initiateOnDeviceConversionMeasurement() ein Treffer simuliert.

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

arrow_back_iosSchritt 2: Google Analytics einbinden Schritt 4: Häufige Probleme behebenarrow_forward_iosGoogle Analytics