Tutorial: Mengukur konversi Iklan iOS

Langkah 3: Mulai pengukuran konversi di perangkat menggunakan Google Analytics

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

Memanggil API

Panggil API pengukuran konversi dengan alamat email atau nomor telepon yang diizinkan 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 ini 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, lakukan hashing dengan SHA256, lalu panggil API.

Mennormalisasi 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. Mengonversi 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 berakhiran domain @gmail.com (termasuk yang diubah di 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 angka 2, ganti 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, awalan dengan +, 1-3 digit untuk kode negara, maksimal 12 digit untuk nomor pelanggan) sebelum di-hash dengan SHA256.

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 dengan log debug Xcode (opsional)

Jika Anda mengaktifkan mode debug, setelah memanggil API pengukuran awal, pastikan pesan seperti pesan log berikut muncul di konsol debug Xcode:

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

Di Firebase 9.6.0 atau yang lebih baru, jika Anda mengaktifkan mode debug dan menyertakan argumen peluncuran -DebugOnDeviceConversionMeasurement, memanggil initiateOnDeviceConversionMeasurement() API akan menyimulasikan kecocokan.

9.6.0 - [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