Tutorial: Mengukur konversi Iklan iOS

Langkah 3: Mulai pengukuran konversi di perangkat menggunakan Google Analytics

Kini setelah Anda 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.

Hubungi API

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

Ada dua cara untuk memulai pengukuran:

• Menggunakan kredensial
• Menggunakan kredensial hash

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

Gunakan 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 pada kode Anda sebelum melakukan panggilan ke SDK.

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

Normalisasikan 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 menormalkan data Anda:

1. Ubah seluruh alamat email menjadi huruf kecil.

2. Jika alamat email berakhiran 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 pada bagian nama pengguna:

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

Misalnya setelah normalisasi:

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

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

Panggil API dengan kredensial 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);

Verifikasi 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 API initiateOnDeviceConversionMeasurement() akan menyimulasikan kecocokan.

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

arrow_back_ios Langkah 2 : Integrasikan Google Analytics Langkah 4 : Pecahkan masalah dan tangani masalah umum arrow_forward_ios