Eğitim: iOS Reklamları dönüşümlerini ölçme

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


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

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

2. Adım: Google Analytics entegrasyonunu entegre edin

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

4. Adım: Sorun giderme ve yaygın sorunları çözme


Artık kullanıcıların bilgilerini toplayabilir ve uygulamanız gereken bilgileri Firebase için Google Analytics SDK'sı kullanıyorsanız başlamak için bu ikisini kullanabilirsiniz nasıl ölçeceğinizi öğreneceksiniz.

API'yi çağırma

İzin verilen e-posta adresi veya telefonla dönüşüm ölçümü API'sini çağırın reklam dönüşüm ölçümü için kullanılan 1. adımdaki rastgele sayı Kimliği tanımlayabilecek bilgilerin kullanıcının cihazından ayrılmasına izin verme.

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

E-posta adresi veya telefon numarası kullan

FirebaseAnalytics modülünü içe aktarıp e-posta adresini veya telefonu e-posta üzerinden iletin initiateOnDeviceConversionMeasurement() API'sine gönderebilirsiniz.

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

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

@import FirebaseAnalytics;

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

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

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 oluşturma işlemi uygulanmış bir e-posta adresi veya telefon numarası kullanın

API, SHA256 ile karma oluşturma işlemi uygulanmış e-posta adreslerini ve telefon numaralarını kabul eder. Siz kodunuzda karma oluşturma işlemi gerçekleştirerek kullanıcılarınızın verilerinin kontrolünü elinizde tutabilir yapmanız gerektiğini unutmayın.

Karma oluşturma işlemi uygulanmış kimlik bilgileri kullanmak için adresleri ve numaraları normalleştirin, karma oluşturma işlemi uygulanmış kimlik bilgileri SHA256'yı ayarlayın, ardından API'yi çağırın.

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

E-posta adresleri için Google Analytics API, SHA256 uygulanmadan önce belirli bir normalleştirme gerçekleştirilir; bu nedenle, ş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ıyla bitiyorsa @googlemail.com alan adını @gmail.com ile değiştirin.

  3. @gmail.com alan adıyla biten adresler ( önceki adımda bulabilirsiniz):

    1. Kullanıcı adı bölümündeki tüm noktaları kaldırın.

    2. Kullanıcı adı bölümünde aşağıdaki değişiklikleri yapın:

      • I veya i harfleri ya da 1 rakamı için yedek l harfi
      • 0 rakamı yerine o harfini kullanın
      • 2 rakamının yerine z harfini koyun
      • 5 rakamı için yedek harf s'yi kullanın

Örneğin, normalleştirmeden sonra:

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

Telefon numaraları için numaralar zaten E.164 biçiminde (yani, öneki +, ülke kodu için 1-3 hane, abone numarası için maks. 12 hane) SHA256 ile karma oluşturma işlemi uygulayın.

Karma oluşturma işlemi uygulanmış kimlik bilgileriyle API'yi çağırma

FirebaseAnalytics modülünü içe aktarıp e-posta adresini veya telefonu e-posta üzerinden iletin initiateOnDeviceConversionMeasurement() API'sine gönderebilirsiniz.

import FirebaseAnalytics

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

FirebaseAnalytics modülünü içe aktarın ve e-posta adresini initiateOnDeviceConversionMeasurementWithHashedEmailAddress: API veya telefon initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: için sayı API'ye gidin.

@import FirebaseAnalytics;

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

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

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ğrulama (isteğe bağlı)

Hata ayıklama modunu etkinleştirdiyseniz başlatılan Measurement API'yi çağırdıktan sonra Xcode hata ayıklamasında aşağıdaki günlük mesajına benzer bir mesaj görüntüleniyor konsol:

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ştirip -DebugOnDeviceConversionMeasurement bağımsız değişkeni başlatıldıktan sonra initiateOnDeviceConversionMeasurement() API, eşleşmeyi simüle edecek.

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




2. adım: Google Analytics entegrasyonu 4. adım: Sık karşılaşılan sorunları giderin ve giderin