Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Wawasan siaran Facebook melalui API: tontonan, capaian dan interaksi

Wawasan siaran Facebook datang daripada GET /{page-post-id}/insights dengan metrik seperti post_media_view, bilangan kali siaran dimainkan atau dipaparkan, post_total_media_view_unique, penonton uniknya, post_clicks dan post_reactions_by_type_total. Meta telah tidak digunakan lagi bagi post_impressions pada November 2025 dan post_impressions_unique pada Jun 2026, jadi tontonan dan penonton unik kini menggantikan paparan dan capaian.

easyCoexistence membaca wawasan siaran Facebook dengan get_social_insights, supaya Claude, ChatGPT atau kod anda sendiri boleh bertanya bagaimana sesuatu siaran berprestasi dan mendapat semula tontonan, penonton unik, klik dan reaksi terkini Meta, dengan list_social_posts untuk mencari siaran itu.

post_total_media_view_unique

Pengganti yang disyorkan Meta bagi post_impressions_unique, yang ditetapkan tidak digunakan lagi untuk semua versi API pada Jun 2026.

15 Nov 2025

Apabila post_impressions berhenti memulangkan data dalam semua versi; Meta menamakan post_media_view sebagai alternatifnya.

lifetime

Tempoh yang disenaraikan Meta untuk metrik siaran seperti post_media_view, post_clicks dan jumlah reaksi.

Like + care

Apa yang termasuk dalam bilangan reaksi suka Meta: kedua-dua reaksi suka dan care.

Empty dataset

Apa yang dipulangkan Meta, dan bukannya ralat, apabila apl tidak mempunyai kebenaran read_insights.

Metrik siaran yang berfungsi pada 2026?

Metrik ini terdapat dalam rujukan wawasan Meta dan berada di luar senarai penyahgunaannya setakat 1 November 2026. Setiap satunya dibaca pada ID siaran, dengan tempoh sepanjang hayat kecuali dinyatakan:

  • post_media_view: bilangan kali siaran dimainkan atau dipaparkan, dengan pecahan is_from_ads dan is_from_followers.
  • post_total_media_view_unique: penonton unik bagi siaran, gantian Meta kepada capaian.
  • post_clicks: klik di mana-mana dalam siaran yang tidak menjana cerita; post_clicks_by_type membahagikannya mengikut jenis penggunaan.
  • post_reactions_by_type_total: reaksi mengikut jenis, dengan satu jumlah bagi setiap jenis seperti post_reactions_love_total atau post_reactions_anger_total.
  • post_video_views: tayangan video yang berlangsung sekurang-kurangnya 3 saat, dengan tempoh sepanjang hayat atau harian.

Apakah yang menggantikan paparan dan capaian siaran?

Meta mengalihkan pengukuran siaran daripada paparan kepada tontonan media dalam dua pusingan, setiap satunya bagi semua versi API serentak, dan nama yang telah dibatalkan kini memulangkan ralat metrik tidak sah. Log perubahan, halaman metrik yang tidak digunakan lagi dan nota Graph API v25 mereka memberikan gantian ini:

DeprecatedUse instead
Nov 15, 2025post_impressionspost_media_view
Nov 15, 2025post_impressions_paidpost_media_view with is_from_ads
Nov 15, 2025post_impressions_fanpost_media_view with is_from_followers
June 2026post_impressions_uniquepost_total_media_view_unique
June 2026post_impressions_paid_unique, post_impressions_organic_uniquepost_media_view breakdowns, which count views rather than people

Apakah beza antara tontonan dan penonton unik?

Tontonan mengira paparan, penonton unik mengira orang. post_media_view menjumlahkan setiap kali siaran dimainkan atau dipaparkan, jadi seorang yang melihatnya dua kali dikira dua kali, manakala post_total_media_view_unique mengira penonton unik siaran sekali bagi setiap orang. Meta menandakan metrik yang berakhir dengan _unique sebagai anggaran dan mengira nilai unik secara bebas, jadi jumlah tidak semestinya sama dengan hasil tambah bahagiannya.

Bagaimana anda memohon wawasan siaran?

Dengan GET /{page-post-id}/insights dan metric ditetapkan kepada senarai dipisahkan koma, atau GET /{page-post-id}/insights/{metric} untuk satu metrik. Token mesti datang daripada seseorang yang boleh melaksanakan tugas ANALYZE pada Halaman, dengan read_insights dan pages_read_engagement diberikan, dan setiap hasil membawa name, period, values, title dan description. Contoh Meta sendiri memohon jumlah reaksi:

Meta's example request and response for one post, trimmed
GET /{page-post-id}/insights?metric=post_reactions_like_total,post_reactions_love_total

