Referensi Messaging Insights API

Dengan Messaging Insights API, Anda bisa secara terprogram mengambil informasi yang sama yang muncul di tab Insight Halaman di Halaman Facebook Anda.

Untuk informasi selengkapnya tentang Messaging Insights API dan analisis lain yang tersedia dari Platform Messenger, lihat Analytics.

Untuk informasi selengkapnya tentang Pages Insights API, termasuk informasi tentang metrik lain yang tersedia dan izin yang diperlukan, pelajari dokumen Insight Halaman atau referensi objek Insight.

Izin

Diperlukan token akses halaman dengan izin read_insights untuk berinteraksi dengan endpoint ini.

Contoh Permintaan

curl -X GET "https://graph.facebook.com/v2.8/me/insights/?metric=

Contoh Tanggapan

{ 
  "data": [ 
    { 
      "name": "

Parameter

Parameter	Deskripsi
`breakdowns`	Dimensi pengelompokan tanggapan. Bisa berupa `messaging_channel` (Messenger atau Instagram), `recurring_notification_topic`, `recurring_notifications_freuency`
`date_preset`	Rentang tanggal relatif yang bisa digunakan selain `since` dan `until`. Bisa berupa `last_week`, `last_month`, `last_quarter`, dan lainnya.
`metric`	Daftar metrik yang dipisahkan koma yang ingin Anda tampilkan
`period`	Agregasi yang tersedia dalam rentang since/until atau date_preset. Nilai `total_over_range` memberikan nilai tunggal untuk metrik selama rentang tanggal tertentu. Bisa berupa `day`, `week`, `month`, `days_28`, `total_over_range`
`since`	Cap waktu UNIX dari waktu mulai untuk mendapatkan metriknya
`until`	Cap waktu UNIX dari waktu akhir untuk mendapatkan metriknya

Metrik yang Tersedia

Metrik berikut tersedia melalui Messaging Insights API:

Nama `metric`	Deskripsi
`recurring_notification_tokens`	Berapa kali suatu akun berlangganan untuk menerima pesan marketing dari bisnis Anda. Jika akun telah berlangganan ke beberapa topik, akun akan dihitung lagi untuk setiap topik. Cara menghitungnya: Metrik ini menghitung berapa kali akun setuju untuk menerima pesan berulang dikurangi berapa kali akun berhenti berlangganan. Kemungkinan Nilai `breakdowns`: `messaging_channel` `recurring_notifications_frequency` `recurring_notifications_topic` Metrik ini dalam pengembangan.
`page_messages_engagement`	Berapa kali pengguna berinteraksi dengan pesan di Halaman bisnis Anda, misalnya dengan mengetuk tombol ajakan bertindak. Metrik ini hanya berisi data dari Pesan Marketing. Kemungkinan Nilai `breakdowns`: `messaging_channel` `recurring_notifications_topic` Metrik ini dalam pengembangan.
`page_messages_sent`	Jumlah pesan yang dikirimkan Halaman bisnis Anda kepada pelanggan. Metrik ini hanya berisi data dari Pesan Marketing. Kemungkinan Nilai `breakdowns`: `messaging_channel` `recurring_notifications_topic` Metrik ini dalam pengembangan.
`page_messages_read_ratio`	Jumlah pesan yang dibaca dibagi jumlah pesan yang dikirim oleh Halaman Anda. Beberapa pesan yang dibaca mungkin tidak tercatat, seperti jika pelanggan menonaktifkan tanda terima pesan dibaca. Metrik ini hanya berisi data dari Pesan Marketing. Kemungkinan Nilai `breakdowns`: `messaging_channel` `recurring_notifications_topic` Metrik ini dalam pengembangan.
`page_messages_order_count`	Berapa kali Anda menghasilkan pesanan di percakapan pengiriman pesan atau di aplikasi atau situs web pihak ketiga yang digunakan untuk mengelola percakapan pengiriman pesan. Metrik ini dalam pengembangan.
`page_messages_paid_order_earnings`	Perkiraan jumlah uang yang Anda hasilkan dari pesanan yang dibuat melalui percakapan pengiriman pesan atau melalui aplikasi atau situs web pihak ketiga yang digunakan untuk mengelola percakapan pengiriman pesan. Pendapatan akhir mungkin berbeda karena konversi mata uang. Metrik ini dalam pengembangan.
`page_messages_with_business_outcomes`	Jumlah koneksi berkirim pesan dengan minimal satu pesanan yang telah dibuat. Metrik ini dalam pengembangan.
`page_messages_blocked_conversations_unique`	Jumlah percakapan dengan Halaman yang telah diblokir.
`page_messages_new_conversations_unique`	Jumlah percakapan pengiriman pesan di Messenger yang dimulai dengan orang yang belum pernah mengirimkan pesan ke bisnis Anda.
`page_messages_reported_conversations_unique`	Jumlah percakapan dari Halaman Anda yang telah dilaporkan oleh orang karena alasan seperti spam, atau berisi konten yang tidak pantas.
`page_messages_total_messaging_connections`	Jumlah orang yang bisa dikirimi pesan oleh bisnis Anda. Metrik ini menunjukkan jumlah orang yang pernah mengirimkan pesan ke bisnis Anda di Messenger, tidak termasuk orang yang telah memblokir atau melaporkan bisnis Anda di Messenger. Mungkin Anda akan mengalami beberapa batasan atas kemampuan mengirimkan pesan ke koneksi, seperti batasan jumlah pesan yang bisa dikirim selama jangka waktu tertentu. Metrik ini juga hanya menyertakan koneksi yang terjalin sejak Oktober 2016, ketika data tersedia.

Properti Tanggapan

Properti	Deskripsi
`data` array objek	Objek daftar metrik
`name` string	Nama metrik
`period` string	Periode waktu pengumpulan data
`values` array objek	Daftar data untuk metrik
`value` array objek	Jumlah metrik yang diminta per hari. Untuk metrik yang diperinci berdasarkan jenis, objek yang dihitung untuk setiap jenis akan ditampilkan.
`end_time` cap waktu Unix	Cap waktu UTC dari waktu berakhirnya metrik.

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan Messaging Insights API, kunjungi panduan Penggunaan Messaging Insights API.