Conversions API

Parameter Informasi Pelanggan

Parameter informasi pelanggan adalah set pengidentifikasi pengguna yang Anda bagikan bersama informasi peristiwa Anda. Untuk informasi selengkapnya tentang parameter wajib dan parameter rekomendasi, lihat Praktik Terbaik - Conversions API: Mengirim Parameter Wajib dan Parameter Rekomendasi.

Pada rilis Graph API v13.0 terdapat persyaratan baru seputar kombinasi parameter informasi pelanggan yang dianggap valid. Bacalah praktik terbaik untuk memastikan agar integrasi Conversions API Anda tidak terinterupsi.

Kunjungi Panduan Privasi dan Penggunaan Data Meta untuk mempelajari jenis data yang dikirimkan ketika menggunakan Conversions API.

Sistem kami dirancang untuk tidak menerima informasi pelanggan yang merupakan Informasi Kontak tanpa hash, kecuali disebutkan di bawah. Informasi Kontak adalah informasi yang secara pribadi mengidentifikasi individu, seperti nama, alamat email, dan nomor telepon yang kami gunakan hanya untuk tujuan pencocokan. Jika Anda menggunakan Meta Business SDK, hashing dilakukan secara otomatis.

Perbandingan Pixel

Anda dapat mengirim banyak parameter informasi pelanggan melalui Meta Pixel, meskipun beberapa (contoh: client_user_agent) dikirim secara otomatis sebagai bagian dari cara kerja internet. Contoh: untuk mengirim external_id melalui Pixel, gunakan kode berikut:

fbq('init', 'PIXEL_ID', {'external_id': 12345});

Baca tentang parameter lain yang dapat Anda lewati dengan Pixel di dokumentasi Pencocokan Lanjut.

Sebaliknya, pastikan untuk menerapkan set parameter informasi pelanggan yang sama yang sistem Anda bagikan ke sisi browser ke sisi server.

Memformat Parameter user_data

Anda harus menyediakan setidaknya salah satu dari parameter user_data berikut dengan format yang benar dalam permintaan Anda.

Silakan unduh file CSV ini

untuk contoh data yang dinormalisasi dengan benar dan data dengan hash untuk parameter di bawah ini.



Unduh (Klik kanan > Simpan Tautan Sebagai)
ParameterDeskripsi
em

Email

string atau daftar<string>

Wajib hashing.
Pangkas semua spasi awal dan akhir. Ubah semua karakter menjadi huruf kecil.

Contoh:

Input: John_Smith@gmail.com
Format normal: john_smith@gmail.com
Ekspektasi output SHA256: 62a14e44f765419d10fea99367361a727c12365e2520f32218d505ed9aa0f62f

ph

Nomor Telepon

string atau daftar<string>

Wajib hashing.
Hapus simbol, huruf, dan angka nol di depannya. Nomor telepon harus menyertakan kode negara yang akan digunakan untuk pencocokan (misalnya, nomor 1 harus mendahului nomor telepon di Amerika Serikat). Selalu sertakan kode negara sebagai bagian dari nomor telepon pelanggan Anda, meskipun semua data Anda berasal dari negara yang sama.

Contoh:

Input: Nomor telepon AS (650)555-1212
Format normal: 16505551212
Ekspektasi output SHA256:

e323ec626319ca94ee8bff2e4c87cf613be6ea19919ed1364124e16807ab3176

fn

Nama Depan

string atau daftar<string>

Wajib hashing.
Direkomendasikan untuk menggunakan karakter a-z alfabet Romawi. Huruf kecil saja, tanpa tanda baca. Jika menggunakan karakter khusus, teks harus dikodekan dalam format UTF-8.

Contoh:
Input: Mary
Format normal: mary
Ekspektasi output SHA256: 6915771be1c5aa0c886870b6951b03d7eafc121fea0e80a5ea83beb7c449f4ec


Input: 정
Format normal: Karakter UTF-8 "정"
Ekspektasi output SHA256: 8fa8cd9c440be61d0151429310034083132b35975c4bea67fdd74158eb51db14


