Pencocokan Lanjut

Dokumen ini menjelaskan cara mengirim data pengguna peristiwa aplikasi Anda ke Facebook untuk Pencocokan Lanjut. Informasi ini di-hash sebelum dibagikan dengan kami. Kami menggunakan informasi yang telah di-hash itu untuk menentukan dengan lebih akurat orang-orang mana yang mengambil tindakan setelah melihat iklan Anda. Dengan data ini, Facebook dapat mencocokkan peristiwa konversi dengan pelanggan Anda untuk mengoptimalkan iklan Anda dan membangun pemirsa pemasaran ulang yang lebih besar.

Setelah pencocokan dilakukan, Facebook segera membuang data dengan hash.

Anda dapat menyiapkan Pencocokan Lanjut menggunakan salah satu metode berikut:

  • Facebook SDK – Tambahkan kode ke aplikasi seluler Android atau iOS untuk mengirim data secara manual ke Facebook.
  • App Events API Facebook - Tambahkan kueri ke kode Anda untuk mengirim data secara manual Facebook.
  • Pengelola Peristiwa – Konfigurasikan aplikasi Anda di dasbor Pengelola Peristiwa untuk mengaktifkan Pencocokan Lanjut Otomatis demi mengirim data ke Facebook.
  • Mobile Measurement Partners (MMP) SDK – Tambahkan kode ke aplikasi Android atau iOS Anda untuk mengirim data ke dasbor Adjust.

Menggunakan Facebook SDK

Saat menggunakan Facebook SDK untuk mengirim data peristiwa aplikasi pengguna ke Facebook, semua data pengguna akan di-hash. Data dengan hash ini tetap ada di antara instance aplikasi.

Persyaratan

  • Facebook SDK 4.36 atau setelahnya

Android

Atur data mengguna saat menginisialisasi AppEventsLogger dengan fungsi setUserData. Fungsi ini akan meng-hash data pengguna.

AppEventsLogger logger = AppEventsLogger.newLogger(MainActivity.this);
AppEventsLogger.setUserData(
  “jsmith@example.com”,     //email
  “john”,                   //first name
  “smith”,                  //last name
  “16505554444”,            //phone number
  “19910526”,               //birthdate
  “f”,                      //gender
  “menlopark”,              //city
  “ca”,                     //state
  “94025”,                  //zip code
  “us”                      //country
);

iOS

Atur data pengguna saat menginisialisasi FBSDKAppEvents dengan fungsi setUserData. Data pengguna akan di-hash dan akan tetap ada di antara instance aplikasi.

Rekomendasi

App Store Connect untuk iOS 14

Peristiwa yang dikumpulkan dan dikirim oleh aplikasi Anda ke Facebook mungkin mewajibkan Anda untuk mengungkapkan jenis data ini dalam kuesioner App Store Connect. Anda bertanggung jawab untuk memastikan hal ini tecermin dalam kebijakan privasi aplikasi Anda. Kunjungi artikel Detail Privasi App Store Apple untuk mempelajari selengkapnya tentang jenis data yang perlu Anda ungkapkan.

Contoh Kode untuk Mengatur Satu Jenis Data

[FBSDKAppEvents setUserData: @"jsmith@example.com" forType:FBSDKAppEventEmail];

Contoh Kode untuk Mengatur Beberapa Jenis Data

NSDictionary *const userData = @{
        @"em": @"jsmith@example.com",
        @"fn": @"john",
        @"ln": @"smith",
        @"ph": @"16505554444",
        @"db": @"19910526",
        @"ge": @"f",
        @"ct": @"menlopark",
        @"zp": @"94025",
        @"cn": @"us"};
[FBSDKAppEvents setUserEmail:(NSString *)userData["@em"]
     firstName:(NSString*)userData["@fn"]
     lastName:(NSString *)userData[@"ph"]
     phone:(NSString *)userData[@"ph"]
     dateOfBirth:(NSString *)userData[@"db"]
     gender:(NSString *)userData[@"ge"]
     city:(NSString *)userData[@"ct"]
     state:(NSString *)userData[@"st"]
     zip:(NSString *)userData[@"zp"]
     country:(NSString *)userData[@"cn"]];

Parameter Data Informasi Pelanggan

