Metriche deprecate dell'Instagram API: impressions e plays sostituiti da views
Meta ha sostituito impressions con views nell'API insights di Instagram. Ha introdotto views il 21 gennaio 2025 e ha deprecato impressions, plays, clips_replays_count e ig_reels_aggregated_all_plays_count in tutte le versioni dell'API il 21 aprile 2025, dopo che video_views e sei metriche dell'account erano terminate l'8 gennaio. Modifiche successive hanno aggiunto metriche, come reposts e reels_skip_rate a dicembre 2025.
easyCoexistence legge gli insight di Instagram con get_social_insights, che passa a Meta i nomi delle metriche indicati così come sono, views compresa, e restituisce i dati di Meta o il messaggio di errore di Meta quando un nome è ritirato, così Claude, ChatGPT o il tuo codice possono seguire un cambio di nome il giorno in cui Meta lo introduce.
Quando impressions, plays, clips_replays_count e ig_reels_aggregated_all_plays_count sono stati deprecati in tutte le versioni dell'API.
Quando Meta ha introdotto views per gli insight di account e media, e ha aperto gli insight alle app Instagram Login.
Quando video_views e sei serie temporali dell'account, tra cui profile_views e website_clicks, hanno smesso di essere supportate in tutte le versioni.
I media creati il o dopo questa data restituiscono un errore, non dati, se si richiede impressions dopo il 21 aprile 2025.
L'unico metric_type accettato dalla metrica views a livello di account; impressions offriva anche una time_series giornaliera.
Quali metriche Instagram ha ritirato Meta nel 2025?
Due tranche, ciascuna annunciata con mesi di anticipo nel changelog di Meta e applicata prima da una nuova versione della Graph API, poi a tutte le versioni:
- 8 gennaio 2025:
video_viewssui media e le serie temporali dell'accountemail_contacts,get_direction_clicks,phone_call_clicks,profile_views,text_message_clicksewebsite_clicks, eliminate per primo nella v21.0. - 21 gennaio 2025: impressions su insight di account e media, e plays,
clips_replays_counteig_reels_aggregated_all_plays_countsui media, deprecate dalla v22.0 in poi, il giorno in cui è arrivata views. - 21 aprile 2025: quelle quattro deprecate in tutte le versioni dell'API.
Cosa dovrebbe diventare ciascuna metrica ritirata?
Meta ha abbinato views ai ritiri di aprile 2025 nella stessa voce del changelog. Per quelli di gennaio non ha indicato alcun successore, quindi la colonna di destra riporta la metrica più vicina che i riferimenti per account e media documentavano al 31 ottobre 2026.
| Retired | Request instead | |
|---|---|---|
| impressions | Account and media, 21 Apr 2025 | views |
| plays | Media, 21 Apr 2025 | views |
| clips_replays_count | Media, 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Media, 21 Apr 2025 | views |
| video_views | Media, 8 Jan 2025 | views |
| phone_call_clicks, email_contacts, text_message_clicks, get_direction_clicks | Account, 8 Jan 2025 | profile_links_taps, by contact_button_type |
| profile_views | Account, 8 Jan 2025 | profile_visits, per post or Story |
| website_clicks | Account, 8 Jan 2025 | profile_activity per post, whose action_type includes BIO_LINK_CLICKED |
impressions restituisce ancora qualcosa?
Solo per i media più vecchi. Il changelog di Meta dice che le richieste fatte dopo il 21 aprile 2025 per media creati il o dopo il 2 luglio 2024 restituiscono un errore, e il riferimento agli insight dei media mantiene impressions solo per i media creati prima di quella data. Sull'account, impressions è deprecata in tutte le versioni, quindi il codice scritto oggi non ne ha bisogno.
Cosa conta views?
Sull'account, il numero di volte in cui il contenuto è stato riprodotto o mostrato, tra Reel, post e Storie; su un singolo post, Reel o Storia, il numero di volte in cui è stato riprodotto su Instagram. impressions contava le volte in cui il contenuto era sullo schermo, inserzioni comprese, quindi un grafico che passa dall'una all'altra cambia ciò che misura nel punto del passaggio. La metrica views a livello di account accetta solo metric_type=total_value e si suddivide per media_product_type, e Meta la indica ancora come in fase di sviluppo.
Quali metriche ha aggiunto Meta da allora?
Il changelog di Meta elenca queste aggiunte dopo i ritiri del 2025:
- 3 dicembre 2025:
reels_skip_ratee reposts sui media, reposts sull'account, ecrossposted_viewsefacebook_viewsper i Reel pubblicati in crosspost. - 22 aprile 2026:
total_likes,total_commentsetotal_views, aggregate su tutte le superfici e comprendenti i media promossi, che il riferimento di Meta offre solo con Facebook Login;facebook_viewsesteso anche a post e Storie. - 22 giugno 2026:
link_clickssulle Storie, che conta i tap sui link come gli adesivi link, e che il changelog limita a Facebook Login.
Cosa va cambiato nel codice?
Un elenco di metriche scritto prima del 2025 richiede queste modifiche per continuare a funzionare:
- Sostituisci impressions, plays,
clips_replays_count,ig_reels_aggregated_all_plays_countevideo_viewscon views, sia nelle richieste per account sia per i media. - Richiedi la metrica views a livello di account con
metric_type=total_value. Non hatime_series, quindi leggi un solo totale per intervallo dove impressions dava una linea giornaliera. - Chiedi
crossposted_viewsefacebook_viewssolo sui media pubblicati in crosspost, in una richiesta a sé: il riferimento di Meta dice che entrambe generano un errore se il media non era in crosspost. - Escludi
total_likes,total_commentsetotal_viewsdalle app Instagram Login, poiché Meta le offre solo con Facebook Login. - Sostituisci
phone_call_clicks,email_contacts,text_message_clickseget_direction_clicksconprofile_links_tapssuddiviso percontact_button_type. - Tratta un errore su un nome di metrica come un segnale per aggiornare l'elenco, non per riprovare.
Come arrivano le deprecazioni alle versioni più vecchie dell'API?
In due fasi. Una modifica si applica prima da una nuova versione della Graph API, v21.0 per video_views e v22.0 per impressions, e poi raggiunge tutte le versioni in una data indicata nella stessa voce del changelog, circa tre mesi dopo in entrambi i casi. Fissare una versione più vecchia guadagna al massimo qualche mese, e il changelog di Meta per Instagram Platform elenca entrambe le date per ogni modifica.
Quali ritiri precedenti colpiscono ancora il vecchio codice?
Due risalenti a prima del 2025 compaiono nel codice che non viene toccato da tempo:
- 11 dicembre 2023: le metriche di
carousel_album,taps_forward,taps_back, exits ed engagement sui media, eaudience_gender_age,audience_locale,audience_countryeaudience_citysull'account, dovefollower_demographicsora copre età, città, paese e genere. - 19 agosto 2024: i timeframe
last_14_days,last_30_days,last_90_dayseprev_monthperengaged_audience_demographicsereached_audience_demographics;this_weekethis_monthrestano.
Errori comuni
- Richiedere impressions per un post pubblicato dopo luglio 2024. Meta restituisce un errore per quel media; richiedi views.
- Chiedere le views dell'account come time_series. Meta le documenta solo con total_value, quindi leggi un totale per ogni intervallo che ti serve.
- Richiedere crossposted_views o facebook_views per media mai pubblicati in crosspost. Il riferimento di Meta dice che entrambe generano un errore in quel caso.
- Aspettarsi total_likes, total_comments o total_views con Instagram Login. Meta le rende disponibili solo con Facebook Login; likes, comments e views restano.
Da US$ 9 fino a US$ 0.75 per connessione al mese, con prezzo in calo man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.
Domande frequenti
Cosa ha sostituito phone_call_clicks e email_contacts nell'API di Instagram?
Meta non ha indicato un successore diretto quando sono terminate in tutte le versioni l'8 gennaio 2025. La metrica più vicina che il suo riferimento per account documenta oggi è profile_links_taps, suddivisa per contact_button_type.
Cosa ha sostituito le riproduzioni dei Reel di Instagram?
views. Meta ha deprecato plays, clips_replays_count e ig_reels_aggregated_all_plays_count in tutte le versioni dell'API il 21 aprile 2025, tre mesi dopo aver introdotto views.
Perché la mia chiamata agli insight di Instagram ha iniziato a fallire?
Controlla prima l'elenco delle metriche: impressions, plays, video_views e le vecchie metriche del profilo sono ritirate, e views dell'account accetta solo total_value. Riprovare la stessa richiesta restituisce lo stesso errore.
Meta ha ritirato metriche Instagram nel 2026?
Nessuna risulta nel changelog di Instagram di Meta fino al 28 ottobre 2026. Le sue voci del 2026 aggiungono invece metriche, tra cui total_views, un facebook_views più ampio e link_clicks sulle Storie.
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