AccediInizia la prova gratuita
easyCoexistence API ufficiali

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.

21 Apr 2025

Quando impressions, plays, clips_replays_count e ig_reels_aggregated_all_plays_count sono stati deprecati in tutte le versioni dell'API.

21 Jan 2025

Quando Meta ha introdotto views per gli insight di account e media, e ha aperto gli insight alle app Instagram Login.

8 Jan 2025

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.

2 Jul 2024

I media creati il o dopo questa data restituiscono un errore, non dati, se si richiede impressions dopo il 21 aprile 2025.

total_value

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_views sui media e le serie temporali dell'account email_contacts, get_direction_clicks, phone_call_clicks, profile_views, text_message_clicks e website_clicks, eliminate per primo nella v21.0.
  • 21 gennaio 2025: impressions su insight di account e media, e plays, clips_replays_count e ig_reels_aggregated_all_plays_count sui 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.

RetiredRequest instead
impressionsAccount and media, 21 Apr 2025views
playsMedia, 21 Apr 2025views
clips_replays_countMedia, 21 Apr 2025views
ig_reels_aggregated_all_plays_countMedia, 21 Apr 2025views
video_viewsMedia, 8 Jan 2025views
phone_call_clicks, email_contacts, text_message_clicks, get_direction_clicksAccount, 8 Jan 2025profile_links_taps, by contact_button_type
profile_viewsAccount, 8 Jan 2025profile_visits, per post or Story
website_clicksAccount, 8 Jan 2025profile_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_rate e reposts sui media, reposts sull'account, e crossposted_views e facebook_views per i Reel pubblicati in crosspost.
  • 22 aprile 2026: total_likes, total_comments e total_views, aggregate su tutte le superfici e comprendenti i media promossi, che il riferimento di Meta offre solo con Facebook Login; facebook_views esteso anche a post e Storie.
  • 22 giugno 2026: link_clicks sulle 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_count e video_views con views, sia nelle richieste per account sia per i media.
  • Richiedi la metrica views a livello di account con metric_type=total_value. Non ha time_series, quindi leggi un solo totale per intervallo dove impressions dava una linea giornaliera.
  • Chiedi crossposted_views e facebook_views solo 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_comments e total_views dalle app Instagram Login, poiché Meta le offre solo con Facebook Login.
  • Sostituisci phone_call_clicks, email_contacts, text_message_clicks e get_direction_clicks con profile_links_taps suddiviso per contact_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, e audience_gender_age, audience_locale, audience_country e audience_city sull'account, dove follower_demographics ora copre età, città, paese e genere.
  • 19 agosto 2024: i timeframe last_14_days, last_30_days, last_90_days e prev_month per engaged_audience_demographics e reached_audience_demographics; this_week e this_month restano.

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.
Farlo con EasyCoexistence

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