Cara menghantar acara ke Pixel daripada bot

Untuk memindahkan acara daripada aliran kerja bot, anda perlu mempunyai akaun perniagaan. Anda boleh mendaftar di sini.

Cara mencipta pixel baharu

Pilih API Conversions.

Perhatian! Jika tetingkap berikut terbuka semasa konfigurasi Conversion API, lebih baik tinggalkan tetapan dan mulakan semula.

Jika tetingkap berikut terbuka semasa konfigurasi Conversion API, lebih baik tinggalkan tetapan dan mulakan semula.

Pilih Pixel yang anda perlukan.

Jana token akses dan simpannya di tempat yang selamat.

Cara memindahkan acara ke Facebook

Untuk memindahkan acara ke Facebook, anda perlu mempunyai domain sendiri yang disediakan dalam mini-landing. Ia perlu diluluskan di Facebook, dan Menyimpan nilai daripada kuki ke pemboleh ubah klien perlu diaktifkan untuk Facebook dalam tetapan mini-landing:

Kini, akan ada pemboleh ubah _fbp yang diisi secara automatik dalam kad klien yang datang daripada mini-landing. Pemboleh ubah ini boleh dipindahkan ke Pixel bersama acara.

Anda perlu mengkonfigurasi tetapan berikut dalam blok yang melaluinya anda ingin memindahkan acara:

URL fungsi:

https://store.mavibot.ai/function/fb_pixel

Contoh parameter:

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "Entered the bot",
  "event_source_url": "https://my_best_site.com",
  "action_source": "chat",
  "fbp": "#{_fbp}",
  "fbc": "#{_fbc}"
}

Parameter wajib

pixel_id — ID pixel.

access_token — token untuk mengakses API.

event_name — nama acara. Anda boleh menggunakan nama standard seperti Lead, PageView, Purchase, dan sebagainya (lihat lebih lanjut di sini), serta nama anda sendiri, seperti Entered the bot.

event_source_url — domain yang diluluskan di Facebook.

fbp — ID penyemak imbas klien.

Parameter pilihan

action_source — (other secara lalai) medan ini membolehkan anda menentukan di mana tepatnya penukaran berlaku. Maklumat tentang tempat acara berlaku membantu memastikan iklan anda dipaparkan kepada khalayak yang betul.

Anda boleh menetapkan nilai berikut dalam medan action_source:

Nilai Penerangan
email Penukaran berlaku melalui e-mel
website Penukaran berlaku di laman web
phone_call Penukaran berlaku melalui telefon
chat Penukaran berlaku melalui aplikasi mesej, SMS, atau sembang dalam talian
physical_store Penukaran berlaku di kedai fizikal
system_generated Penukaran berlaku secara automatik, iaitu hasil daripada pembaharuan langganan bulanan
business_messaging Penukaran berlaku dalam perbualan selepas pelanggan mengklik iklan Klik-ke-WhatsApp
other Penukaran berlaku dengan cara lain

Cara menguji acara

Untuk menguji acara, tambahkan parameter test_event_code dengan teks yang disimpan dalam tab Testing messages ke badan permintaan.

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "Entered the bot",
  "event_source_url": "https://my_best_site.com",
  "fbp": "#{_fbp}",
  "fbc": "#{_fbc}",
  "test_event_code": "TEST11421"
}

Perhatian! Jangan lupa untuk memadam parameter test_event_code daripada permintaan apabila melancarkan versi pengeluaran.

Parameter pilihan tambahan

fn — nama pertama.

ln — nama keluarga.

email — e-mel klien.

phone — nombor telefon klien.

fbc — ID klik.

gender — jantina klien (f — perempuan, m — lelaki).

country — negara.

state — negeri.

city — bandar.

index — indeks pos klien (kod ZIP).

external_id — sebarang ID klien unik, contohnya ID pengguna atau ID fail kuki pihak ketiga.

client_ip_address — alamat IP klien.

client_user_agent — ejen pengguna penyemak imbas klien.

Anda juga boleh memindahkan parameter anda sendiri ke Pixel. Untuk melakukan ini, tambahkan parameter pilihan my_params dan nyatakan medan anda sendiri di dalamnya.

Contoh:

{
  "my_params": {
    "value1": "Hello",
    "val2": "Hi"
  }
}

Contoh penuh

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "Entered the bot",
  "event_source_url": "https://my_best_site.com",
  "email": "[email protected]",
  "phone": "1234567890",
  "currency": "USD",
  "value": "142.52",
  "test_event_code": "TEST11421",
  "external_id": "#{client_id}",
  "fn": "#{name}",
  "gender": "m",
  "post_index": "12345",
  "my_params": {
    "value1": "Hello",
    "val2": "Hi"
  }
}

