Tutorial: Messen Sie die Conversions von iOS-Anzeigen

Schritt 3: Starten Sie die Conversion-Messung auf dem Gerät mithilfe von Google Analytics

Einführung: Messen Sie die Conversions von iOS-Anzeigen

Schritt 1: Implementieren Sie ein Anmeldeerlebnis

Schritt 2: Google Analytics integrieren

Schritt 3: Starten Sie die Conversion-Messung auf dem Gerät mithilfe von Google Analytics

Schritt 4: Häufige Probleme beheben und beheben

Da Sie nun die E-Mail-Adressen und Telefonnummern der Nutzer erfassen können und Ihre App über das Google Analytics for Firebase SDK verfügt, können Sie beides verwenden, um mit der Messung von Conversions zu beginnen.

Rufen Sie die API auf

Rufen Sie die Conversion-Messungs-API mit der in Schritt 1 genehmigten E-Mail-Adresse oder Telefonnummer auf, die für die Anzeigen-Conversion-Messung verwendet wird, ohne dass personenbezogene Daten das Benutzergerät verlassen.

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

• Anmeldeinformationen verwenden
• Verwendung gehashter Anmeldeinformationen

Verwenden Sie eine E-Mail-Adresse oder Telefonnummer

Schnell

Importieren Sie das FirebaseAnalytics Modul und übergeben Sie die E-Mail-Adresse oder Telefonnummer an die API initiateOnDeviceConversionMeasurement() .

Hinweis: Die Methoden initiateOnDeviceConversionMeasurement(emailAddress:) und initiateOnDeviceConversionMeasurement(phoneNumber:) können nacheinander aufgerufen werden, es kann jedoch nur eine Übereinstimmung pro Benutzer gemeldet werden. Wenn eine Übereinstimmung mit einer der APIs gefunden wird, werden nachfolgende API-Aufrufe effektiv ignoriert.

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(emailAddress: "[e-mail]")
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(phoneNumber: "[phone]")

Ziel c

Importieren Sie das FirebaseAnalytics Modul und übergeben Sie die E-Mail-Adresse an die API initiateOnDeviceConversionMeasurementWithEmailAddress: oder die Telefonnummer an die API initiateOnDeviceConversionMeasurementWithPhoneNumber: “.

Hinweis: Die Methoden initiateOnDeviceConversionMeasurementWithEmailAddress: und initiateOnDeviceConversionMeasurementWithPhoneNumber: können nacheinander aufgerufen werden, es kann jedoch nur eine Übereinstimmung pro Benutzer gemeldet werden. Wenn eine Übereinstimmung mit einer der APIs gefunden wird, werden nachfolgende API-Aufrufe effektiv ignoriert.

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"[e-mail]"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"[phone]"];

Einheit

Importieren Sie den Firebase.Analytics -Namespace und übergeben Sie die E-Mail-Adresse an die InitiateOnDeviceConversionMeasurementWithEmailAddress() API oder die Telefonnummer an die InitiateOnDeviceConversionMeasurementWithPhoneNumber() API:

Hinweis: Die Methoden InitiateOnDeviceConversionMeasurementWithEmailAddress() und InitiateOnDeviceConversionMeasurementWithPhoneNumber() können nacheinander aufgerufen werden, es kann jedoch nur eine Übereinstimmung pro Benutzer gemeldet werden. Wenn eine Übereinstimmung mit einer der APIs gefunden wird, werden nachfolgende API-Aufrufe effektiv ignoriert.

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithEmailAddress("[e-mail]");
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithPhoneNumber("[phone]");

Hinweis: Der Abgleich von E-Mail-Adresse und Telefonnummer muss nur einmal pro Installation auf dem Gerät erfolgen, und der Abgleich erfolgt idealerweise so kurz wie möglich bei der Anmeldung.

Verwenden Sie eine gehashte E-Mail-Adresse oder Telefonnummer

