Conversions API

Parameter Peristiwa Server

Parameter	Deskripsi
`event_name` string	Wajib. Nama peristiwa standar atau peristiwa khusus. Kolom ini digunakan untuk menghapus duplikat peristiwa yang sama-sama dikirim oleh web (melalui Meta Pixel) atau aplikasi (melalui SDK atau App Events API) maupun oleh Conversions API. Parameter `event_id` juga digunakan untuk menghapus duplikat. Untuk tindakan pelanggan yang sama, `event` dari peristiwa browser atau aplikasi sama dengan `event_name` dari peristiwa server. Jika kami menemukan kesamaan di antara peristiwa yang dikirim dalam kurun waktu 48 jam, kami hanya mempertimbangkan yang pertama. Jika peristiwa server dan peristiwa browser/aplikasi sampai pada waktu yang hampir bersamaan (dalam kurun waktu 5 menit), kami mengutamakan peristiwa browser/aplikasi. Pelajari selengkapnya tentang Menghapus Duplikat Peristiwa Pixel dan Peristiwa Server.
`event_time` bilangan bulat	Wajib. Cap waktu Unix dalam detik yang menunjukkan kapan peristiwa yang sebenarnya terjadi. Waktu yang ditentukan dapat lebih awal daripada waktu Anda mengirim peristiwa ke Facebook. Hal ini dilakukan agar dapat memproses batch dan mengoptimalkan kinerja server. Tanggal ini harus dikirim dalam zona waktu GMT. `event_time` bisa hingga 7 hari sebelum Anda mengirim peristiwa ke Facebook. Jika `event_time` di `data` lebih dari 7 hari pada masa lalu, kami akan menampilkan kesalahan untuk seluruh permintaan dan tidak memproses peristiwa.
`user_data` objek	Wajib. Peta yang berisi data informasi pelanggan. Lihat Parameter Informasi Pelanggan untuk mengetahui opsinya. Lihat Pencocokan Lanjut untuk mengetahui opsi sebanding yang tersedia bagi data yang dikirim melalui Meta Pixel.
`custom_data` objek	Opsional. Peta yang mencakup data bisnis tambahan tentang peristiwa tersebut. Lihat Parameter Data Khusus untuk informasi selengkapnya.
`event_source_url` string	Opsional. URL browser tempat peristiwa tersebut terjadi. URL harus cocok dengan domain yang sudah terverifikasi. Catatan:`event_source_url` diperlukan untuk peristiwa situs web yang dibagikan menggunakan Conversions API.
`opt_out` boolean	Opsional. Bendera yang menunjukkan bahwa kita tidak boleh menggunakan peristiwa ini untuk pengoptimalan penayangan iklan. Jika diatur ke `true`, kami hanya menggunakan peristiwa itu untuk atribusi.
`event_id` string	Opsional. ID ini dapat berupa string unik yang dipilih pengiklan. Parameter `event_id` dan `event_name` digunakan untuk menghapus duplikat peristiwa yang sama-sama dikirim oleh web (melalui Meta Pixel) atau aplikasi (melalui SDK atau App Events API) maupun oleh Conversions API. Ingat bahwa meskipun `event_id` ditandai sebagai opsional, kode ini dianjurkan untuk penghapusan duplikat peristiwa. Untuk menghapus duplikat, `eventID` dari peristiwa browser atau aplikasi harus sama dengan `event_id` dalam peristiwa server terkait. Pelajari selengkapnya tentang Menangani Duplikasi Peristiwa Pixel dan Conversions API. Nomor pesanan atau ID transaksi adalah dua pengidentifikasi potensial yang dapat digunakan untuk `event_id`. Contoh: jika pelanggan melakukan dua pembelian di situs web Anda dengan nomor pesanan 123 dan 456, setiap panggilan Conversions API harus mencantumkan nomor pesanan masing-masing untuk `event_id`. Ini memungkinkan kita untuk membedakan dengan benar dua peristiwa pembelian ini sebagai pesanan yang berbeda. Dua peristiwa pembelian Pixel browser yang sesuai juga harus mengirim nomor pesanan yang sama di parameter `eventID` agar kita memahami bahwa hanya ada dua peristiwa yang terjadi, bukan empat pembelian unik. Untuk peristiwa lain tanpa nomor ID intrinsik, nomor acak (selama nomor acak yang sama dikirim antara peristiwa browser dan server) bisa digunakan.
`action_source` string	Wajib. Kolom ini memungkinkan Anda menentukan tempat terjadinya konversi. Mengetahui tempat peristiwa Anda berlangsung membantu memastikan iklan Anda ditujukan kepada orang yang tepat. Dengan menggunakan Conversions API, Anda setuju bahwa parameter `action_source` akurat sepanjang pengetahuan Anda. Nilai yang dapat Anda kirim di kolom `action_source` adalah sebagai berikut: `email` — Konversi terjadi melalui email. `website` — Konversi dibuat di situs web Anda. `app` — Konversi dibuat di aplikasi seluler Anda. `phone_call` — Konversi dibuat melalui telepon. `chat` — Konversi dibuat melalui aplikasi pesan, SMS, atau fitur berkirim pesan online. `physical_store` — Konversi dibuat secara langsung di toko fisik Anda. `system_generated` — Konversi terjadi secara otomatis, misalnya perpanjangan langganan yang diatur ke pembayaran otomatis setiap bulan. `business_messaging` — Konversi dibuat dari iklan yang klik ke Messenger, Instagram, atau WhatsApp. `other` — Konversi terjadi dengan cara yang tidak tercantum. Catatan: Semua nilai sumber tindakan memungkinkan pengukuran iklan dan kemampuan pembuatan pemirsa khusus. Semua sumber tindakan kecuali `physical_store` mengaktifkan kemampuan pengoptimalan iklan.
`data_processing_options` array	Opsional. Opsi pemrosesan yang ingin Anda aktifkan untuk peristiwa tertentu. Nilai yang diterima saat ini adalah `LDU` untuk Penggunaan Data Terbatas. Array kosong dapat dikirim untuk secara eksplisit menentukan bahwa peristiwa ini sebaiknya tidak diproses dengan batasan Penggunaan Data Terbatas. Pelajari selengkapnya tentang opsi Pemrosesan Data. Lihat contoh penerapan Conversions API.
`data_processing_options_country` bilangan bulat	Wajib, jika Anda mengirim `LDU` di bawah `data_processing_options`. Negara yang ingin Anda kaitkan dengan opsi pengolahan data ini. Nilai yang diterima saat ini adalah `1`, untuk Amerika Serikat, atau `0`, untuk meminta kami membuat geolokasi peristiwa tersebut. Pelajari selengkapnya tentang opsi Pemrosesan Data. Lihat contoh penerapan Conversions API.
`data_processing_options_state` bilangan bulat	Wajib dalam beberapa kasus. (Lihat catatan di bawah untuk detailnya.) Negara bagian yang ingin Anda kaitkan dengan opsi pengolahan data ini. Nilai yang diterima saat ini adalah `1000`, untuk California, atau `0`, untuk meminta kami membuat geolokasi peristiwa tersebut. Catatan: Jika Anda menetapkan negara, Anda juga harus menetapkan negara bagian. Jika tidak, kami menerapkan logika geolokasi kami pada keseluruhan peristiwa. Kolom ini wajib diisi jika Anda mengirim `LDU` di bawah `data_processing_options` dan tidak menyediakan alamat IP. Pelajari selengkapnya tentang opsi Pemrosesan Data. Lihat contoh penerapan Conversions API.
`app_data` objek	Wajib untuk peristiwa aplikasi Parameter untuk berbagi data aplikasi dan informasi perangkat dengan Conversions API. `extinfo` adalah subparameter dari `app_data`.
`extinfo` objek	Diperlukan untuk peristiwa aplikasi Informasi perangkat yang diperluas, seperti lebar dan tinggi layar. Parameter ini berupa array dan nilainya dipisahkan oleh koma. Saat menggunakan extinfo, semua nilai wajib ada dan harus dalam urutan yang diindeks di bawah. Jika ada nilai yang tidak ada, isi dengan string kosong sebagai placeholder. Catatan: `version` haruslah `a2` untuk Android `version` haruslah `i2` untuk iOS
`0` string	Wajib versi extinfo Contoh: `i2`
`1` string	nama paket aplikasi Contoh: `com.facebook.sdk.samples.hellofacebook`
`2` string	versi singkat (int atau string) Contoh: `1.0`
`3` string	versi panjang Contoh: `1.0 long`
`4` string	Wajib Versi OS Contoh: `13.4.1`
`5` string	nama model perangkat Contoh: `iPhone5,1`
`6` string	locale Contoh: `En_US`
`7` string	singkatan zona waktu Contoh: `PDT`
`8` string	operator Contoh: `AT&T`
`9` int64	lebar layar Contoh: `320`
`10` int64	tinggi layar Contoh: `568`
`11` string	kepadatan layar Contoh: `2`
`12` int64	inti CPU Contoh: `2`
`13` int64	ukuran penyimpanan eksternal dalam GB Contoh: `13`
`14` int64	ruang kosong pada penyimpanan eksternal dalam GB Contoh: `8`
`15` string	zona waktu perangkat Contoh: `USA/New York`
`referrer_url` string	Opsional. Header perujuk HTTP seperti yang terlihat saat halaman memicu Conversions API atau peristiwa Meta Pixel. Ini biasanya halaman sebelumnya di browser.
`original_event_data` objek	Opsional. Semua kolom metadata yang dapat digunakan pengiklan untuk menentukan bagaimana peristiwa yang "tertunda" harus dikaitkan dengan peristiwa akuisisi sebelumnya. Kami sangat merekomendasikan penggunaan `original_event_data` ketika ada penundaan antara saat peristiwa dikirimkan dan peristiwa akuisisi sebelumnya yang harus dikaitkan dengannya. Lihat Parameter Data Peristiwa Asli untuk informasi selengkapnya.