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 FirebaseGoogle Analytics, możesz zacząć mierzyć konwersje.

Wywoływanie interfejsu API

Wywołaj interfejs API pomiaru konwersji, aby przekazać adres e-mail lub numer telefonu, na którego użycie użytkownik wyraził zgodę w kroku 1. Te dane są używane do pomiaru konwersji z reklam bez zezwolenia na opuszczenie urządzenia użytkownika przez jakiekolwiek informacje umożliwiające identyfikację.

Pomiar można rozpocząć na 2 sposoby:

• Korzystanie z danych logowania
• Korzystanie z 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 akceptuje adresy e-mail i numery telefonów zahaszowane przy użyciu SHA256. Możesz zachować kontrolę nad danymi użytkownika, wykonując haszowanie w kodzie przed wywołaniem pakietu SDK.

Aby używać zaszyfrowanych danych logowania, znormalizuj adresy i numery, 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 Google Analytics API zakłada, że przed zastosowaniem algorytmu SHA256 przeprowadzana jest określona normalizacja, dlatego aby znormalizować dane, wykonaj te czynności:

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

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 nazwy użytkownika.

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

      • W przypadku liter I lub i albo cyfry 1 użyj litery l.
      • Cyfrę 0 zastąp literą o.
      • W przypadku cyfry 2 użyj litery z.
      • Zamiast cyfry 5 wpisz 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

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

Pamiętaj, że zaszyfrowane adresy e-mail lub numery telefonów SHA256 muszą mieć długość 32 bajtów i nie mogą być ciągiem szesnastkowym.

Wywoływanie interfejsu API za pomocą zahaszowanych 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);

Weryfikowanie integracji

Włącz tryb debugowania. Po wywołaniu interfejsu API initiate measurement sprawdź, czy w konsoli debugowania Xcode wyświetla się komunikat podobny do tego:

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

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

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

arrow_back_iosKrok 2. Zintegruj Google Analytics Krok 4. Rozwiązywanie typowych problemówarrow_forward_ios