Samouczek: pomiar konwersji w Google Ads

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

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:

• Za pomocą danych logowania
• Korzystanie z zaszyfrowanych danych logowania

Używanie adresu e-mail lub numeru telefonu

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

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

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

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

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