Veraltete Instagram-API-Metriken: impressions und plays werden durch views ersetzt
Meta hat impressions in der Instagram-Insights-API durch views ersetzt. Die Metrik views kam am 21. Januar 2025 hinzu, und impressions, plays, clips_replays_count und ig_reels_aggregated_all_plays_count wurden am 21. April 2025 in jeder API-Version abgekündigt, nachdem video_views und sechs Kontometriken am 8. Januar ausgelaufen waren. Spätere Änderungen ergänzten Metriken, etwa reposts und reels_skip_rate im Dezember 2025.
easyCoexistence liest Instagram-Insights mit get_social_insights, das die Metriknamen, die Sie angeben, unverändert an Meta weitergibt, einschließlich views, und Metas eigene Daten zurückliefert oder Metas eigene Fehlermeldung, wenn ein Name eingestellt ist.
Wann impressions, plays, clips_replays_count und ig_reels_aggregated_all_plays_count in jeder API-Version abgekündigt wurden.
Wann Meta views für Account- und Media-Insights einführte und Insights für Instagram-Login-Apps öffnete.
Wann video_views und sechs Kontozeitreihen, darunter profile_views und website_clicks, in jeder Version den Support verloren.
Medien, die am oder nach diesem Datum erstellt wurden, liefern bei einer Anfrage nach impressions nach dem 21. April 2025 einen Fehler statt Daten.
Die einzige metric_type-Angabe für die kontoweite Metrik views; impressions bot außerdem eine tägliche time_series.
Welche Instagram-Metriken hat Meta 2025 eingestellt?
Zwei Runden, jeweils Monate im Voraus im Changelog von Meta angekündigt und zuerst ab einer neuen Graph-API-Version angewendet, dann auf jede Version:
- 8. Januar 2025:
video_viewsbei Medien und die Kontozeitreihenemail_contacts,get_direction_clicks,phone_call_clicks,profile_views,text_message_clicksundwebsite_clicks, zuerst in v21.0 entfernt. - 21. Januar 2025: impressions bei Account- und Media-Insights sowie plays,
clips_replays_countundig_reels_aggregated_all_plays_countbei Medien, für v22.0 und spätere abgekündigt, an dem Tag, an dem views eingeführt wurde. - 21. April 2025: diese vier in jeder API-Version abgekündigt.
Was soll jede eingestellte Metrik ersetzen?
Meta hat views im selben Changelog-Eintrag mit den Einstellungen vom April 2025 verknüpft. Für die Einstellungen im Januar nannte Meta keinen Nachfolger, deshalb nennt die rechte Spalte die nächstliegende Metrik, die die Account- und Media-Referenzen von Meta zum 31. Oktober 2026 dokumentierten.
| 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 |
Liefert impressions noch etwas zurück?
Nur für ältere Medien. Metas Changelog besagt, dass Anfragen nach dem 21. April 2025 für Medien, die am oder nach diesem Datum erstellt wurden, einen Fehler zurückgeben, und seine Referenz zu Media-Insights führt impressions nur für Medien, die vor diesem Datum erstellt wurden. Beim Account ist impressions in jeder Version abgekündigt, Code, der heute geschrieben wird, hat also keine Verwendung dafür.
Was zählt views?
Beim Account die Anzahl der Male, die Inhalte über Reels, Beiträge und Stories abgespielt oder angezeigt wurden; bei einem einzelnen Beitrag, Reel oder einer Story die Anzahl der Male, in denen er auf Instagram abgespielt wurde. impressions zählte, wie oft Inhalte auf dem Bildschirm waren, Anzeigen eingeschlossen, daher ändert eine Grafik, die von dem einen in das andere übergeht, beim Wechsel, was sie misst. Die kontoweite views-Metrik akzeptiert nur metric_type=total_value und schlüsselt nach media_product_type auf, und Meta kennzeichnet sie noch als in Entwicklung.
Welche Metriken hat Meta seitdem ergänzt?
Metas Changelog führt diese Ergänzungen nach den Einstellungen von 2025 auf:
- 3. Dezember 2025:
reels_skip_rateund reposts bei Medien, reposts beim Account sowiecrossposted_viewsundfacebook_viewsfür crossgepostete Reels. - 22. April 2026:
total_likes,total_commentsundtotal_views, über alle Oberflächen aggregiert und einschließlich beworbener Medien, die Metas Referenz nur mit Facebook Login anbietet;facebook_viewswurde außerdem auf Beiträge und Stories erweitert. - 22. Juni 2026:
link_clicksbei Stories, die Taps auf Links wie Link-Sticker zählen, die das Changelog auf Facebook Login beschränkt.
Was muss im Code geändert werden?
Eine vor 2025 geschriebene Metrikliste braucht diese Änderungen, damit sie weiter funktioniert:
- Ersetzen Sie impressions, plays,
clips_replays_count,ig_reels_aggregated_all_plays_countundvideo_viewsdurch views, sowohl in Account- als auch in Media-Anfragen. - Fordern Sie die kontoweite views-Metrik mit
metric_type=total_valuean. Sie hat keinetime_series, deshalb lesen Sie je Zeitraum eine Gesamtsumme, wo impressions früher eine tägliche Linie lieferte. - Fordern Sie
crossposted_viewsundfacebook_viewsnur bei crossgepostetem Media an, in einer eigenen Anfrage: Metas Referenz sagt, dass beide einen Fehler auslösen, wenn das Medium nicht crossgepostet wurde. - Lassen Sie
total_likes,total_commentsundtotal_viewsin Instagram-Login-Apps weg, da Meta sie nur mit Facebook Login anbietet. - Ersetzen Sie
phone_call_clicks,email_contacts,text_message_clicksundget_direction_clicksdurchprofile_links_taps, aufgeschlüsselt nachcontact_button_type. - Behandeln Sie einen Fehler bei einem Metriknamen als Hinweis, die Liste zu aktualisieren, nicht als Anlass, es erneut zu versuchen.
Wie erreichen Abkündigungen ältere API-Versionen?
In zwei Schritten. Eine Änderung gilt zuerst ab einer neuen Graph-API-Version, v21.0 für video_views und v22.0 für impressions, und erreicht dann jede Version an einem im selben Changelog-Eintrag genannten Datum, in beiden Fällen etwa drei Monate später. Das Festhalten an einer älteren Version verschafft höchstens ein paar Monate, und Metas Changelog der Instagram Platform nennt für jede Änderung beide Daten.
Welche früheren Einstellungen treffen noch alten Code?
Zwei aus der Zeit vor 2025 tauchen in Code auf, der seitdem nicht angefasst wurde:
- 11. Dezember 2023: die
carousel_album-Metriken,taps_forward,taps_back, exits und engagement bei Medien sowieaudience_gender_age,audience_locale,audience_countryundaudience_citybeim Account, wobeifollower_demographicsheute Alter, Stadt, Land und Geschlecht abdeckt. - 19. August 2024: die Zeiträume
last_14_days,last_30_days,last_90_daysundprev_monthfürengaged_audience_demographicsundreached_audience_demographics;this_weekundthis_monthbleiben bestehen.
Häufige Fehler
- Impressions für einen Beitrag anfordern, der seit Juli 2024 veröffentlicht wurde. Meta gibt für dieses Medium einen Fehler zurück; fordern Sie views an.
- Kontoviews als time_series anfordern. Meta dokumentiert sie nur mit total_value, also lesen Sie für jeden benötigten Zeitraum eine Summe.
- crossposted_views oder facebook_views für Medien anfordern, die nie crossgepostet wurden. Metas Referenz sagt, dass beide dann einen Fehler auslösen.
- Erwarten, dass total_likes, total_comments oder total_views mit Instagram Login funktionieren. Meta stellt sie nur mit Facebook Login bereit; likes, comments und views bleiben verfügbar.
So kann Claude, ChatGPT oder Ihr eigener Code eine Umbenennung am Tag nachvollziehen, an dem Meta sie vornimmt. Ab US$ 9 pro Verbindung und Monat, sinkend auf US$ 0.75 mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.
Häufig gestellte Fragen
Was hat phone_call_clicks und email_contacts in der Instagram-API ersetzt?
Meta nannte keinen direkten Nachfolger, als sie am 8. Januar 2025 in jeder Version endeten. Die nächstliegende Metrik, die die Account-Referenz heute dokumentiert, ist profile_links_taps, aufgeschlüsselt nach contact_button_type.
Was hat plays bei Instagram Reels ersetzt?
views. Meta hat plays, clips_replays_count und ig_reels_aggregated_all_plays_count am 21. April 2025 in jeder API-Version abgekündigt, drei Monate nach der Einführung von views.
Warum schlägt mein Aufruf der Instagram-Insights fehl?
Prüfen Sie zuerst die Metrikliste: impressions, plays, video_views und die alten Profilmetriken sind eingestellt, und Account-views akzeptiert nur total_value. Eine Wiederholung derselben Anfrage liefert denselben Fehler zurück.
Hat Meta 2026 Instagram-Metriken eingestellt?
In Metas Instagram-Changelog bis zum 28. Oktober 2026 erscheint keine. Die Einträge von 2026 ergänzen stattdessen Metriken, darunter total_views, ein erweitertes facebook_views und link_clicks bei Stories.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am