AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

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.

21 Apr 2025

Wann impressions, plays, clips_replays_count und ig_reels_aggregated_all_plays_count in jeder API-Version abgekündigt wurden.

21 Jan 2025

Wann Meta views für Account- und Media-Insights einführte und Insights für Instagram-Login-Apps öffnete.

8 Jan 2025

Wann video_views und sechs Kontozeitreihen, darunter profile_views und website_clicks, in jeder Version den Support verloren.

2 Jul 2024

Medien, die am oder nach diesem Datum erstellt wurden, liefern bei einer Anfrage nach impressions nach dem 21. April 2025 einen Fehler statt Daten.

total_value

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_views bei Medien und die Kontozeitreihen email_contacts, get_direction_clicks, phone_call_clicks, profile_views, text_message_clicks und website_clicks, zuerst in v21.0 entfernt.
  • 21. Januar 2025: impressions bei Account- und Media-Insights sowie plays, clips_replays_count und ig_reels_aggregated_all_plays_count bei 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.

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

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_rate und reposts bei Medien, reposts beim Account sowie crossposted_views und facebook_views für crossgepostete Reels.
  • 22. April 2026: total_likes, total_comments und total_views, über alle Oberflächen aggregiert und einschließlich beworbener Medien, die Metas Referenz nur mit Facebook Login anbietet; facebook_views wurde außerdem auf Beiträge und Stories erweitert.
  • 22. Juni 2026: link_clicks bei 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_count und video_views durch views, sowohl in Account- als auch in Media-Anfragen.
  • Fordern Sie die kontoweite views-Metrik mit metric_type=total_value an. Sie hat keine time_series, deshalb lesen Sie je Zeitraum eine Gesamtsumme, wo impressions früher eine tägliche Linie lieferte.
  • Fordern Sie crossposted_views und facebook_views nur 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_comments und total_views in Instagram-Login-Apps weg, da Meta sie nur mit Facebook Login anbietet.
  • Ersetzen Sie phone_call_clicks, email_contacts, text_message_clicks und get_direction_clicks durch profile_links_taps, aufgeschlüsselt nach contact_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 sowie audience_gender_age, audience_locale, audience_country und audience_city beim Account, wobei follower_demographics heute Alter, Stadt, Land und Geschlecht abdeckt.
  • 19. August 2024: die Zeiträume last_14_days, last_30_days, last_90_days und prev_month für engaged_audience_demographics und reached_audience_demographics; this_week und this_month bleiben 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.
Mit EasyCoexistence

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