Samouczek: pomiar konwersji w Google Ads

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

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

Wywoływanie interfejsu API

Wywołaj interfejs API pomiaru konwersji, podając adres e-mail lub numer telefonu użytkownika, który wyraził zgodę na przetwarzanie danych (z kroku 1). Te dane są używane do pomiaru konwersji z reklam bez opuszczania urządzenia użytkownika przez jakiekolwiek informacje umożliwiające identyfikację.

Pomiar można rozpocząć na 2 sposoby:

• za pomocą danych logowania,
• za pomocą zaszyfrowanych danych logowania.

Użyj 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 będzie akceptować adresy e-mail i numery telefonów zaszyfrowane za pomocą SHA256. Możesz zachować kontrolę nad danymi użytkownika, szyfrując je w kodzie przed wywołaniem pakietu SDK.

Aby użyć zaszyfrowanych danych logowania, znormalizuj adresy i numery, zaszyfruj je za pomocą 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 SHA256 przeprowadzana jest określona normalizacja, dlatego aby znormalizować dane, wykonaj te czynności:

1. Zmień wszystkie litery w adresie e-mail na małe.

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

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

   1. Usuń wszystkie kropki z części adresu e-mail zawierającej nazwę użytkownika.

   2. W części adresu e-mail zawierającej nazwę użytkownika wprowadź te zamiany:

      • litery I lub i albo cyfrę 1 zastąp literą l,
      • cyfrę 0 zastąp literą o,
      • cyfrę 2 zastąp literą z,
      • cyfrę 5 zastąp literą s.

Na przykład po normalizacji:

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

W przypadku numerów telefonów przed zaszyfrowaniem za pomocą SHA256 numery muszą być w formacie E.164 (czyli muszą zaczynać się od znaku +, zawierać 1–3 cyfry kodu kraju i maksymalnie 12 cyfr numeru abonenta ).

Pamiętaj, że zaszyfrowany adres e-mail lub numer telefonu SHA256 musi mieć długość 32 bajtów i nie może być ciągiem szesnastkowym.

Wywoływanie interfejsu API za pomocą zaszyfrowanych danych logowania

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

Sprawdzanie integracji

Włącz tryb debugowania. Po wywołaniu interfejsu API inicjowania pomiaru sprawdź, czy w konsoli debugowania Xcode pojawi się komunikat logu podobny do tego:

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

Jeśli włączysz tryb debugowania i dodasz argument uruchamiania -DebugOnDeviceConversionMeasurement, wywołanie interfejsu API initiateOnDeviceConversionMeasurement() spowoduje symulację dopasowania.

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

arrow_back_iosKrok 2. Zintegruj Google Analytics Krok 4. Rozwiąż typowe problemyarrow_forward_ios