Perhatian! Jangan lupa untuk memadam parameter test_event_code daripada permintaan apabila melancarkan versi pengeluaran.

Cara menambah akaun promosi

Pertama, anda perlu membuka akses kepada akaun anda.

Simpan dan pergi ke tab Related Objects → Add Objects.

Kemudian tambahkan akaun promosi anda.

Penukaran Iklan Klik-ke-WhatsApp

Tambahan kepada dokumentasi untuk fungsi fb_pixel_event().

Meta* menandakan setiap klik daripada iklan Klik-ke-WhatsApp dengan pengecam klik ctwa_clid. Ia diterima bersama mesej WhatsApp pertama pelanggan dan digunakan untuk mengaitkan penukaran daripada perbualan kepada iklan tertentu — serupa dengan cara acara pixel dikaitkan dengan klik laman web.

Tandatangan

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data,
    ctwa_clid,
    messaging_channel
)

Parameter baharu

Parameter Penerangan
ctwa_clid Pengecam klik untuk iklan Klik-ke-WhatsApp. Jika parameter ini tidak disediakan, pemboleh ubah klien ctwa_clid, yang disimpan secara automatik oleh bot, digunakan. Pilihan.
messaging_channel Saluran pemesejan di mana penukaran berlaku. Lalai kepada whatsapp. Pilihan.

Nilai action_source baharu

Nilai berikut tersedia untuk action_source:

Nilai Penerangan
business_messaging Penukaran berlaku dalam perbualan selepas pelanggan mengklik iklan Klik-ke-WhatsApp.

Acara dihantar sebagai penukaran pemesejan jika sekurang-kurangnya satu daripada syarat berikut dipenuhi:

  • action_source="business_messaging" disediakan;
  • ctwa_clid disediakan;
  • messaging_channel disediakan.

Dalam kes ini, Meta* menerima gabungan action_source + messaging_channel + ctwa_clid. Tanpa gabungan ini, klik iklan tidak akan dikaitkan dengan penukaran.

Nilai website tidak boleh digunakan untuk penukaran pemesejan: acara akan sampai ke pixel, tetapi ia tidak akan dikaitkan dengan iklan.

Pemboleh ubah klien

Apabila pelanggan menghantar mesej WhatsApp selepas mengklik iklan, bot menyimpan data klik ke pemboleh ubah klien pelanggan. Anda tidak perlu mengisi pemboleh ubah ini secara manual.

Pemboleh ubah Penerangan
ctwa_clid Pengecam klik. Ditambah secara automatik ke acara.
ctwa_clid_time Masa apabila pengecam diterima, dalam format masa Unix. Ia boleh digunakan untuk menentukan berapa banyak masa telah berlalu sejak klik.
wa_ads_data Data iklan dalam format JSON: URL iklan, ID iklan (source_id), tajuk, penerangan, jenis kreatif, dan URL kreatif.

Pengecam klik diambil secara automatik daripada pemboleh ubah klien, jadi anda tidak perlu menghantarnya ke fungsi secara eksplisit.

Nombor telefon pelanggan ditambah secara automatik ke acara jika ia tidak disediakan dalam data.

Parameter event_source_url tidak digunakan untuk penukaran pemesejan.

Had

Pengecam klik diterima hanya dengan mesej pertama pelanggan selepas mereka mengklik butang dalam iklan. Ia tidak disertakan dalam mesej berikutnya. Oleh itu, acara boleh dihantar pada bila-bila masa semasa perbualan, tetapi hanya jika mesej pertama berasal daripada iklan.

Meta menyediakan ctwa_clid untuk klik daripada aplikasi Facebook dan Instagram pada Android dan iOS.

Pengecam tidak disediakan apabila pelanggan mengklik dari penyemak imbas atau mengklik siaran biasa dan bukannya butang iklan. Penukaran daripada interaksi sedemikian tidak boleh dikaitkan dengan iklan.

Jika pelanggan mengklik iklan lain kemudian, pemboleh ubah akan ditimpa. Penukaran dikaitkan dengan iklan terbaru yang pelanggan datang daripadanya.

Jika pengecam klik hilang daripada kedua-dua parameter fungsi dan pemboleh ubah klien, fungsi mengembalikan ralat berikut dan acara tidak dihantar:

No ctwa_clid variable in client variables