Mencatat Peristiwa dengan Events API untuk Pesan Bisnis

Panduan ini mendeskripsikan cara Anda mencatat peristiwa aplikasi dan Halaman Facebook untuk menganalisis cara pengguna berinteraksi dengan pengalaman Messenger mereka.

Sebelum Memulai

Anda akan membutuhkan hal-hal berikut:

• Izin page_events

  • Akses Lanjutan akan secara otomatis diberikan untuk izin ini ketika Anda mengajukan Tinjauan Aplikasi jika aplikasi Anda telah diberikan Akses Lanjutan untuk izin pages_messaging dan aplikasi Anda tidak melanggar kebijakan dalam 90 hari terakhir
• Token akses halaman diminta oleh orang yang dapat melakukan tugas ANALYZE pada Halaman yang di-kueri

Batasan

API ini saat ini tidak tersedia untuk bisnis atau pelanggan yang berbasis di Eropa atau Jepang.

Kebijakan & Ketentuan

• Ketentuan Fitur Meta Business
• Kebijakan Halaman, Grup, dan Peristiwa

Mencatat Peristiwa

Peristiwa dicatat dengan mengirimkan permintaan POST ke edge page_activities aplikasi:

https://graph.facebook.com/

Contoh permintaan:

curl -X POST -H "Content-Type: application/json" -d '{
  "custom_events": [
    {
      "_eventName": "fb_mobile_purchase",
      "_valueToSum": 57.23,
      "fb_currency": "USD"
    }
  ],
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "page_id": <PAGE_ID>,
  "page_scoped_user_id": <PSID>,
  "logging_source": "messenger_bot",
  "logging_target": "page"
}' https://graph.facebook.com/v21.0/<APP_ID>/page_activities?access_token=<PAGE_ACCESS_TOKEN>

Tabel berikut menjelaskan properti dan nilai yang harus diberikan ke endpoint untuk mencatat peristiwa Messenger:

Melaporkan Prospek menggunakan Messaging Events API

Aplikasi sekarang dapat mulai melaporkan pengajuan prospek di utas. Peristiwa lead_submitted memungkinkan aplikasi untuk secara otomatis melaporkan utas yang dianggap sebagai prospek penjualan (misalnya: pengguna membagikan informasi kontak mereka dan meminta untuk dihubungi terkait penjualan).

Peristiwa ini paling baik digunakan untuk membedakan pengguna tertentu sebagai prospek potensial, yang seharusnya membantu bisnis dalam memprioritaskan utas dari mereka. Contoh: bisnis dapat mengatur alur otomatis untuk menyaring pengguna yang memenuhi syarat sebagai potensi prospek, dan memicu peristiwa ini ketika pengguna menyelesaikan alur tersebut, lalu menandainya ke agen langsung sebagai utas berpotensi tinggi.

Saat ini, fitur ini tersedia dalam versi beta terbuka dan laporan di Pengelola Iklan terintegrasi, sehingga data prospek akan dilaporkan di UI Pengelola Iklan.

Contoh panggilan API untuk melaporkan peristiwa prospek yang terjadi di utas:

curl -X POST -H "Content-Type: application/json" -d '{
  "custom_events": [
    {
      "_eventName": "lead_submitted"
    }
  ],
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "page_id": <PAGE_ID>,
  "page_scoped_user_id": <PSID>,
  "logging_source": "messenger_bot",
  "logging_target": "page"
}' https://graph.facebook.com/v21.0/<APP_ID>/page_activities?access_token=<PAGE_ACCESS_TOKEN>

Melaporkan Prospek menggunakan Ads Insights API

Peristiwa prospek yang dilaporkan dapat divisualisasikan menggunakan Ads Insights API. Menggunakan API ini, Anda dapat membuat dasbor analytics lanjutan untuk membantu memvisualisasikan propsek yang diatribusikan pada kampanye CTX.

Prasyarat

Sebelum menggunakan API ini, pastikan aplikasi telah melalui proses tinjauan aplikasi untuk izin ads_read dan mendapatkan akses lanjutan.

Eksekusi

Contoh panggilan insight di level kampanye iklan terlihat seperti ini:

curl -G \
-d "date_preset=last_7d" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"
    