{
  "data": [
    {
      "name": "post_reactions_like_total",
      "period": "lifetime",
      "values": [{ "value": 226 }],
      "title": "Lifetime Total Like Reactions of a post.",
      "id": "{page-post-id}/insights/post_reactions_like_total/lifetime"
    },
    {
      "name": "post_reactions_love_total",
      "period": "lifetime",
      "values": [{ "value": 17 }],
      "title": "Lifetime Total Love Reactions of a post.",
      "id": "{page-post-id}/insights/post_reactions_love_total/lifetime"
    }
  ]
}

Bagaimana anda mengira reaksi, komen dan kongsi?

Daripada medan siaran itu sendiri, di sebelah wawasannya. fields=reactions.summary(total_count) memulangkan jumlah reaksi, dan reactions.type(LOVE).limit(0).summary(total_count) bilangan satu jenis, daripada LIKE, LOVE, WOW, HAHA, SORRY dan ANGRY. Medan shares memegang bilangan kongsi, yang menurut Meta mungkin termasuk siaran yang dipadam dan siaran yang tidak dapat dilihat oleh token, dan tepi comments dengan summary=true menambah total_count.

Bagaimana metrik siaran berkaitan dengan metrik Halaman?

Metrik Halaman menjumlahkan kandungan Halaman dalam satu tempoh, manakala metrik siaran memberikan jumlah sepanjang hayat bagi satu siaran. page_post_engagements mengira interaksi dengan siaran Halaman melalui reaksi, komen, kongsi dan lain-lain, mengikut hari, minggu atau days_28, dan page_media_view serta page_total_media_view_unique berbuat demikian untuk tontonan dan penonton. Meta mengeluarkan post_engaged_users pada 2024, jadi interaksi bagi setiap siaran dibina daripada klik, reaksi, komen dan kongsi.

Sejauh mana segar data, dan sejauh mana ia kembali ke belakang?

Kebanyakan metrik dikemas kini sekali sehari, dan yang ditandai Meta dengan asterisk, seperti post_clicks, beberapa kali sehari. Meta menyimpan dua tahun wawasan bagi Halaman awam tetapi hanya 5 hari bagi Halaman yang tidak diterbitkan. Sepanjang hayat bermaksud tempoh data tersedia, dua tahun atau kurang secara lalai. Data Wawasan Halaman memerlukan Halaman dengan 100 suka atau lebih, dan beberapa metrik video membaca 0 pada video yang dikongsi semula daripada Halaman lain.

Bagaimana easyCoexistence membaca wawasan siaran?

get_social_insights mengambil metrik dan, untuk satu siaran, object_id iaitu ID siaran yang dipulangkan oleh list_social_posts; tanpa object_id ia membaca Halaman. period dan parameter tambahan seperti since dan until diteruskan kepada Meta tanpa perubahan, dan metrik yang telah dibatalkan kembali sebagai ralat metrik tidak sah Meta, supaya AI boleh bertukar kepada nama semasa.

Kesilapan biasa

  • Memohon post_impressions_unique. Meta telah menetapkannya tidak digunakan lagi bagi semua versi API pada Jun 2026; mohon post_total_media_view_unique untuk mengira penonton unik.
  • Menjumlahkan penonton unik merentas siaran. Setiap siaran mengira penontonnya sendiri, sebagai anggaran sahaja, jadi seorang yang melihat dua siaran dikira dua kali.
  • Membaca wawasan bagi video yang dikongsi semula daripada Halaman lain. Beberapa metrik video memulangkan 0 bagi kongsi semula; hanya Halaman yang mencipta video itu mendapat nilai tepat.
  • Mempercayai sifar daripada respons kosong. Tanpa read_insights Meta memulangkan set data kosong dan bukannya ralat, jadi semak kebenaran dahulu.
Menggunakan EasyCoexistence untuk ini

Daripada US$ 9 turun kepada US$ 0.75 setiap sambungan sebulan apabila sambungan ditambah, dengan percubaan percuma 3 hari pertama.

Soalan lazim

Apakah yang menggantikan capaian siaran di Facebook?

post_total_media_view_unique, bilangan penonton unik bagi siaran, selepas Meta menetapkan post_impressions_unique tidak digunakan lagi pada Jun 2026.

Bolehkah saya melihat siapa yang bereaksi kepada siaran Halaman?

Tidak. Meta memulangkan bilangan reaksi mengikut jenis, tetapi Halaman atau orang hanya boleh bertanya mengenai reaksinya sendiri; yang lain kekal peribadi.

Adakah bilangan suka termasuk reaksi care?

Ya. Jumlah suka Meta mengira kedua-dua suka dan care, dalam wawasan dan pada tepi reaksi.

Bolehkah saya membaca wawasan bagi siaran di Halaman lain?

Tidak melalui wawasan Halaman: ia memerlukan token daripada seseorang yang boleh melaksanakan tugas ANALYZE pada Halaman yang mencipta siaran itu.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada