Anleitung: iOS Ads-Conversions erfassen

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

Da Sie jetzt E-Mail-Adressen und Telefonnummern von Nutzern erfassen können und Ihre App die Google Analytics für das Firebase SDK enthält, können Sie damit beginnen, Conversions zu erfassen.

API aufrufen

Conversion Measurement API mit der E-Mail-Adresse oder Telefonnummer aufrufen, für die die Einwilligung erteilt wurde aus Schritt 1, die für die Conversion-Analyse verwendet wird, personenbezogene Daten dürfen das Gerät des Nutzers verlassen.

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

• Anmeldedaten verwenden
• Hash-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");

Verwenden Sie eine gehashte E-Mail-Adresse oder Telefonnummer

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 die Hash-Technologie in Ihrem Code verwenden, bevor Sie das SDK aufrufen.

Wenn Sie gehashte Anmeldedaten verwenden möchten, normalisieren Sie Adressen und Zahlen, 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 durchgeführt wird, 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. Endet die E-Mail-Adresse auf @googlemail.com, ersetzen Sie den Domain @googlemail.com mit @gmail.com.

3. Für Adressen, die auf die Domain @gmail.com enden (einschließlich der in vorheriger Schritt):

   1. Entfernen Sie alle Punkte aus dem Nutzernamen.

   2. Ersetzen Sie im Bereich für den Nutzernamen die folgenden Elemente:

      • 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.
      • Für Ziffer 5 den Buchstaben s ersetzen

Beispiel nach der Normalisierung:

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

Telefonnummern müssen bereits im E.164-Format vorliegen, also Präfix mit +, 1-3 Ziffern für die Landesvorwahl, maximal 12 Ziffern für die Abonnentennummer) die Hash-Technologie mit SHA256 verwenden.

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);

Mit Xcode-Fehlerbehebungsprotokollen prüfen (optional)

Wenn Sie den Debug-Modus aktiviert haben, muss nach dem Aufrufen der API zur Messung eine Meldung wie die folgende Protokollmeldung in der Xcode-Debugkonsole angezeigt werden:

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

Wenn Sie in Firebase 9.6.0 oder höher den Debug-Modus aktiviert und das Startargument -DebugOnDeviceConversionMeasurement angegeben haben, wird durch den Aufruf der initiateOnDeviceConversionMeasurement() API ein Abgleich simuliert.

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

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