Insight API dapat dipanggil di level akun iklan, kampanye, dan set iklan tergantung pada level granularitas yang diinginkan.

Ini adalah panggilan untuk mendapatkan prospek:

• Prospek (diatribusikan)

  • /<OBJECT_ID>/insights?fields=actions
  • Di dalam hasil, action_type=onsite_converstion.lead_grouped

Untuk definisi mendetail dari jenis tindakan di atas, lihat referensi Statistik Tindakan Iklan.

Praktik Terbaik untuk Klasifikasi Prospek

1. Pengiklan berada di salah satu vertikal penciptaan prospek klasik (otomotif, layanan profesional, layanan keuangan, B2B, pendidikan, kesehatan).
2. Pengiklan meminta informasi kontak seperti telepon atau alamat email dan pengguna memberikannya.
3. Pertanyaan telepon atau alamat email didahului oleh semacam kualifikasi (misalnya: 1-2 pertanyaan tambahan).
4. Jika Anda menawarkan template penciptaan prospek di aplikasi Anda, tambahkan sinyal ini di akhir alur penciptaan prospek secara dafault.

Memverifikasi Pencatatan Peristiwa

Jika Anda adalah admin Aplikasi atau Halaman, Anda dapat memvalidasi bahwa pengaturan Anda sudah benar dengan mencari peristiwa Anda di Pengelola Iklan.

Pertimbangan Khusus untuk Analytics dengan Bot untuk Messenger

• Satu Aplikasi dapat mencatat interaksi beberapa Halaman. Dalam kasus ini, peristiwa dari interaksi dengan semua Halaman dapat dilihat di Aplikasi yang sama.
• Beberapa Aplikasi dapat ditautkan ke satu Halaman. Dalam kasus ini, saat Halaman diblokir, semua Aplikasi yang terkait ke Halaman akan menerima peristiwa fb_messenger_bot_stopped.
• Jumlah percakapan bot Messenger yang dihapus bisa lebih tinggi daripada jumlah Aktivitas Pengguna Baru. Percakapan bot Messenger yang dihapus adalah jumlah berapa kali pengguna menghapus utas. Halaman dapat memulai percakapan lebih lanjut setelah pengguna menghapus sebuah utas. Utas tambahan dapat dihapus oleh pengguna yang meningkatkan jumlah konversi bot Messenger yang dihapus.

Penggunaan untuk Provider Platform

Mencatat target

Platform yang memungkinkan orang untuk membangun pengalaman Messenger melalui antarmuka visual biasanya menggunakan satu aplikasi pusat untuk memperkuat semua halaman yang terhubung. Untuk memungkinkan pelanggan Anda melihat peristiwa mereka sendiri, Anda harus memasukkan pelanggan ke Halaman pelanggan dengan mengatur logging_target ke page atau app_and_page.

Antarmuka pengguna

Dalam konteks editor visual, Anda dapat menawarkan blok yang dapat diseret yang memungkinkan orang memilih peristiwa dan menentukan parameter tambahan. Ini memungkinkan admin Halaman untuk memetakan alur Messenger dengan peristiwa yang cocok. Idealnya, pengguna harus dapat memilih nama peristiwa standar dari daftar pilihan, karena hanya peristiwa standar yang dilaporkan di Pengelola Iklan dan tersedia untuk penargetan dan pengoptimalan iklan (jika tersedia). Jika tidak ada nama peristiwa standar yang sesuai dengan tindakan pengguna dan pelaporan iklan tidak diperlukan, Anda mungkin ingin menawarkan kolom formulir bebas untuk memungkinkan pengguna memasukkan nama dan parameter peristiwa khusus.

Izin

Izin page_events yang diperlukan harus didapat selama alur Facebook Login di aplikasi Anda. Anda harus menambahkannya ke lingkup izin yang diminta dari Tombol Login, Facebook JavaScript SDK panggilan, atau alur login yang dibangun secara manual seperti yang dijelaskan dalam panduan ini.

Sumber Informasi Tambahan

• Panduan Praktik Terbaik Peristiwa Aplikasi: Berisi rekomendasi tentang peristiwa mana yang digunakan dalam berbagai jenis aplikasi.