Anleitung: iOS Ads-Conversions erfassen

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


Einführung: iOS-Anzeigen-Conversions erfassen

Schritt 1: Anmeldung implementieren

Schritt 2: Google Analytics einbinden

Schritt 3: Mit Google Analytics die On-Device-Conversion-Analyse starten

Schritt 4: Häufige Probleme beheben


Jetzt können Sie die E-Mail-Adressen und Telefonnummern, und Ihre App verfügt über Google Analytics for Firebase SDK – Sie können beide verwenden, um zu beginnen, beim Messen von Conversions.

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, ohne personenbezogene Daten dürfen das Gerät des Nutzers verlassen.

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

E-Mail-Adresse oder Telefonnummer verwenden

Swift Objective-C Einheit

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

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

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

@import FirebaseAnalytics;

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

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

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. Ich kann die Kontrolle über die Daten Ihrer Nutzer behalten, indem er die Hash-Technologie im Code ausführt. bevor Sie Aufrufe an das SDK senden.

Um gehashte Anmeldedaten zu verwenden, Adressen und Zahlen zu normalisieren und sie mit SHA256 ein und rufen Sie dann die API auf.

E-Mail-Adressen und Telefonnummern normal verwenden

Für E-Mail-Adressen geht die Google Analytics API davon aus, dass ein vor der Anwendung von SHA256 durchgeführt wird. Schritte zur Normalisierung Ihrer Daten:

  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 im vorherigen Schritt geänderten):

    1. Entfernen Sie alle Punkte aus dem Teil des Nutzernamens.

    2. Ersetzen Sie den Nutzernamen wie folgt:

      • Für die Buchstaben I oder i oder die Ziffer 1 ersetzen Sie den Buchstaben L
      • Für Ziffer 0 den Buchstaben „O“ ersetzen
      • Für Ziffer 2 den Buchstaben Z ersetzen
      • Für Ziffer 5 den Buchstaben s ersetzen

Nach der Normalisierung geschieht beispielsweise Folgendes:

  • 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. Präfix mit „+“, 1–3 Ziffern für den Ländercode, maximal 12 Ziffern für die Teilnehmernummer).

API mit gehashten Anmeldedaten aufrufen
Swift Objective-C Einheit

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

import FirebaseAnalytics

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

Importiere das FirebaseAnalytics-Modul und gib die E-Mail-Adresse an die initiateOnDeviceConversionMeasurementWithHashedEmailAddress: API oder die Telefonnummer an die initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: API weiter.

@import FirebaseAnalytics;

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

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

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, müssen Sie nach dem Aufrufen der API zur Initiierung der Messung sicherstellen, dass im Xcode-Debugging eine Meldung wie die folgende Console:

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

In Firebase 9.6.0 oder höher, wenn Sie den Fehlerbehebungsmodus aktiviert und den Startargument von -DebugOnDeviceConversionMeasurement und anschließendes Aufrufen der Methode Die initiateOnDeviceConversionMeasurement() API simuliert eine Übereinstimmung.

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



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