Instagram Reels insights gamit ang API
Ang media insights endpoint ng Instagram, GET /<IG_MEDIA_ID>/insights, ay nagbabalik ng mga sumusunod na metric para sa isang Reel: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time at reels_skip_rate, at crossposted_views at facebook_views para sa crossposted na Reel. Ang plays, clips_replays_count at ig_reels_aggregated_all_plays_count ay na-retire noong Abril 2025, at ang views ang pumalit sa mga ito.
Binabasa ng easyCoexistence ang insights ng isang Reel gamit ang get_social_insights, kaya ang Claude, ChatGPT o sarili ninyong code ay maaaring magtanong kung paano nag-perform ang isang Reel at makakuha ng views, reach, watch time at skip rate diretso mula sa Meta para sa naka-connect na account, kasama ang sariling error ng Meta kapag na-retire ang isang pangalan ng metric.
Ang sinusukat ng reels_skip_rate: ang porsyento ng views na nilaktawan ang Reel sa loob ng unang 3 segundo.
Kailan na-deprecate ang plays, clips_replays_count at ig_reels_aggregated_all_plays_count sa bawat API version.
Kailan idinagdag ang reels_skip_rate, reposts, crossposted_views at facebook_views sa media insights.
Gaano katagal maaaring ma-delay ang datos sa likod ng media metrics.
Gaano katagal iniimbak ng Meta ang media metrics.
Aling mga metric ang ibinabalik ng isang Reel?
Ang mga nakalista sa reference ng media insights ng Meta para sa media_product_type REELS, na binabasa gamit ang GET /<IG_MEDIA_ID>/insights at isang comma-separated na metric parameter. May label ang Meta na estimated o in development ang ilan sa mga ito, gaya ng nakasaad sa tabi ng bawat isa, at binibilang lamang ang likes at comments bilang organic activity:
Ano ang ibinabalik ng isang Reels insights request?
Isang object para sa bawat metric sa data, bawat isa ay may name, period, values, title, description at id. Laging lifetime ang period: itinatakda ito ng Meta para sa media metrics at hindi ito mababago, kaya hindi na ito kailangan sa request. Inilalarawan ng reference ng Meta ang dalawang watch-time metric bilang dami ng oras nang hindi binabanggit ang unit, kaya i-check muna ninyo ang mga ito sa isang Reel na kilala ninyo bago ninyo ito i-chart.
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"
}
]
}Aling mga Reels metric ang na-retire, at ano ang pumalit sa mga ito?
Na-deprecate ng Meta ang unang tatlo mula sa Graph API v22.0 noong 21 Enero 2025, ang araw na ipinakilala nito ang views, at sa lahat ng version noong 21 Abril 2025; ang video_views naman ay mula v21.0 at sa lahat ng version noong 8 Enero 2025. Pumapalya ang request na nagbanggit ng retired na metric, kaya kailangang i-update ang listahan ng metric na isinulat bago ang 2025:
| 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 |
Ano ang binibilang ng views at reach sa isang Reel?
Ang views ay ang bilang ng beses na na-play ang Reel sa Instagram, isang metric na may label ng Meta na in development; ang reach ay ang bilang ng natatanging account na nakakita nito kahit isang beses, na may label ng Meta na estimated. Ang likes, comments, views at total_interactions ay binibilang lamang ang organic activity, hindi kasama ang engagement sa mga ad na ginawa mula sa Reel. Ang total_likes, total_comments at total_views, na kasama ang promoted media, ay inaalok lamang sa Facebook Login.
Anong mga limit at delay ang nalalapat?
Itinatakda ng reference ng media insights ng Meta ang mga sumusunod na patakaran para sa mga numero ng isang Reel:
- Maaaring ma-delay nang hanggang 48 oras ang datos sa likod ng mga metric.
- Iniimbak ang media metrics nang hanggang 2 taon.
- Ang nawawala o hindi available na datos ay nagbabalik ng empty data set, hindi 0.
- Nagbabalik ng error ang
crossposted_viewsatfacebook_viewspara sa Reel na hindi na-crosspost, kaya humiling ng mga ito sa sarili nilang tawag. - Ang breakdown na hindi sinusuportahan ng hiniling na metric ay nagpapabagsak sa buong request na may An unknown error has occurred.
- Sa Instagram Login, kailangan ng token ang
instagram_business_basicatinstagram_business_manage_insights, sa graph.instagram.com.
Paano binabasa ng get_social_insights ang isang Reel?
Gamit ang account_id ng koneksyon, ang media ID ng Reel bilang object_id, at listahan ng metric. Tumatawag ang easyCoexistence sa GET /<IG_MEDIA_ID>/insights sa graph.instagram.com gamit ang token ng account, ipinapasa ang mga pangalan ng metric sa Meta gaya ng ibinigay, at ibinabalik ang datos ng Meta, o ang sariling error ng Meta kapag na-retire ang isang pangalan. Ibinabalik ng list_social_posts ang mga media ID ng mga kamakailang post at Reel ng account.
{
"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"
]
}Mga karaniwang pagkakamali
- Ang pag-request ng plays o clips_replays_count. Pareho silang na-deprecate sa lahat ng API version noong 21 Abril 2025; humingi ng views.
- Ang paghahalo ng crossposted_views o facebook_views sa isang pangkalahatang request. Nagbabalik sila ng error para sa Reel na hindi na-crosspost, at ang error ay nagpapabagsak sa tawag.
- Ang pag-aakala ng unit para sa watch time. Hindi binabanggit ng reference ng Meta ang unit para sa ig_reels_avg_watch_time o ig_reels_video_view_total_time, kaya i-check ito laban sa Reel na kilala ninyo.
- Ang pagbasa sa empty na resulta bilang zero. Nagbabalik ang Meta ng empty data set kapag hindi umiiral ang datos o kasalukuyang hindi available.
Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may free trial sa unang 3 araw.
Mga madalas itanong
Bakit empty result ang ibinabalik ng isang Reels insights request?
Nagbabalik ang Meta ng empty data set, hindi 0, kapag hindi umiiral ang datos o kasalukuyang hindi available, at maaaring maantala nang hanggang 48 oras ang datos sa likod ng mga metric.
Paano ko makukuha ang watch time ng Reels mula sa API?
I-request ang ig_reels_avg_watch_time para sa average at ang ig_reels_video_view_total_time para sa kabuuan, kasama ang replays, mula sa GET /<IG_MEDIA_ID>/insights.
Ano ang reels_skip_rate?
Ang porsyento ng mga unang view na nilaktawan ang Reel sa unang 3 segundo nito. Idinagdag ito ng Meta noong 3 Disyembre 2025 at may label itong estimated at in development.
Kasama ba sa Reels insights ang ad views?
Hindi. Ang likes, comments, views at total_interactions ay binibilang lamang ang organic activity; ang total_views, na kasama ang promoted media, ay inaalok lamang sa Facebook Login.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong