Tutorial: Mengukur konversi Iklan iOS

Langkah 3: Mulai pengukuran konversi di perangkat menggunakan Google Analytics

Setelah Anda dapat mengumpulkan alamat email dan nomor telepon pengguna serta aplikasi Anda memiliki Google Analytics untuk Firebase SDK, Anda dapat menggunakan keduanya untuk mulai mengukur konversi.

Memanggil API

Panggil API pengukuran konversi dengan alamat email atau nomor telepon yang telah disetujui dari Langkah 1, yang digunakan untuk pengukuran konversi iklan, tanpa mengizinkan informasi identitas pribadi apa pun keluar dari perangkat pengguna.

Ada dua cara untuk memulai pengukuran:

• Menggunakan kredensial
• Menggunakan kredensial yang di-hash

Menggunakan alamat email atau nomor telepon

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

Menggunakan alamat email atau nomor telepon yang di-hash

API akan menerima alamat email dan nomor telepon yang di-hash dengan SHA256. Anda dapat mempertahankan kontrol atas data pengguna dengan melakukan hashing dalam kode sebelum melakukan panggilan ke SDK.

Untuk menggunakan kredensial yang di-hash, normalisasi alamat dan nomor, hash dengan SHA256, lalu panggil API.

Menormalisasi alamat email dan nomor telepon

Untuk alamat email, Google Analytics API mengasumsikan bahwa normalisasi tertentu dilakukan sebelum SHA256 diterapkan, jadi ikuti langkah-langkah berikut untuk menormalisasi data Anda:

1. Konversi seluruh alamat email menjadi huruf kecil.

2. Jika alamat email berakhir dengan domain @googlemail.com, ganti domain @googlemail.com dengan @gmail.com.

3. Untuk alamat yang diakhiri dengan domain @gmail.com (termasuk yang diubah pada langkah sebelumnya):

   1. Hapus semua titik dari bagian nama pengguna.

   2. Lakukan penggantian berikut di bagian nama pengguna:

      • Untuk huruf I atau i, atau angka 1, ganti dengan huruf l
      • Untuk angka 0, ganti dengan huruf o
      • Untuk digit 2, ganti dengan huruf z
      • Untuk angka 5, ganti dengan huruf s

Misalnya, setelah normalisasi:

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

Untuk nomor telepon, nomor harus sudah dalam format E.164 (yaitu, diawali dengan +, 1-3 digit untuk kode negara, maksimal 12 digit untuk nomor pelanggan) sebelum di-hash dengan SHA256.

Perhatikan bahwa email atau nomor telepon SHA256 yang di-hash harus memiliki panjang 32 byte dan bukan string heksadesimal.

Memanggil API dengan kredensial yang di-hash

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

Memverifikasi integrasi

Aktifkan mode debug. Setelah memanggil API mulai pengukuran, pastikan pesan seperti pesan log berikut muncul di konsol debug Xcode:

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

Jika Anda mengaktifkan mode debug dan menyertakan argumen peluncuran -DebugOnDeviceConversionMeasurement, maka panggilan API initiateOnDeviceConversionMeasurement() akan menyimulasikan kecocokan.

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

arrow_back_iosLangkah 2: Integrasikan Google Analytics Langkah 4: Memecahkan masalah dan menangani masalah umumarrow_forward_ios