Die API akzeptiert mit SHA256 gehaschte E-Mail-Adressen und Telefonnummern. Sie können die Kontrolle über die Daten Ihrer Benutzer behalten, indem Sie das Hashing in Ihrem Code durchführen, bevor Sie das SDK aufrufen.

Um gehashte Anmeldeinformationen zu verwenden, normalisieren Sie Adressen und Nummern, hashen Sie sie mit SHA256 und rufen Sie dann die API auf.

E-Mail-Adressen und Telefonnummern normalisieren

Für E-Mail-Adressen geht die Google Analytics API davon aus, dass eine bestimmte Normalisierung durchgeführt wird, bevor SHA256 angewendet wird. Befolgen Sie daher diese Schritte, 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 Benutzernamen.

   2. Nehmen Sie im Abschnitt „Benutzername“ die folgenden Ersetzungen vor:

      • 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 Ziffer 2 durch den Buchstaben z
      • Ersetzen Sie Ziffer 5 durch den Buchstaben s

Zum Beispiel nach der Normalisierung:

• aus [e-mail] wird [e-mail]
• [e-mail] wird zu [e-mail]

Bei Telefonnummern müssen die Nummern vor dem Hashing mit SHA256 bereits im E.164-Format vorliegen (d. h. Präfix mit +, 1–3 Ziffern für die Landesvorwahl, maximal 12 Ziffern für die Teilnehmernummer).

Rufen Sie die API mit gehashten Anmeldeinformationen auf

Schnell

Importieren Sie das FirebaseAnalytics Modul und übergeben Sie die E-Mail-Adresse oder Telefonnummer an die API initiateOnDeviceConversionMeasurement() .

Hinweis: Die Methoden initiateOnDeviceConversionMeasurement(hashedEmailAddress:) und initiateOnDeviceConversionMeasurement(hashedPhoneNumber:) können nacheinander aufgerufen werden, es kann jedoch nur eine Übereinstimmung pro Benutzer gemeldet werden. Wenn eine Übereinstimmung mit einer der APIs gefunden wird, werden nachfolgende API-Aufrufe effektiv ignoriert.

import FirebaseAnalytics

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

Ziel c

Importieren Sie das FirebaseAnalytics Modul und übergeben Sie die E-Mail-Adresse an die API initiateOnDeviceConversionMeasurementWithHashedEmailAddress: oder die Telefonnummer an die API initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: “.

Hinweis: Die Methoden initiateOnDeviceConversionMeasurementWithHashedEmailAddress: und initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: können nacheinander aufgerufen werden, es kann jedoch nur eine Übereinstimmung pro Benutzer gemeldet werden. Wenn eine Übereinstimmung mit einer der APIs gefunden wird, werden nachfolgende API-Aufrufe effektiv ignoriert.

@import FirebaseAnalytics;

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

Einheit

Importieren Sie den Firebase.Analytics Namespace und übergeben Sie die E-Mail-Adresse an die InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() API oder die Telefonnummer an die InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() API:

Hinweis: Die Methoden InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() und InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() können nacheinander aufgerufen werden, es kann jedoch nur eine Übereinstimmung pro Benutzer gemeldet werden. Wenn eine Übereinstimmung mit einer der beiden APIs gefunden wird, werden nachfolgende API-Aufrufe effektiv ignoriert.

using Firebase.Analytics;

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

Hinweis: Der Abgleich von E-Mail-Adresse und Telefonnummer muss nur einmal pro Installation auf dem Gerät erfolgen, und der Abgleich erfolgt idealerweise so kurz wie möglich bei der Anmeldung.

Überprüfung mit Xcode-Debug-Protokollen (optional)

Wenn Sie den Debug-Modus aktiviert haben, stellen Sie nach dem Aufruf der API zum Initiieren der Messung sicher, dass eine Meldung wie die folgende Protokollmeldung in der Xcode-Debug-Konsole angezeigt wird:

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 eingefügt haben, simuliert der Aufruf der API initiateOnDeviceConversionMeasurement() eine Übereinstimmung.

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

---

Schritt 2 : Google Analytics integrieren Schritt 4 : Häufige Probleme beheben und beheben

---