Data Parameter Contoh Panduan Format

Kota

ct

menlopark

Kota dengan huruf kecil tanpa spasi

Negara

country

AS

Kode negara dua huruf dalam ISO 3166-1 alpha-2

Tanggal Lahir

db

19911226

Tahun, bulan, dan hari lahir, misalnya 19971226 untuk 26 Desember 1997

Email

em

jsumito@example.com

Gunakan huruf kecil untuk alamat email seseorang

Nama Depan

fn

joyo

Gunakan huruf kecil untuk nama depan

Jenis Kelamin

ge

m

Antara f atau m, jika tidak diketahui, kosongkan

Nama Belakang

ln

sumito

Gunakan huruf kecil untuk nama belakang

Telepon

ph

16505551212

Nomor telepon, hanya angka dengan kode negara, kode area, dan nomor

Provinsi (Negara Bagian)

st

ca

Kode provinsi (negara bagian) dua huruf

Kode Pos

zp

94035

Kode pos lima angka

Menggunakan Pengelola Peristiwa

Pencocokan Lanjut Otomatis secara otomatis mengonfigurasi Facebook SDK Anda untuk mendeteksi dan menerima data pengguna bersama dengan peristiwa, atau tindakan, yang terjadi di aplikasi Anda. Data ini di-hash sebelum dikirim ke Facebook.

Untuk mengaktifkan Pencocokan Lanjut Otomatis, buka Pengelola Peristiwa Anda, pilih tab Pengaturan aplikasi Anda dan atur Pencocokan Lanjut Otomatis ke AKTIF. Anda juga bisa membagikan alamat email dan nomor telepon yang telah di-hash.

Catatan: Anda harus telah menerapkan Facebook SDK 5.8.0 atau setelahnya.

Menggunakan Adjust SDK

Menambahkan Data Pelanggan untuk Menyesuaikan Peristiwa

Saat menggunakan Adjust Mobile Measurement Partners (MMP) SDK, harap gunakan fungsi hash seperti yang ditunjukkan pada contoh di bawah ini, karena MMP SDK tidak akan melakukan hash secara otomatis. Jika Anda tidak menggunakan fungsi hash, API kami akan mengeluarkan pengecualian dan tidak menerima teks biasa.

Tambahkan parameter data pelanggan untuk dikirim ke partner jaringan, yang telah diaktifkan di dasbor Adjust , dengan memanggil metode addPartnerParameter di instance ADJEvent Anda.

Catatan: Anda tidak perlu menerapkan Facebook SDK.

Contoh Kode Android

AdjustEvent event = new AdjustEvent('abc123');
event.addPartnerParameter('em', 'sha256_hashed_email');
event.addPartnerParameter('ph', 'sha256_hashed_phone');
Adjust.trackEvent(event);

Contoh Kode iOS

ADJEvent *event = [ADJEvent eventWithEventToken:@'abc123'];

[event addPartnerParameter:@'em' value:@'sha256_hashed_email'];
[event addPartnerParameter:@'ph' value:@'sha256_hashed_phone'];

[Adjust trackEvent:event];

Untuk informasi selengkapnya, kunjungi contoh Kode Github.

Memetakan Parameter Adjust ke Parameter Facebook

Gunakan langkah-langkah berikut untuk memetakan parameter Adjust ke parameter Facebook di dasbor Adjust.

  1. Di dasbor Adjust, klik Settings aplikasi yang ingin Anda petakan parameter partnernya.
  2. Pilih Partner Setup.
  3. Klik partner yang diminati.
  4. Pilih Partner Parameter Mapping.
  5. Masukkan nama parameter partner seperti yang dikirim ke Adjust by SDK di sebelah kiri kolom FROM APP. Ini harus sama untuk setiap partner. Contoh: jika Anda menggunakan email sebagai nama parameter di Adjust SDK, masukkan “email”.
  6. Masukkan nama parameter partner seperti yang diinginkan oleh partner ini di sebelah kanan kolom TO PARTNER. Ini spesifik partner. Parameter yang digunakan dalam Facebook SDK harus berformat ud[pii_type_name]. Contoh, "email" harus menggunakan ud[em], telepon harus menggunakan ud[ph].

Untuk informasi selengkapnya, kunjungi Dokumentasi Adjust.