Insight-urile pentru Story-urile Instagram prin API
Endpoint-ul de insights al media din Instagram returnează aceste metrici pentru un Story cât timp acesta este activ: reach, views, replies, shares, navigation, follows, profile_visits, profile_activity, reposts și total_interactions. navigation se defalcă după story_navigation_action_type în TAP_FORWARD, TAP_BACK, TAP_EXIT și SWIPE_FORWARD. Metricile Story sunt disponibile timp de 24 de ore, valorile sub 5 returnează eroarea 10, iar Instagram Login nu are webhook-ul story_insights.
easyCoexistence citește insight-urile unui Story cu get_social_insights cât timp este activ, astfel că Claude, ChatGPT sau propriul cod pot întreba cum au mers Story-urile de azi și pot primi direct de la Meta reach, vizualizări, răspunsuri, partajări și navigare pentru contul conectat.
Cât timp sunt disponibile prin API metricile media ale Story-urilor.
Returnat în locul unei valori când o metrică Story este sub 5: nu sunt suficienți spectatori ca media să afișeze insight-uri.
Singura configurare pe care o cere ghidul Meta pentru insights este webhook-ul story_insights; nu este acceptat cu Instagram Login.
Valoarea replies pentru un Story creat de un cont din Europa sau Japonia.
Când Meta a adăugat link_clicks pentru Story-uri, numărând atingerile pe linkuri, cum ar fi sticker-ele de link, doar pentru Facebook Login.
Ce metrici returnează un Story?
Cele pe care referința Meta pentru media insights le listează pentru media_product_type STORY, citite cu GET /<STORY_MEDIA_ID>/insights cât timp Story-ul este activ. Cu Instagram Login, apelul merge la graph.instagram.com cu un token care are instagram_business_basic și instagram_business_manage_insights, iar period este mereu lifetime:
Cum citiți navigarea pe acțiune?
Cereți navigation separat, cu breakdown=story_navigation_action_type. Totalul vine în total_value.value, iar fiecare acțiune în total_value.breakdowns[].results, care se adună până la el: TAP_FORWARD (înainte), TAP_BACK (înapoi), TAP_EXIT (ieșire) și SWIPE_FORWARD (Story următor). Exemplul de răspuns al Meta scrie valorile cu litere mici:
GET https://graph.instagram.com/<STORY_MEDIA_ID>/insights
?metric=navigation
&breakdown=story_navigation_action_type
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{
"data": [
{
"name": "navigation",
"period": "lifetime",
"values": [{ "value": 25 }],
"total_value": {
"value": 25,
"breakdowns": [
{
"dimension_keys": ["story_navigation_action_type"],
"results": [
{ "dimension_values": ["tap_forward"], "value": 19 },
{ "dimension_values": ["tap_back"], "value": 4 },
{ "dimension_values": ["tap_exit"], "value": 1 },
{ "dimension_values": ["swipe_forward"], "value": 1 }
]
}
]
},
"id": "<STORY_MEDIA_ID>/insights/navigation/lifetime"
}
]
}Cât timp sunt disponibile metricile Story?
24 de ore. Meta face metricile media ale Story-urilor disponibile doar 24 de ore, adică durata de viață a Story-ului, în timp ce datele din spatele lor pot întârzia până la 48 de ore. Citiți-le după un program cât timp Story-ul este activ și păstrați ultimele valori primite. Meta notează că datele pot sosi și după expirarea unui Story adăugat într-un highlight și că apelurile API, webhook-urile și aplicația pot arăta atunci rezultate diferite.
De ce o metrică Story returnează eroarea 10?
Pentru că valoarea ei este sub 5. Meta returnează codul de eroare 10 cu mesajul (#10) Not enough viewers for the media to show insights în loc de un număr mic, deci un Story văzut de puțini oameni poate eșua acolo unde unul mai vizitat reușește. Tratați-o ca pe un număr mic, nu ca pe o defecțiune, și nu reîncercați în buclă.
De ce sunt 0 răspunsurile unui Story?
Reguli regionale. Răspunsurile de la persoane din Europa, din 1 decembrie 2020, și din Japonia, din 14 aprilie 2021, sunt excluse din metrica replies, iar un Story creat de un cont dintr-una din aceste regiuni returnează 0. Referința Meta definește replies ca IG Comments pe obiectul media Story.
Există un webhook story_insights?
Nu cu Instagram Login. Tabelul de câmpuri al Meta marchează story_insights ca indisponibil acolo, referința media insights spune că webhook-ul de insights nu este acceptat cu Instagram Login, iar ghidul de insights listează story_insights doar pentru Facebook Login. Cu Facebook Login, câmpul se declanșează când expiră un Story, transportă doar primele 24 de ore de metrici și returnează numărările sub 5 ca -1.
Ce metrici Story sunt retrase sau limitate?
Câteva nume mai apar în cod vechi sau în changelog-ul Meta:
- impressions: depreciată pentru media create după 2 iulie 2024, deci un Story actual raportează views în loc de ea.
taps_forward,taps_backși exits: retrase la 11 decembrie 2023; navigation, defalcată dupăstory_navigation_action_type, raportează aceleași acțiuni.link_clicks: atingeri pe linkuri, cum ar fi sticker-ele de link, adăugată la 22 iunie 2026 doar pentru Facebook Login.total_views: vizualizări pe toate suprafețele, inclusiv media promovată, oferită doar cu Facebook Login.
Cum citește get_social_insights un Story?
Cu ID-ul media al Story-ului ca object_id, pe care publish_instagram_post îl returnează ca media_id când publică Story-ul, iar metricile ca listă. Cereți navigation într-un apel separat, cu params setat la breakdown story_navigation_action_type, pentru că un breakdown pe care nu-l acceptă una dintre metricile cerute face să eșueze întregul apel. Erorile Meta, inclusiv eroarea 10, vin așa cum le-a scris Meta.
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<STORY_MEDIA_ID>",
"metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}Greșeli frecvente
- Citirea metricilor unui Story a doua zi. Meta le face disponibile doar 24 de ore, deci colectați-le cât timp Story-ul este activ.
- Reîncercarea în buclă a erorii 10. Înseamnă o valoare sub 5, adică nu sunt suficienți spectatori, și nu se va schimba până când mai mulți oameni văd Story-ul.
- Cererea navigation cu breakdown alături de alte metrici. story_navigation_action_type funcționează doar cu navigation, iar un breakdown neacceptat face să eșueze întregul apel.
- Așteptarea story_insights cu Instagram Login. Meta nu oferă acel webhook acolo, deci interogați endpoint-ul de insights înainte ca Story-ul să expire.
Story-urile se publică cu publish_instagram_post. De la US$ 9 până la US$ 0,75 pe conexiune pe lună, cu scădere pe măsură ce adăugați conexiuni, și perioadă de probă gratuită de 3 zile.
Întrebări frecvente
Se schimbă insight-urile Story după ce un Story ajunge într-un highlight?
Pot să se schimbe. Meta spune că un Story adăugat într-un highlight poate continua să primească date după expirare, deci API-ul, webhook-urile și aplicația pot diferi o vreme.
Funcționează total_views pentru Story-urile cu Instagram Login?
Nu. total_views, care numără vizualizările pe toate suprafețele, inclusiv media promovată, este oferit doar cu Facebook Login; cu Instagram Login cereți views.
Poate API-ul să citească clicurile pe sticker-ele de link ale unui Story Instagram?
Doar cu Facebook Login. Meta a adăugat link_clicks pentru Story-uri pe 22 iunie 2026, numărând atingerile pe linkuri precum sticker-ele de link, și nu o oferă cu Instagram Login.
Ce a înlocuit taps_forward, taps_back și exits?
navigation, defalcată după story_navigation_action_type în TAP_FORWARD, TAP_BACK, TAP_EXIT și SWIPE_FORWARD. Metricile vechi au fost retrase la 11 decembrie 2023.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la