Input: Valéry
Format normal: valéry
Ekspektasi output SHA256: 08e1996b5dd49e62a4b4c010d44e4345592a863bb9f8e3976219bac29417149c

ln

Nama Belakang

string atau daftar<string>

Wajib hashing.
Direkomendasikan untuk menggunakan karakter a-z alfabet Romawi. Huruf kecil saja, tanpa tanda baca. Jika menggunakan karakter khusus, teks harus dikodekan dalam format UTF-8.


Lihat Nama Depan (fn) untuk contohnya.

db

Tanggal Lahir

string atau daftar<string>

Wajib hashing.
Kami menerima format TTTTBBHH yang mengakomodasi berbagai kombinasi bulan, hari dan tahun, dengan atau tanpa tanda baca.

  • Tahun: Gunakan format TTTT dari 1900 sampai tahun ini.
  • Bulan: Gunakan format BB: 01 sampai 12.
  • Tanggal: Gunakan format HH: 01 sampai 31.

Contoh:

Input: 16/2/1997
Format normal: 19970216
Ekspektasi output SHA256: 01acdbf6ec7b4f478a225f1a246e5d6767eeab1a7ffa17f025265b5b94f40f0c

ge

Jenis Kelamin

string atau daftar<string>

Wajib hashing.
Kami menerima jenis kelamin dalam bentuk inisial dalam huruf kecil.

Contoh:

  • p untuk perempuan
  • m untuk laki-laki
ct

Kota

string atau daftar<string>

Hashing diperlukan.
Direkomendasikan untuk menggunakan karakter a-z alfabet Romawi. Hanya huruf kecil, tanpa tanda baca, tanpa karakter khusus, dan tanpa spasi. Jika menggunakan karakter khusus, teks harus dikodekan dalam format UTF-8.

Contoh:
paris
london
newyork

st

Negara Bagian

string atau daftar<string>

Wajib Hashing.
Gunakan kode singkatan ANSI 2 karakter dalam huruf kecil. Normalisasikan negara bagian di luar AS dalam huruf kecil tanpa tanda baca, tanpa karakter khusus, dan tanpa spasi.

Contoh:
az
ca

zp

Kode Pos

string atau daftar<string>

Wajib hashing.
Gunakan huruf kecil tanpa spasi dan tanpa tanda hubung. Gunakan hanya 5 digit pertama untuk kode pos AS. Gunakan format area, distrik, dan sektor untuk Inggris.

Contoh:
Kode pos AS: 94035
Kode pos Australia: 1987
Kode pos Prancis: 75018
Kode pos Inggris: m11ae

country

Negara

string atau daftar<string>

Wajib Hashing.
Gunakan kode negara 2 karakter dalam huruf kecil diISO 3166-1 alpha-2.
Catatan Penting:Selalu sertakan negara pelanggan Anda meskipun semua kode negara Anda berasal dari negara yang sama. Kami mencocokkan dalam skala global, dan langkah sederhana ini membantu kami mencocokkan sebanyak mungkin akun Pusat Akun dari daftar Anda.

Contoh:
Input: Amerika Serikat
Format normal: us
Ekspektasi output SHA256: 79adb2a2fce5c6ba215fe5f27f532d4e7edbac4b6a5e09e1ef3a08084a904621

external_id

ID eksternal

string atau daftar<string>

Hashing direkomendasikan.
Setiap ID unik dari pengiklan, seperti ID keanggotaan loyalitas, ID pengguna, dan ID cookie eksternal. Anda dapat mengirim satu atau beberapa ID eksternal untuk peristiwa tertentu.
Jika ID Eksternal dikirim melalui saluran lain, itu harus dalam format yang sama seperti saat dikirim melalui Conversions API.

client_ip_address

Alamat IP Klien

string

Jangan hash.
Alamat IP browser yang sesuai dengan peristiwa harus berupa alamat IPv4 atau IPv6 yang valid. IPV6 lebih disukai daripada IPV4 untuk pengguna yang mendukung IPV6. Parameter data pengguna client_ip_address tidak boleh di-hash.
Jangan beri spasi. Selalu berikan alamat IP asli untuk memastikan pelaporan peristiwa yang akurat.
Catatan: Informasi ini secara otomatis ditambahkan ke peristiwa yang dikirim melalui browser, tetapi harus dikonfigurasi secara manual untuk peristiwa yang dikirim melalui server.

