Samouczek: pomiar konwersji w Google Ads

Krok 3. Rozpocznij pomiar konwersji na urządzeniu za pomocą narzędzia Google Analytics


Wprowadzenie: Pomiar konwersji z reklam na iOS

Krok 1. Zaimplementuj funkcję logowania

Krok 2. Zintegruj Google Analytics

Krok 3. Rozpocznij pomiar konwersji na urządzeniu za pomocą Google Analytics

Krok 4. Rozwiązywanie typowych problemów


Teraz, gdy możesz zbierać adresy e-mail i numery telefonów użytkowników, a Twoja aplikacja ma pakiet SDK FirebaseGoogle Analytics, możesz zacząć mierzyć konwersje.

Wywoływanie interfejsu API

Wywołaj interfejs Measurement Conversion API, podając adres e-mail lub numer telefonu, na który użytkownik wyraził zgodę w kroku 1. Interfejs ten służy do pomiaru konwersji reklam, ale nie pozwala na przekazywanie na urządzenie użytkownika żadnych informacji umożliwiających identyfikację.

Pomiar można rozpocząć na 2 sposoby:

Używanie adresu e-mail lub numeru telefonu

Swift

Zaimportuj moduł FirebaseAnalytics i przekaż adres e-mail lub numer telefonu do interfejsu API initiateOnDeviceConversionMeasurement().

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

Objective-C

Zaimportuj moduł FirebaseAnalytics i przekaż adres e-mail do interfejsu API initiateOnDeviceConversionMeasurementWithEmailAddress: lub numer telefonu do interfejsu API initiateOnDeviceConversionMeasurementWithPhoneNumber:.

@import FirebaseAnalytics;

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

Unity

Zaimportuj nazwę przestrzeni Firebase.Analytics i przekaż adres e-mail do interfejsu InitiateOnDeviceConversionMeasurementWithEmailAddress() API lub numer telefonu do interfejsu InitiateOnDeviceConversionMeasurementWithPhoneNumber() API:

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

Użyj zaszyfrowanego adresu e-mail lub numeru telefonu

Interfejs API akceptuje adresy e-mail i numery telefonów zaszyfrowane za pomocą algorytmu SHA256. Możesz zachować kontrolę nad danymi użytkownika, wykonując szyfrowanie w kodzie przed wywołaniem pakietu SDK.

Aby używać zaszyfrowanych danych uwierzytelniających, znormalizuj adresy i liczby, zaszyfruj je za pomocą algorytmu SHA256, a następnie wywołaj interfejs API.

Normalizowanie adresów e-mail i numerów telefonów

W przypadku adresów e-mail interfejs API Google Analytics zakłada, że przed zastosowaniem algorytmu SHA-256 zostanie przeprowadzona odpowiednia normalizacja. Aby ją przeprowadzić, wykonaj te czynności:

  1. Konwertuj cały adres e-mail na małe litery.

  2. Jeśli adres e-mail kończy się na domenę @googlemail.com, zastąp domenę @googlemail.com domeną @gmail.com.

  3. W przypadku adresów kończących się na @gmail.com (także tych zmodyfikowanych w poprzednim kroku):

    1. Usuń wszystkie kropki z nazwy użytkownika.

    2. W części dotyczącej nazwy użytkownika wprowadź te zamiany:

      • Litery I lub i oraz cyfrę 1 należy zastąpić literą l.
      • Zamiast cyfry 0 wpisz literę o.
      • Zamiast cyfry 2 wpisz literę z.
      • Aby zastąpić cyfrę 5, zastąp literę s

Na przykład po normalizacji:

  • an.email.user0125@googlemail.com zmienia się w anemalluserolzs@gmail.com
  • CAPSUSER0125@provider.net zmienia się w capsuser0125@provider.net

Numery telefonów muszą mieć już format E.164 (czyli prefiks +, 1–3 cyfry kodu kraju i maksymalnie 12 cyfr numeru abonenckiego) przed zaszyfrowaniem za pomocą SHA256.

Wywoływanie interfejsu API z zaszyfrowanymi danymi uwierzytelniającymi

Swift

Zaimportuj moduł FirebaseAnalytics i podaj adres e-mail lub numer telefonu do interfejsu API initiateOnDeviceConversionMeasurement().

import FirebaseAnalytics

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

Objective-C

Zaimportuj moduł FirebaseAnalytics i przekaż adres e-mail do interfejsu API initiateOnDeviceConversionMeasurementWithHashedEmailAddress: lub numer telefonu do interfejsu API initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:.

@import FirebaseAnalytics;

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

Unity

Zaimportuj przestrzeń nazw Firebase.Analytics i przekaż adres e-mail do interfejsu API InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() lub numer telefonu do interfejsu API InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber():

using Firebase.Analytics;

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

Weryfikacja za pomocą dzienników debugowania Xcode (opcjonalnie)

Jeśli włączysz tryb debugowania, po wywołaniu interfejsu API initiate measurement sprawdź, czy w konsoli debugowania Xcode pojawi się komunikat podobny do tego:

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

W wersji Firebase 9.6.0 lub nowszej, jeśli włączysz tryb debugowania i uwzględnisz argument -DebugOnDeviceConversionMeasurement, wywołanie interfejsu API initiateOnDeviceConversionMeasurement() spowoduje symulację dopasowania.

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



Krok 2. Integracja Google Analytics Krok 4. Rozwiązywanie problemów i rozpatrywanie typowych kwestii