Uvidi u Instagram Reels putem API-ja
Instagramov endpoint za uvide u medije, GET /<IG_MEDIA_ID>/insights, za Reel vraća ove metrike: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time i reels_skip_rate, a za Reel objavljen unakrsno i crossposted_views te facebook_views. Metrike plays, clips_replays_count i ig_reels_aggregated_all_plays_count ukinute su u travnju 2025., a umjesto njih dolazi views.
easyCoexistence čita uvide u Reel pomoću get_social_insights, pa Claude, ChatGPT ili vaš vlastiti kod mogu pitati kako je Reel prošao i dobiti prikaze, doseg, vrijeme gledanja i stopu preskakanja izravno od Mete za povezani račun, uz Metinu vlastitu pogrešku kad je naziv metrike ukinut.
Vremenski prozor koji mjeri reels_skip_rate: udio prikaza u kojima je Reel preskočen unutar prve 3 sekunde.
Kada su plays, clips_replays_count i ig_reels_aggregated_all_plays_count ukinute u svim verzijama API-ja.
Kada su reels_skip_rate, reposts, crossposted_views i facebook_views dodani u uvide u medije.
Koliko podaci iza metrika medija mogu kasniti.
Koliko dugo Meta pohranjuje metrike medija.
Koje metrike vraća Reel?
Metrike koje navodi Metin referentni popis uvida u medije za media_product_type REELS, a čitaju se pomoću GET /<IG_MEDIA_ID>/insights i parametra metric s popisom metrika odvojenih zarezom. Meta neke od njih označava kao procijenjene ili u razvoju, što je naznačeno uz svaku, a lajkove i komentare računa samo kao organsku aktivnost:
Što vraća zahtjev za uvide u Reels?
Po jedan objekt za svaku metriku u polju data, svaki s poljima name, period, values, title, description i id. period uvijek glasi lifetime: Meta ga postavlja za metrike medija i ne može se mijenjati, pa zahtjev ne treba nikakav. Metin referentni opis dvije metrike vremena gledanja navodi kao iznose vremena bez mjerne jedinice, pa ih prije prikazivanja na grafikonu provjerite na Reelu koji poznajete.
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"
}
]
}Koje su metrike Reelsa ukinute i čime su zamijenjene?
Meta je prve tri ukinula od Graph API v22.0 21. siječnja 2025., dana kad je uvela views, a u svim verzijama 21. travnja 2025.; video_views je ukinut od v21.0 i u svim verzijama 8. siječnja 2025. Zahtjev koji navodi ukinutu metriku ne uspijeva, pa popis metrika napisan prije 2025. treba ažurirati:
| 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 |
Što views i reach broje na Reelu?
views je broj puta kad je Reel reproduciran na Instagramu, metrika koju Meta označava kao u razvoju; reach je broj jedinstvenih računa koji su ga vidjeli barem jednom, što Meta označava kao procijenjeno. likes, comments, views i total_interactions broje samo organsku aktivnost, bez angažmana na oglasima napravljenima od Reela. total_likes, total_comments i total_views, koji uključuju promovirane medije, dostupni su samo uz Facebook Login.
Koja ograničenja i kašnjenja vrijede?
Metin referentni opis uvida u medije postavlja ova pravila za brojke Reelsa:
- Podaci iza metrika mogu kasniti do 48 sati.
- Metrike medija pohranjuju se do 2 godine.
- Nedostajući ili nedostupni podaci vraćaju prazan skup podataka, a ne 0.
crossposted_viewsifacebook_viewsvraćaju pogrešku za Reel koji nije objavljen unakrsno, pa ih zatražite u zasebnom pozivu.- Raščlamba koju zatražena metrika ne podržava obara cijeli zahtjev uz pogrešku An unknown error has occurred.
- Uz Instagram Login token mora imati
instagram_business_basiciinstagram_business_manage_insights, na graph.instagram.com.
Kako get_social_insights čita Reel?
Uz account_id veze, ID medija Reela kao object_id i popis metrika. easyCoexistence poziva GET /<IG_MEDIA_ID>/insights na graph.instagram.com s tokenom računa, prosljeđuje Meti nazive metrika onakvima kakvi su zadani i vraća Metine podatke ili Metinu vlastitu pogrešku kad je naziv ukinut. list_social_posts vraća ID-jeve medija nedavnih objava i Reelsa računa.
{
"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"
]
}Uobičajene pogreške
- Traženje plays ili clips_replays_count. Obje su ukinute u svim verzijama API-ja 21. travnja 2025.; zatražite views.
- Miješanje crossposted_views ili facebook_views u opći zahtjev. One vraćaju pogrešku za Reel koji nije objavljen unakrsno, a greška obara poziv.
- Pretpostavka jedinice za vrijeme gledanja. Meta ne navodi nijednu za ig_reels_avg_watch_time ni ig_reels_video_view_total_time, pa provjerite na poznatom Reelu.
- Tumačenje praznog rezultata kao nule. Meta vraća prazan skup podataka kad podaci ne postoje ili su trenutno nedostupni.
US$ 9 do US$ 0.75 po vezi mjesečno, uz pad kako dodajete veze, s prva 3 dana besplatno.
Često postavljana pitanja
Zašto zahtjev za uvide u Reels vraća prazan rezultat?
Meta vraća prazan skup podataka, a ne 0, kad podaci ne postoje ili su trenutno nedostupni, a podaci iza metrika mogu kasniti do 48 sati.
Kako dobiti vrijeme gledanja Reelsa putem API-ja?
Zatražite ig_reels_avg_watch_time za prosjek i ig_reels_video_view_total_time za ukupno, uključujući ponovna gledanja, iz GET /<IG_MEDIA_ID>/insights.
Što je reels_skip_rate?
Postotak početnih prikaza u kojima je Reel preskočen unutar prve 3 sekunde. Meta ga je dodala 3. prosinca 2025. i označava kao procijenjenu i u razvoju.
Uključuju li uvidi u Reels prikaze oglasa?
Ne. likes, comments, views i total_interactions broje samo organsku aktivnost; total_views, koji uključuje promovirane medije, dostupan je samo uz Facebook Login.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na