Contoh:
IPV4: 168.212.226.204
IPV6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

client_user_agent

Agen Pengguna Klien

string

Jangan hash.
Agen pengguna untuk browser yang sesuai dengan peristiwa. client_user_agent diperlukan untuk peristiwa situs web yang dibagikan menggunakan Conversions API.

Mengirimkan parameter client_ip_address sekaligus client_user_agent untuk semua peristiwa yang Anda kirim melalui Conversions API dapat membantu meningkatkan pencocokan peristiwa dan juga dapat membantu meningkatkan penayangan iklan untuk setiap kampanye iklan yang mengoptimalkan peristiwa yang Anda kirim melalui Conversions API.
Catatan: Informasi ini secara otomatis ditambahkan ke peristiwa yang dikirim melalui browser, tetapi harus dikonfigurasi secara manual untuk peristiwa yang dikirim melalui server.

Contoh:
Mozilla/5.0 (Windows NT 10.0; Win64; x64)
AppleWebKit/537.36 (KHTML, seperti Gecko)
Chrome/87.0.4280.141
Safari/537.36

fbc

ID Klik

string

Jangan hash.
Nilai ID klik Facebook disimpan di cookie browser _fbc pada domain Anda. Lihat Mengelola Parameter fbc dan fbp untuk cara mendapatkan nilai ini atau menghasilkan nilai ini dari parameter kueri fbclid.

Formatnya adalah fb.${subdomain_index}.${creation_time}.${fbclid}.

Contoh:
fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890

fbp

ID Browser

string

Jangan hash.
Nilai ID browser Facebook disimpan di cookie browser _fbc pada domain Anda. Lihat Mengelola Parameter fbc dan fbp untuk cara mendapatkan nilai ini.

Formatnya adalah fb.${subdomain_index}.${creation_time}.${random_number}.

Contoh:
fb.1.1596403881668.1116446470

subscription_id

ID Langganan

string

Jangan hash.
ID langganan untuk pengguna dalam transaksi ini; ini mirip dengan ID pesanan untuk produk individual.

fb_login_id

ID Facebook Login

bilangan bulat

Jangan hash.
ID yang dikeluarkan oleh Meta saat seseorang pertama kali masuk ke instance aplikasi. Ini juga dikenal sebagai ID Lingkup Aplikasi.

lead_id

ID Prospek

bilangan bulat

Jangan hash.
ID yang terkait dengan prospek yang dihasilkan oleh Iklan Prospek Meta.

anon_id
string

Jangan hash.
ID penginstalan Anda. Kolom ini mewakili instance penginstalan aplikasi unik.


Catatan: Parameter ini hanya untuk peristiwa aplikasi

madid
string

Jangan hash.
ID pengiklan Anda, ID periklanan dari perangkat Android, atau Pengidentifikasi Periklanan (IDFA) dari perangkat Apple.


Catatan: Parameter ini hanya untuk peristiwa aplikasi

page_id
string

Jangan hash.
ID Halaman Anda. Menentukan ID halaman yang terkait dengan peristiwa. Gunakan ID Halaman Facebook dari halaman terkait bot tersebut.

page_scoped_user_id
string

Jangan hash.
Menentukan ID pengguna cakupan halaman yang terkait dengan bot messenger yang mencatat peristiwa tersebut. Gunakan ID pengguna cakupan halaman yang disediakan untuk webhook Anda.

ctwa_clid
string

Jangan hash.
ID Klik yang dibuat oleh Meta untuk iklan yang diklik ke WhatsApp.

ig_account_id
string

Jangan hash.
ID Akun Instagram yang terkait dengan bisnis tersebut.

ig_sid
string

Jangan hash.
Pengguna yang berinteraksi dengan Instagram diidentifikasi berdasarkan ID Pengguna Cakupan Instagram (IGSID). IGSID dapat diperoleh dari webhook ini.

Lihat Juga