Verouderde Instagram API-metrics: impressions en plays vervangen door views
Meta verving impressions door views in de insights-API van Instagram. Views werd op 21 januari 2025 ingevoerd, en impressions, plays, clips_replays_count en ig_reels_aggregated_all_plays_count werden op 21 april 2025 in elke API-versie uitgefaseerd, nadat video_views en zes accountmetrics op 8 januari waren gestopt. Latere wijzigingen voegden metrics toe, zoals reposts en reels_skip_rate in december 2025.
easyCoexistence leest Instagram-insights met get_social_insights, dat de metricnamen die je geeft rechtstreeks aan Meta doorgeeft, views inbegrepen, en Meta's eigen data teruggeeft, of Meta's eigen foutmelding wanneer een naam is uitgefaseerd, zodat Claude, ChatGPT of je eigen code een hernoeming volgt op de dag dat Meta die doorvoert.
Wanneer impressions, plays, clips_replays_count en ig_reels_aggregated_all_plays_count in elke API-versie werden uitgefaseerd.
Wanneer Meta views voor account- en mediainsights invoerde, en insights openstelde voor apps met Instagram Login.
Wanneer video_views en zes accounttijdreeksen, waaronder profile_views en website_clicks, in elke versie hun ondersteuning verloren.
Media die op of na deze datum is aangemaakt, geeft een fout in plaats van data terug wanneer impressions na 21 april 2025 wordt aangevraagd.
De enige metric_type die de accountbrede views-metric accepteert; impressions bood ook een dagelijkse time_series aan.
Welke Instagram-metrics heeft Meta in 2025 uitgefaseerd?
Twee rondes, elk maanden van tevoren aangekondigd in Meta's changelog en eerst toegepast vanaf een nieuwe Graph API-versie, daarna in elke versie:
- 8 januari 2025:
video_viewsop media en de accounttijdreeksenemail_contacts,get_direction_clicks,phone_call_clicks,profile_views,text_message_clicksenwebsite_clicks, eerst weggehaald uit v21.0. - 21 januari 2025: impressions op account- en mediainsights, en plays,
clips_replays_countenig_reels_aggregated_all_plays_countop media, uitgefaseerd voor v22.0 en later, op de dag dat views verscheen. - 21 april 2025: die vier uitgefaseerd in elke API-versie.
Wat moet elke uitgefaseerde metric worden?
Meta koppelde views aan de uitfaseringen van april 2025 in hetzelfde changelog-item. Voor de januari-metrics noemde het geen opvolger, dus de rechterkolom geeft de dichtstbijzijnde metric die de account- en mediareferenties per 31 oktober 2026 documenteerden.
| 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 |
Levert impressions nog iets op?
Alleen voor oudere media. Meta's changelog zegt dat verzoeken na 21 april 2025 voor media die op of na 2 juli 2024 zijn aangemaakt een fout teruggeven, en de referentie voor mediainsights houdt impressions alleen voor media van voor die datum. Op het account is impressions in elke versie uitgefaseerd, dus code die je vandaag schrijft heeft er geen zin aan.
Wat telt views?
Op het account het aantal keren dat de content is afgespeeld of getoond, over Reels, posts en Stories heen; op één post, Reel of Story het aantal keren dat het op Instagram is afgespeeld. impressions telde de keren dat content in beeld was, advertenties inbegrepen, dus een grafiek die van de ene naar de andere loopt, verandert bij de overstap wat hij meet. Accountbrede views accepteert alleen metric_type=total_value en splitst op media_product_type, en Meta labelt het nog als in ontwikkeling.
Welke metrics heeft Meta sindsdien toegevoegd?
De changelog van Meta somt deze toevoegingen op na de uitfaseringen van 2025:
- 3 december 2025:
reels_skip_rateen reposts op media, reposts op het account, encrossposted_viewsenfacebook_viewsvoor gecrosspost Reels. - 22 april 2026:
total_likes,total_commentsentotal_views, geaggregeerd over alle oppervlakken en inclusief gesponsorde media, die Meta's referentie alleen met Facebook Login aanbiedt;facebook_viewsook uitgebreid naar posts en Stories. - 22 juni 2026:
link_clicksop Stories, die tikken op links telt, zoals linkstickers, wat de changelog beperkt tot Facebook Login.
Wat moet er in de code veranderen?
Een metriclijst die vóór 2025 is geschreven, heeft deze wijzigingen nodig om te blijven werken:
- Vervang impressions, plays,
clips_replays_count,ig_reels_aggregated_all_plays_countenvideo_viewsdoor views, in verzoeken voor account en media gelijk. - Vraag accountbrede views aan met
metric_type=total_value. Het heeft geentime_series, dus lees één totaal per periode waar impressions vroeger een dagelijkse lijn gaf. - Vraag
crossposted_viewsenfacebook_viewsalleen op gecrosspost media, in een eigen verzoek: Meta's referentie zegt dat beide een fout geven wanneer het media niet gecrosspost was. - Laat
total_likes,total_commentsentotal_viewsweg uit apps met Instagram Login, want Meta biedt ze alleen aan met Facebook Login. - Vervang
phone_call_clicks,email_contacts,text_message_clicksenget_direction_clicksdoorprofile_links_taps, uitgesplitst opcontact_button_type. - Behandel een fout op een metricnaam als een signaal om de lijst bij te werken, niet om opnieuw te proberen.
Hoe bereiken uitfaseringen oudere API-versies?
In twee stappen. Een wijziging geldt eerst vanaf een nieuwe Graph API-versie, v21.0 voor video_views en v22.0 voor impressions, en bereikt daarna elke versie op een datum die in hetzelfde changelog-item staat, in beide gevallen ongeveer drie maanden later. Vastzetten op een oudere versie koopt hooguit een paar maanden, en Meta's Instagram Platform-changelog vermeldt voor elke wijziging beide data.
Welke eerdere uitfaseringen raken nog oude code?
Twee van vóór 2025 duiken op in code die sinds niemand meer heeft aangeraakt:
- 11 december 2023: de
carousel_album-metrics,taps_forward,taps_back, exits en engagement op media, enaudience_gender_age,audience_locale,audience_countryenaudience_cityop het account, waarfollower_demographicsnu leeftijd, stad, land en geslacht dekt. - 19 augustus 2024: de tijdsbereiken
last_14_days,last_30_days,last_90_daysenprev_monthvoorengaged_audience_demographicsenreached_audience_demographics;this_weekenthis_monthblijven.
Veelgemaakte fouten
- Impressions aanvragen voor een post die sinds juli 2024 is geplaatst. Meta geeft voor die media een fout terug; vraag views aan.
- Accountviews als time_series opvragen. Meta documenteert het alleen met total_value, dus lees een totaal per periode die je nodig hebt.
- crossposted_views of facebook_views aanvragen voor media die nooit gecrosspost is. Meta's referentie zegt dat beide in dat geval een fout geven.
- total_likes, total_comments of total_views verwachten bij Instagram Login. Meta maakt ze alleen beschikbaar met Facebook Login; likes, comments en views blijven.
US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Wat verving phone_call_clicks en email_contacts in de Instagram API?
Meta noemde geen directe opvolger toen ze op 8 januari 2025 in elke versie stopten. De dichtstbijzijnde metric die zijn accountreferentie nu documenteert is profile_links_taps, uitgesplitst op contact_button_type.
Wat verving plays op Instagram Reels?
views. Meta faseerde plays, clips_replays_count en ig_reels_aggregated_all_plays_count in elke API-versie uit op 21 april 2025, drie maanden nadat views was ingevoerd.
Waarom begon mijn Instagram insights-aanroep te falen?
Controleer eerst de metriclijst: impressions, plays, video_views en de oude profielmetrics zijn uitgefaseerd, en accountviews accepteert alleen total_value. Hetzelfde verzoek opnieuw proberen geeft dezelfde fout.
Heeft Meta in 2026 Instagram-metrics uitgefaseerd?
Geen enkele verschijnt in Meta's Instagram-changelog tot en met 28 oktober 2026. De items van 2026 voegen daar juist metrics aan toe, waaronder total_views, een bredere facebook_views en link_clicks op Stories.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op