Insight Reels Instagram melalui API
Endpoint insights media Instagram, GET /<IG_MEDIA_ID>/insights, mengembalikan metrik ini untuk Reel: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time dan reels_skip_rate, serta crossposted_views dan facebook_views untuk Reel yang dikongsi silang. plays, clips_replays_count dan ig_reels_aggregated_all_plays_count dihentikan pada April 2025, dengan views menggantikannya.
easyCoexistence membaca insights Reel dengan get_social_insights, jadi Claude, ChatGPT atau kod anda sendiri boleh bertanya bagaimana Reel berprestasi dan mendapat tontonan, capaian, masa tontonan dan kadar langkau terus daripada Meta bagi akaun yang disambungkan, dengan ralat Meta sendiri apabila nama metrik dihentikan.
Tetingkap yang diukur oleh reels_skip_rate: bahagian tontonan yang melangkau Reel dalam 3 saat pertama.
Bila plays, clips_replays_count dan ig_reels_aggregated_all_plays_count dinyahguna dalam setiap versi API.
Bila reels_skip_rate, reposts, crossposted_views dan facebook_views ditambah pada insights media.
Berapa lama data di sebalik metrik media boleh tertangguh.
Berapa lama Meta menyimpan metrik media.
Metrik apa yang dikembalikan oleh Reel?
Metrik yang disenaraikan dalam rujukan insights media Meta untuk media_product_type REELS, dibaca dengan GET /<IG_MEDIA_ID>/insights dan parameter metrik dipisahkan koma. Meta melabelkan beberapa metrik sebagai anggaran atau dalam pembangunan, seperti yang dinyatakan di sebelahnya, dan hanya mengira suka dan ulasan sebagai aktiviti organik:
Apa yang dikembalikan oleh permintaan insights Reels?
Satu objek bagi setiap metrik dalam data, setiap satu dengan name, period, values, title, description dan id. period sentiasa berbunyi lifetime: Meta menetapkannya untuk metrik media dan ia tidak boleh diubah, jadi permintaan tidak memerlukannya. Rujukan Meta menerangkan dua metrik masa tontonan sebagai jumlah masa tanpa menamakan unit, jadi semak dengan Reel yang anda kenali sebelum memaparkannya dalam carta.
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{
"data": [
{
"name": "views",
"period": "lifetime",
"values": [{ "value": <VALUE> }],
"title": "<TITLE>",
"description": "<DESCRIPTION>",
"id": "<IG_MEDIA_ID>/insights/views/lifetime"
}
]
}Metrik Reels mana yang dihentikan, dan apa gantiannya?
Meta menghentikan tiga yang pertama dari Graph API v22.0 pada 21 Januari 2025, hari ia memperkenalkan views, dan dalam setiap versi pada 21 April 2025; video_views bermula dari v21.0 dan dalam setiap versi pada 8 Januari 2025. Permintaan yang menamakan metrik yang dihentikan akan gagal, jadi senarai metrik yang ditulis sebelum 2025 perlu dikemas kini:
| Retired | Request instead | |
|---|---|---|
| plays | Deprecated in every version on 21 Apr 2025 | views |
| clips_replays_count | Deprecated in every version on 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Deprecated in every version on 21 Apr 2025 | views |
| video_views | Deprecated in every version on 8 Jan 2025 | views |
| impressions | Not in Meta's Reels list; returns an error for media created on or after 2 Jul 2024 | views |
Apa yang dikira oleh views dan reach pada Reel?
views ialah bilangan kali Reel dimainkan di Instagram, metrik yang dilabelkan Meta sebagai dalam pembangunan; reach ialah bilangan akaun unik yang melihatnya sekurang-kurangnya sekali, yang dilabelkan Meta sebagai anggaran. likes, comments, views dan total_interactions hanya mengira aktiviti organik, tidak termasuk interaksi pada iklan yang dibuat daripada Reel. total_likes, total_comments dan total_views, yang merangkumi media dipromosikan, hanya ditawarkan dengan Facebook Login sahaja.
Had dan kelewatan apa yang terpakai?
Rujukan insights media Meta menetapkan peraturan ini untuk nombor Reel:
- Data di sebalik metrik boleh tertangguh sehingga 48 jam.
- Metrik media disimpan sehingga 2 tahun.
- Data yang hilang atau tidak tersedia mengembalikan set data kosong, bukan 0.
crossposted_viewsdanfacebook_viewsmenghasilkan ralat bagi Reel yang tidak dikongsi silang, jadi mintalah kedua-duanya dalam panggilan tersendiri.- Pecahan yang tidak disokong oleh metrik yang diminta menggagalkan keseluruhan permintaan dengan An unknown error has occurred.
- Dengan Instagram Login, token memerlukan
instagram_business_basicdaninstagram_business_manage_insights, pada graph.instagram.com.
Bagaimana get_social_insights membaca Reel?
Dengan account_id sambungan, ID media Reel sebagai object_id dan senarai metrik. easyCoexistence memanggil GET /<IG_MEDIA_ID>/insights pada graph.instagram.com dengan token akaun, menghantar nama metrik kepada Meta seperti yang diberikan dan memulangkan data Meta, atau ralat Meta sendiri apabila nama dihentikan. list_social_posts memulangkan ID media bagi siaran dan Reel terkini akaun.
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<REEL_MEDIA_ID>",
"metrics": [
"views", "reach", "likes", "comments", "shares", "saved",
"total_interactions", "ig_reels_avg_watch_time",
"ig_reels_video_view_total_time", "reels_skip_rate"
]
}Kesilapan biasa
- Meminta plays atau clips_replays_count. Kedua-duanya dihentikan dalam setiap versi API pada 21 April 2025; mintalah views.
- Mencampurkan crossposted_views atau facebook_views dalam permintaan umum. Ia menghasilkan ralat bagi Reel yang tidak dikongsi silang, dan ralat itu menggagalkan panggilan.
- Menganggap unit bagi masa tontonan. Rujukan Meta tidak menamakan sebarang unit bagi ig_reels_avg_watch_time atau ig_reels_video_view_total_time, jadi semak dengan Reel yang diketahui.
- Membaca hasil kosong sebagai sifar. Meta memulangkan set data kosong apabila data tidak wujud atau pada masa ini tidak tersedia.
Daripada US$ 9 sebulan bagi setiap sambungan, menurun kepada US$ 0.75 apabila anda menambah sambungan, dengan 3 hari percubaan percuma.
Soalan lazim
Mengapa permintaan insights Reels memulangkan hasil kosong?
Meta memulangkan set data kosong, bukan 0, apabila data tidak wujud atau pada masa ini tidak tersedia, dan data di sebalik metrik boleh ketinggalan sehingga 48 jam.
Bagaimana saya mendapatkan masa tontonan Reels daripada API?
Mintalah ig_reels_avg_watch_time untuk purata dan ig_reels_video_view_total_time untuk jumlah, termasuk main semula, daripada GET /<IG_MEDIA_ID>/insights.
Apakah reels_skip_rate?
Peratusan tontonan awal yang melangkau Reel dalam 3 saat pertama. Meta menambahkannya pada 3 Disember 2025 dan melabelkannya sebagai anggaran dan dalam pembangunan.
Adakah insights Reels termasuk tontonan iklan?
Tidak. likes, comments, views dan total_interactions hanya mengira aktiviti organik; total_views, yang merangkumi media dipromosikan, hanya ditawarkan dengan Facebook Login sahaja.
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