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

• Untuk memastikan bahwa Pencocokan Lanjut berfungsi dengan baik, kami rekomendasikan untuk meningkatkan ke versi terbaru Facebook SDK untuk iOS. Lihat Catatan Perubahan SDK iOS untuk informasi selengkapnya.

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

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.