Öğretici: iOS Reklamları dönüşümlerini ölçme

3. Adım: Google Analytics'i kullanarak cihaz üzerinde dönüşüm ölçümünü başlatın


Giriş: iOS Reklamları dönüşümlerini ölçme

1. Adım: Oturum açma deneyimini uygulayın

2. Adım: Google Analytics'i entegre edin

3. Adım: Google Analytics'i kullanarak cihaz üzerinde dönüşüm ölçümünü başlatın

4. Adım: Yaygın sorunları giderin ve ele alın


Artık kullanıcıların e-posta adreslerini ve telefon numaralarını toplayabildiğinize ve uygulamanızda Firebase için Google Analytics SDK'sı bulunduğuna göre, dönüşümleri ölçmeye başlamak için ikisini kullanabilirsiniz.

API'yi çağırın

Reklam dönüşüm ölçümü için kullanılan, 1. Adımdaki izin verilen e-posta adresi veya telefon numarasıyla dönüşüm ölçüm API'sini, kişisel olarak tanımlanabilir herhangi bir bilginin kullanıcı cihazından çıkmasına izin vermeden çağırın.

Ölçümü başlatmanın iki yolu vardır:

E-posta adresini veya telefon numarasını kullanın

Süratli

FirebaseAnalytics modülünü içe aktarın ve e-posta adresini veya telefon numarasını initiateOnDeviceConversionMeasurement() API'sine iletin.

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

Amaç-C

FirebaseAnalytics modülünü içe aktarın ve e-posta adresini initiateOnDeviceConversionMeasurementWithEmailAddress: API'sine veya telefon numarasını initiateOnDeviceConversionMeasurementWithPhoneNumber: API'sine iletin.

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"example@gmail.com"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"+15555555555"];

Birlik

Firebase.Analytics ad alanını içe aktarın ve e-posta adresini InitiateOnDeviceConversionMeasurementWithEmailAddress() API'sine veya telefon numarasını InitiateOnDeviceConversionMeasurementWithPhoneNumber() API'sine iletin:

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

Karma hale getirilmiş bir e-posta adresi veya telefon numarası kullanın

API, SHA256 ile hashlenmiş e-posta adreslerini ve telefon numaralarını kabul edecektir. SDK'ya çağrı yapmadan önce kodunuzda karma işlemi gerçekleştirerek kullanıcı verilerinin kontrolünü elinizde tutabilirsiniz.

Hashing uygulanmış kimlik bilgilerini kullanmak için adresleri ve numaraları normalleştirin, SHA256 ile hashing yapın ve ardından API'yi çağırın.

E-posta adreslerini ve telefon numaralarını normalleştirin

E-posta adresleri için Google Analytics API, SHA256 uygulanmadan önce belirli bir normalleştirmenin gerçekleştirildiğini varsayar; dolayısıyla verilerinizi normalleştirmek için şu adımları izleyin:

  1. E-posta adresinin tamamını küçük harfe dönüştürün.

  2. E-posta adresi @googlemail.com alan adı ile bitiyorsa, @googlemail.com alan adını @gmail.com ile değiştirin.

  3. @gmail.com alanıyla biten adresler için (önceki adımda değiştirilenler dahil):

    1. Kullanıcı adı kısmındaki tüm noktaları kaldırın.

    2. Kullanıcı adı kısmında aşağıdaki değişiklikleri yapın:

      • I veya i harfleri veya 1 rakamı için l harfini değiştirin
      • 0 rakamının yerine o harfi koyun
      • 2. rakamın yerine z harfini koyun
      • 5. rakamı s harfiyle değiştirin

Örneğin normalleştirmeden sonra:

  • an.email.user0125@googlemail.com , anemlluserolzs@gmail.com olur
  • CAPSUSER0125@provider.net , capsuser0125@provider.net olur

Telefon numaraları için, SHA256 ile karma işleminden önce numaraların zaten E.164 biçiminde olması gerekir (yani, + içeren önek, ülke kodu için 1-3 rakam, abone numarası için maksimum 12 rakam).

API'yi karma kimlik bilgileriyle çağırın

Süratli

FirebaseAnalytics modülünü içe aktarın ve e-posta adresini veya telefon numarasını initiateOnDeviceConversionMeasurement() API'sine iletin.

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(hashedEmailAddress: hashedEmailAddress)
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(hashedPhoneNumber: hashedPhoneNumber)

Amaç-C

FirebaseAnalytics modülünü içe aktarın ve e-posta adresini initiateOnDeviceConversionMeasurementWithHashedEmailAddress: API'sine veya telefon numarasını initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: API'sine iletin.

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedEmailAddress:hashedEmailAddress];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:hashedPhoneNumber];

Birlik

Firebase.Analytics ad alanını içe aktarın ve e-posta adresini InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() API'sine veya telefon numarasını InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() API'sine iletin:

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(hashedEmailAddress);
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(hashedPhoneNumber);

Xcode hata ayıklama günlükleriyle doğrulayın (isteğe bağlı)

Hata ayıklama modunu etkinleştirdiyseniz ölçüm başlatma API'sini çağırdıktan sonra Xcode hata ayıklama konsolunda aşağıdaki günlük mesajına benzer bir mesajın göründüğünden emin olun:

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

Firebase 9.6.0 veya sonraki sürümlerde, hata ayıklama modunu etkinleştirdiyseniz ve -DebugOnDeviceConversionMeasurement başlatma bağımsız değişkenini eklediyseniz, initiateOnDeviceConversionMeasurement() API'sinin çağrılması bir eşleşme simülasyonu gerçekleştirir.

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




2. Adım : Google Analytics'i entegre edin 4. Adım : Sık karşılaşılan sorunları giderin ve ele alın