Tutorial: Mengukur konversi Iklan iOS

Langkah 3: Mulai pengukuran konversi di perangkat menggunakan Google Analytics


{i>Introduction<i} (Pendahuluan): Mengukur konversi iklan iOS

Langkah 1: Menerapkan pengalaman login

Langkah 2: Integrasikan Google Analytics

Langkah 3: Mulai pengukuran konversi di perangkat menggunakan Google Analytics

Langkah 4: Memecahkan dan menangani masalah umum


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

Memanggil API

Memanggil API pengukuran konversi dengan alamat email atau nomor telepon yang diizinkan nomor dari Langkah 1, yang digunakan untuk pengukuran konversi iklan, tanpa membiarkan informasi identitas pribadi hilang dari perangkat pengguna.

Ada dua cara untuk memulai pengukuran:

Gunakan alamat email atau nomor telepon

Swift Objective-C Unity

Impor modul FirebaseAnalytics dan teruskan alamat email atau nomor telepon ke initiateOnDeviceConversionMeasurement() API.

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

Impor modul FirebaseAnalytics dan teruskan alamat email ke initiateOnDeviceConversionMeasurementWithEmailAddress: API atau ponsel ke initiateOnDeviceConversionMeasurementWithPhoneNumber: API.

@import FirebaseAnalytics;

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

Impor namespace Firebase.Analytics dan teruskan alamat email ke InitiateOnDeviceConversionMeasurementWithEmailAddress() API atau ponsel ke InitiateOnDeviceConversionMeasurementWithPhoneNumber() API:

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 Anda dengan melakukan {i>hashing<i} pada kode Anda sebelum melakukan panggilan ke SDK.

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

Menormalkan alamat email dan nomor telepon

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

  1. Mengubah 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 alamat yang diubah di langkah sebelumnya):

    1. Hapus semua titik dari bagian nama pengguna.

    2. Buat substitusi berikut di bagian nama pengguna:

      • Untuk huruf I atau i, atau angka 1, huruf pengganti l
      • Untuk angka 0, ganti huruf o
      • Untuk angka 2, ganti huruf z
      • Untuk angka 5, ganti 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, maks 12 digit untuk nomor pelanggan) sebelum melakukan hashing dengan SHA256.

Memanggil API dengan kredensial yang di-hash
Swift Objective-C Unity

Impor modul FirebaseAnalytics dan teruskan alamat email atau nomor telepon ke initiateOnDeviceConversionMeasurement() API.

import FirebaseAnalytics

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

Impor modul FirebaseAnalytics dan teruskan alamat email ke initiateOnDeviceConversionMeasurementWithHashedEmailAddress: API atau ponsel nomor ke initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: Compute Engine API.

@import FirebaseAnalytics;

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

Impor namespace Firebase.Analytics dan teruskan alamat email ke InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() API atau nomor telepon ke InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() API:

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 menginisialisasi API pengukuran, pastikan bahwa pesan seperti pesan log berikut muncul di debug Xcode konsol:

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, lalu memanggil metode initiateOnDeviceConversionMeasurement() API akan menyimulasikan kecocokan.

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



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