Samouczek: pomiar konwersji w Google Ads

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


Wprowadzenie: Pomiar konwersji w Google Ads na urządzeniach z iOS

Krok 1. Wprowadź proces logowania

Krok 2. Zintegruj Google Analytics

Krok 3. Rozpocznij pomiar konwersji na urządzeniu za pomocą tagu 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 Firebase Google Analytics, możesz zacząć mierzyć konwersje.

Wywoływanie interfejsu API

Wywołaj interfejs API służący do pomiaru konwersji, 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 podaj 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 podaj 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 API InitiateOnDeviceConversionMeasurementWithEmailAddress() lub numer telefonu do interfejsu API InitiateOnDeviceConversionMeasurementWithPhoneNumber():

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 logowania, znormalizuj adresy i numery, zaszyfruj je za pomocą algorytmu SHA256, a potem 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ę domeną @gmail.com (w tym tych, które zostały zmodyfikowane w poprzednim kroku):

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

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

      • W przypadku liter I lub i lub cyfry 1 należy zastąpić literę l.
      • Zamiast cyfry 0 wpisz literę o.
      • Zamiast cyfry 2 wpisz literę 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

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.

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ą zaszyfrowanych danych logowania

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(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 nazwę przestrzeni Firebase.Analytics i przekaż adres e-mail do interfejsu InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() API lub numer telefonu do interfejsu InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() API:

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:

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

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

[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