Insight delle Storie di Instagram tramite l'API
L'endpoint degli insight sui media di Instagram restituisce per una Storia, finché è online, queste metriche: reach, views, replies, shares, navigation, follows, profile_visits, profile_activity, reposts e total_interactions. navigation si suddivide per story_navigation_action_type in TAP_FORWARD, TAP_BACK, TAP_EXIT e SWIPE_FORWARD. Le metriche delle Storie sono disponibili per 24 ore, i valori sotto 5 restituiscono l'errore 10, e Instagram Login non ha alcun webhook story_insights.
easyCoexistence legge gli insight di una Storia con get_social_insights mentre è online, così Claude, ChatGPT o il tuo codice possono chiedere come sono andate le Storie di oggi e ottenere da Meta, direttamente per l'account collegato, portata, visualizzazioni, risposte, condivisioni e navigazione.
Per quanto tempo le metriche dei media delle Storie sono disponibili tramite l'API.
Restituito al posto di un valore quando una metrica della Storia è sotto 5: non ci sono abbastanza spettatori perché il media mostri gli insight.
L'unico setup indicato dalla guida di Meta agli insight per il webhook story_insights; non è supportato con Instagram Login.
Il valore di replies per una Storia creata da un account in Europa o in Giappone.
Quando Meta ha aggiunto link_clicks per le Storie, contando i tap sui link come gli adesivi link, solo per Facebook Login.
Quali metriche restituisce una Storia?
Quelle che il riferimento degli insight sui media di Meta elenca per media_product_type STORY, lette con GET /<STORY_MEDIA_ID>/insights mentre la Storia è online. Con Instagram Login la richiesta va a graph.instagram.com con un token che include instagram_business_basic e instagram_business_manage_insights, e period è sempre lifetime:
Come si legge la navigazione per azione?
Richiedi navigation da sola con breakdown=story_navigation_action_type. Il totale arriva in total_value.value e ogni azione in total_value.breakdowns[].results, che sommati danno quel totale: TAP_FORWARD (Avanti), TAP_BACK (Indietro), TAP_EXIT (Uscita) e SWIPE_FORWARD (Storia successiva). L'esempio di risposta di Meta scrive i valori in minuscolo:
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"
}
]
}Per quanto tempo sono disponibili le metriche delle Storie?
24 ore. Meta rende disponibili le metriche dei media delle Storie solo per 24 ore, cioè per la vita stessa della Storia, mentre i dati alla base possono avere un ritardo fino a 48 ore. Leggile con una pianificazione mentre la Storia è online e conserva gli ultimi valori ottenuti. Meta segnala che i dati possono arrivare anche dopo la scadenza, se la Storia viene aggiunta a un highlight, e che in quel caso richieste API, webhook e app possono mostrare risultati diversi.
Perché una metrica della Storia restituisce l'errore 10?
Perché il suo valore è sotto 5. Meta restituisce il codice di errore 10 con il messaggio (#10) Not enough viewers for the media to show insights al posto di un numero piccolo, quindi una Storia vista da poche persone può fallire mentre una più seguita riesce. Consideralo un conteggio basso, non un'interruzione, e non riprovare in un ciclo.
Perché le risposte di una Storia sono 0?
Per regole regionali. Le risposte di persone in Europa, dal 1° dicembre 2020, e in Giappone, dal 14 aprile 2021, sono escluse dalla metrica replies, quindi una Storia creata da un account in una di quelle regioni restituisce 0. Il riferimento di Meta definisce replies come IG Comments sull'oggetto media della Storia.
Esiste un webhook story_insights?
Non con Instagram Login. La tabella dei campi di Meta segna story_insights come non disponibile lì, il riferimento sugli insight dei media dice che il webhook degli insight non è supportato con Instagram Login, e la guida agli insight lo elenca solo per Facebook Login. Con Facebook Login il campo scatta quando una Storia scade, include solo le prime 24 ore di metriche e restituisce i conteggi sotto 5 come -1.
Quali metriche delle Storie sono ritirate o limitate?
Alcuni nomi compaiono ancora nel vecchio codice o nel changelog di Meta:
- impressions: deprecata per i media creati dopo il 2 luglio 2024, quindi una Storia attuale riporta views.
taps_forward,taps_backe exits: ritirate l'11 dicembre 2023; navigation, suddivisa perstory_navigation_action_type, riporta le stesse azioni.link_clicks: tap sui link come gli adesivi link, aggiunta il 22 giugno 2026 solo per Facebook Login.total_views: visualizzazioni su tutte le superfici, inclusi i media promossi, disponibile solo con Facebook Login.
Come legge get_social_insights una Storia?
Con l'ID media della Storia come object_id, che publish_instagram_post restituisce come media_id quando pubblica la Storia, e le metriche come lista. Richiedi navigation in una richiesta separata con params impostato su breakdown story_navigation_action_type, perché un breakdown non supportato da una metrica richiesta fa fallire l'intera richiesta. Gli errori di Meta, errore 10 incluso, arrivano così come Meta li ha scritti.
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<STORY_MEDIA_ID>",
"metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}Errori comuni
- Leggere le metriche di una Storia il giorno dopo. Meta le rende disponibili solo per 24 ore, quindi raccoglile mentre la Storia è online.
- Riprovare l'errore 10 in un ciclo. Indica un valore sotto 5, cioè pochi spettatori, e non cambierà finché più persone non vedranno la Storia.
- Chiedere navigation con un breakdown insieme ad altre metriche. story_navigation_action_type funziona solo con navigation, e un breakdown non supportato fa fallire l'intera richiesta.
- Aspettare story_insights con Instagram Login. Meta non offre quel webhook lì, quindi interroga l'endpoint degli insight prima che la Storia scada.
Le Storie si pubblicano con publish_instagram_post. Da US$ 9 a US$ 0,75 per connessione al mese, con calo man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.
Domande frequenti
Le metriche delle Storie cambiano dopo che una Storia viene aggiunta a un highlight?
Possono cambiare. Meta dice che una Storia aggiunta a un highlight può continuare a ricevere dati dopo la scadenza, quindi API, webhook e app possono non coincidere per un po'.
total_views funziona per le Storie con Instagram Login?
No. total_views, che conta le visualizzazioni su tutte le superfici inclusi i media promossi, è disponibile solo con Facebook Login; con Instagram Login richiedi views.
L'API può leggere i clic sugli adesivi link di una Storia di Instagram?
Solo con Facebook Login. Meta ha aggiunto link_clicks per le Storie il 22 giugno 2026, conta i tap sui link come gli adesivi link, e non lo offre con Instagram Login.
Cosa ha sostituito taps_forward, taps_back ed exits?
navigation, suddivisa per story_navigation_action_type in TAP_FORWARD, TAP_BACK, TAP_EXIT e SWIPE_FORWARD. Le vecchie metriche sono state ritirate l'11 dicembre 2023.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il