Instagram Reels -insightit API:n kautta
Instagramin media insights -päätepiste, GET /<IG_MEDIA_ID>/insights, palauttaa Reelille nämä mittarit: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time ja reels_skip_rate sekä ristiinjulkaistulle Reelille crossposted_views ja facebook_views. plays, clips_replays_count ja ig_reels_aggregated_all_plays_count poistettiin huhtikuussa 2025, ja niiden tilalle tuli views.
easyCoexistence lukee Reelin insightit get_social_insights-työkalulla, joten Claude, ChatGPT tai oma koodisi voi kysyä, miten Reel menestyi, ja saa katselut, tavoittavuuden, katseluajan ja ohituslukuasteen suoraan Metalta yhdistetylle tilille.
reels_skip_rate mittaa niiden katselujen osuuden, joissa Reel ohitettiin sen ensimmäisten 3 sekunnin aikana.
Milloin plays, clips_replays_count ja ig_reels_aggregated_all_plays_count poistettiin käytöstä kaikissa API-versioissa.
Milloin reels_skip_rate, reposts, crossposted_views ja facebook_views lisättiin media insights -tietoihin.
Kuinka paljon media-mittareiden taustalla oleva data voi viivästyä.
Kuinka kauan Meta tallentaa media-mittarit.
Mitä mittareita Reel palauttaa?
Ne, jotka Metan media insights -viite listaa media_product_type-arvolle REELS. Ne luetaan GET /<IG_MEDIA_ID>/insights -pyynnöllä, jossa metric-parametri on pilkulla erotettu lista. Meta merkitsee useat niistä arvioiduiksi tai kehitteillä oleviksi, kuten kunkin kohdalla mainitaan, ja laskee tykkäykset ja kommentit vain orgaaniseksi toiminnaksi:
Mitä Reelsin insights-pyyntö palauttaa?
Yhden objektin jokaista mittaria kohden data-kentässä, jossa on name, period, values, title, description ja id. period on aina lifetime: Meta asettaa sen media-mittareille eikä sitä voi muuttaa, joten pyyntö ei tarvitse sitä. Metan viite kuvaa kahta katseluaikamittaria aikamääränä ilman yksikköä, joten tarkista ne tunnetulla Reelillä ennen kuin piirrät niistä kaavioita.
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"
}
]
}Mitkä Reels-mittarit poistettiin ja mikä korvasi ne?
Meta poisti kolme ensimmäistä Graph API:n versiosta 22.0 alkaen 21. tammikuuta 2025, sinä päivänä kun se otti käyttöön views-mittarin, ja kaikissa versioissa 21. huhtikuuta 2025 alkaen. video_views poistui versiosta v21.0 alkaen ja kaikissa versioissa 8. tammikuuta 2025. Pyyntö, joka nimeää poistuneen mittarin, epäonnistuu, joten ennen vuotta 2025 kirjoitettu mittarilista täytyy päivittää:
| 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 |
Mitä views ja reach laskevat Reelillä?
views on kertojen määrä, joina Reel toistettiin Instagramissa, ja Meta merkitsee tämän mittarin kehitteillä olevaksi. reach on niiden uniikkien tilien määrä, jotka näkivät Reelin vähintään kerran, ja Meta merkitsee sen arvioiduksi. likes, comments, views ja total_interactions laskevat vain orgaanista toimintaa, eikä niihin sisälly Reelistä tehtyjen mainosten vuorovaikutusta. total_likes, total_comments ja total_views, jotka sisältävät mainostettua mediaa, ovat saatavilla vain Facebook Login -kirjautumisen kanssa.
Mitkä rajoitukset ja viiveet koskevat?
Metan media insights -viite asettaa Reelin lukuihin nämä säännöt:
- Mittareiden taustalla oleva data voi viivästyä jopa 48 tuntia.
- Media-mittareita säilytetään jopa 2 vuotta.
- Puuttuva tai tällä hetkellä saamaton data palauttaa tyhjän data-joukon, ei nollaa.
crossposted_viewsjafacebook_viewsheittävät virheen Reelille, jota ei ristiinjulkaistu, joten pyydä ne omassa kutsussaan.- Erittely, jota pyydetty mittari ei tue, epäonnistuttaa koko pyynnön virheellä: An unknown error has occurred.
- Instagram Loginilla tokenin täytyy sisältää
instagram_business_basicjainstagram_business_manage_insights, ja pyynnöt menevät osoitteeseen graph.instagram.com.
Miten get_social_insights lukee Reelin?
Yhteyden account_id-kentällä, Reelin media-ID:llä object_id-kentässä ja mittarilistalla. easyCoexistence kutsuu graph.instagram.comissa GET /<IG_MEDIA_ID>/insights -päätepistettä tilin tokenilla, välittää mittarien nimet Metalle sellaisinaan ja palauttaa Metan datan tai Metan oman virheen, kun nimi on poistunut. list_social_posts palauttaa tilin viimeaikaisten julkaisujen ja Reelien media-ID:t.
{
"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"
]
}Yleiset virheet
- Plays- tai clips_replays_count-mittarin pyytäminen. Molemmat poistettiin käytöstä kaikissa API-versioissa 21. huhtikuuta 2025; pyydä views.
- crossposted_views tai facebook_views lisääminen yleiseen pyyntöön. Ne heittävät virheen Reelille, jota ei ristiinjulkaistu, ja virhe epäonnistuttaa kutsun.
- Katseluajan yksikön olettaminen. Meta ei nimeä yksikköä ig_reels_avg_watch_time- eikä ig_reels_video_view_total_time-mittarille, joten tarkista tunnetulla Reelillä.
- Tyhjän tuloksen lukeminen nollana. Meta palauttaa tyhjän data-joukon, kun dataa ei ole tai se ei ole tällä hetkellä saatavilla.
Kun metric-nimi on poistunut, saat Metan oman virheen. US$ 9:stä US$ 0.75:een per yhteys kuukaudessa, hinnan laskiessa yhteyksien lisääntyessä. Ensimmäiset 3 päivää ovat ilmainen kokeilu.
Usein kysytyt kysymykset
Miksi Reels-insights-pyyntö palauttaa tyhjän tuloksen?
Meta palauttaa tyhjän data-joukon, ei nollaa, kun dataa ei ole tai se ei ole tällä hetkellä saatavilla. Mittareiden taustalla oleva data voi lisäksi viivästyä jopa 48 tuntia.
Miten saan Reelsin katseluajan API:sta?
Pyydä ig_reels_avg_watch_time keskiarvolle ja ig_reels_video_view_total_time kokonaisajalle, toistot mukaan lukien, GET /<IG_MEDIA_ID>/insights -päätepisteestä.
Mikä on reels_skip_rate?
Prosenttiosuus alkuperäisistä katselukerroista, joissa Reel ohitettiin sen ensimmäisten 3 sekunnin aikana. Meta lisäsi sen 3. joulukuuta 2025 ja merkitsee sen arvioiduksi ja kehitteillä olevaksi.
Sisältävätkö Reels-insightit mainosnäyttökerrat?
Eivät. likes, comments, views ja total_interactions laskevat vain orgaanista toimintaa. total_views, johon sisältyy mainostettua mediaa, on saatavilla vain Facebook Login -kirjautumisen kanssa.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu