Parameter Peristiwa Server

ParameterDeskripsi
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
integer

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 kejadian tersebut terjadi. URL harus dimulai dengan http:// atau https:// dan harus cocok dengan domain 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
integer

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
integer

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

Wajib 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.
Situs web masuk yang langsung dikunjungi sebelum halaman pengiklan tempat Meta Pixel diaktifkan. Ini adalah perujuk HTTP dari perspektif Javascript. referral_url adalah halaman yang digunakan pengguna sebelum mereka mengunjungi halaman saat ini, atau iFrame.