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

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 bu ikisini kullanabilirsiniz.

API'yi çağırma

1. adımda izin verilen e-posta adresini veya telefon numarasını kullanarak dönüşüm ölçümü API'sini çağırın. Bu API, reklam dönüşümü ölçümü için kullanılır ve kimliği tanımlayabilecek bilgilerin kullanıcı cihazından ayrılmasına izin vermez.

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

• Kimlik bilgilerini kullanma
• Karma oluşturma işlemi uygulanmış kimlik bilgilerini kullanma

E-posta adresi veya telefon numarası kullanma

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

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. SDK'ya çağrı yapmadan önce kodunuzda karma oluşturma işlemini gerçekleştirerek kullanıcı verilerinizin kontrolünü elinizde tutabilirsiniz.

Karma oluşturma işlemi uygulanmış kimlik bilgilerini kullanmak için adresleri ve sayıları normalleştirin, SHA256 ile karma oluşturma işlemi uygulayın ve ardından API'yi çağırın.

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

Google Analytics API, e-posta adresleri için SHA256 uygulanmadan önce belirli bir normalleştirme işleminin yapıldığını varsayar. Bu nedenle, verilerinizi normalleştirmek için aşağıdaki adımları uygulayın:

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ını @gmail.com ile değiştirin.

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

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

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

      • I veya i harfleri ya da 1 rakamı yerine l harfi
      • 0 rakamı yerine o harfi
      • 2 rakamı yerine z harfi
      • 5 rakamı yerine s harfi

Örneğin, normalleştirmeden sonra:

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

Telefon numaraları, SHA256 ile karma oluşturma işlemine tabi tutulmadan önce E.164 biçiminde (yani + ile başlayan ön ek, ülke kodu için 1-3 basamak, abone numarası için en fazla 12 basamak) olmalıdır.

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

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

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

Hata ayıklama modunu etkinleştirdiyseniz initiate measurement API'yi ç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ştirip -DebugOnDeviceConversionMeasurement başlatma bağımsız değişkenini dahil ettiyseniz initiateOnDeviceConversionMeasurement() API'nin çağrılması bir eşleşme simülasyonu yapar.

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

arrow_back_ios2. Adım: Google Analytics'i entegre edin 4. Adım: Sık karşılaşılan sorunları giderin ve yönetinarrow_forward_ios