Samouczek: Mierz konwersje reklam na iOS

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 używać ich do rozpoczęcia pomiaru konwersji.

Zadzwoń do API

Wywołaj interfejs API pomiaru konwersji, podając zatwierdzony adres e-mail lub numer telefonu z kroku 1, który jest używany do pomiaru konwersji reklam, nie pozwalając, aby jakiekolwiek informacje umożliwiające identyfikację opuściły urządzenie użytkownika.

Istnieją dwa sposoby rozpoczęcia pomiaru:

• Korzystanie z poświadczeń
• Korzystanie z haszowanych danych uwierzytelniających

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 zaszyfrowane za pomocą SHA256. Możesz zachować kontrolę nad danymi użytkownika, wykonując skrót w kodzie przed wykonaniem wywołań do zestawu SDK.

Aby użyć hashowanych poświadczeń, znormalizuj adresy i numery, zaszyfruj je za pomocą SHA256, a następnie wywołaj interfejs API.

Normalizuj adresy e-mail i numery telefonów

W przypadku adresów e-mail interfejs API Google Analytics zakłada, że ​​przed zastosowaniem SHA256 przeprowadzana jest określona normalizacja, dlatego wykonaj następujące kroki, aby znormalizować dane:

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

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

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

   1. Usuń wszystkie kropki z części nazwy użytkownika.

   2. Dokonaj następujących podstawień w części nazwy użytkownika:

      • W przypadku liter I lub i lub cyfry 1 należy zastąpić literę l
      • W przypadku cyfry 0 należy zastąpić literę o
      • W przypadku cyfry 2 należy zastąpić literę z
      • W przypadku cyfry 5 należy zastąpić literę s

Na przykład po normalizacji:

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

W przypadku numerów telefonów numery muszą być już w formacie E.164 (tj. prefiks z +, 1–3 cyfry w przypadku kodu kraju, maksymalnie 12 cyfr w przypadku numeru abonenta) przed hashowaniem za pomocą SHA256.

Wywołaj interfejs API z zaszyfrowanymi poświadczeniami

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

Sprawdź za pomocą dzienników debugowania Xcode (opcjonalnie)

Jeśli włączyłeś tryb debugowania, po wywołaniu interfejsu API inicjowania pomiaru upewnij się, że w konsoli debugowania Xcode pojawi się komunikat podobny do następującego komunikatu dziennika:

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

W Firebase 9.6.0 lub nowszym, jeśli włączono tryb debugowania i uwzględniono argument uruchamiania -DebugOnDeviceConversionMeasurement , wówczas wywołanie interfejsu API initiateOnDeviceConversionMeasurement() przeprowadzi symulację dopasowania.

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

arrow_back_ios Krok 2 : Zintegruj Google Analytics Krok 4 : Rozwiązywanie typowych problemów i rozwiązywanie typowych problemów arrow_forward_ios