Anleitung: iOS Ads-Conversions erfassen

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

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

Rufen Sie die Conversion Measurement API mit der E-Mail-Adresse oder Telefonnummer aus Schritt 1 auf, die für die Conversion-Analyse von Anzeigen verwendet wird, ohne dass personenidentifizierbare Informationen 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");

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 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 vor der Anwendung von SHA256 eine bestimmte Normalisierung durchgeführt 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 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):

   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.
      • 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

Telefonnummern müssen vor dem Hashing mit SHA256 bereits im E.164-Format vorliegen, d. h. mit Präfix „+“, 1–3 Ziffern für den Ländercode und maximal 12 Ziffern für die Teilnehmernummer.

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

Mit Xcode-Fehlerbehebungsprotokollen bestätigen (optional)

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

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

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

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

arrow_back_iosSchritt 2: Google Analytics integrieren Schritt 4: Fehler beheben und häufige Probleme behebenarrow_forward_ios