Facebook API Fehler: „OAuthException: (#100) The value must be a valid insights metric“ bei post_impressions und post_impressions_unique

Meta API

4 Minuten

Michael Homeister

Michael Homeister

Lead Developer

Bekommst Du beim Abrufen Deiner Facebook- oder Meta-Insights plötzlich die Fehlermeldung:

OAuthException: (#100) The value must be a valid insights metric

und verwendest dabei die Kennzahlen post_impressions oder post_impressions_unique? Dann liegt das nicht an einem Fehler in Deinem Code oder an fehlenden Berechtigungen. Meta hat diese Kennzahlen im Rahmen einer Überarbeitung der Facebook Pages Insights API eingestellt.

Quickfix: Ersetze post_impressions oder post_impressions_unique durch post_total_media_view_unique

Seit den API-Änderungen im Jahr 2025 werden zahlreiche Reichweiten- und Impression-Metriken nicht mehr unterstützt. Anwendungen, WordPress-Plugins, CRM-Systeme und individuelle Integrationen müssen deshalb auf die neuen Kennzahlen umgestellt werden.

In diesem Beitrag erfährst Du:

  • warum der Fehler auftritt,
  • welche Kennzahlen eingestellt wurden,
  • welche Alternativen Meta empfiehlt und
  • wie Du Deine API-Abfragen anpassen kannst.

Warum erscheint der Fehler „The value must be a valid insights metric“?

Die Fehlermeldung

OAuthException: (#100) The value must be a valid insights metric

tritt auf, wenn Deine API-Abfrage eine Kennzahl verwendet, die von Meta nicht mehr unterstützt wird.

Besonders häufig betroffen sind die folgenden Metriken:

post_impressions
post_impressions_unique

Diese Kennzahlen wurden von Meta entfernt und liefern seit der Einstellung keine Daten mehr.

Änderungen zum 15. Juni 2025

Am 15. Juni 2025 wurden zahlreiche Reichweiten- und Impression-Kennzahlen endgültig entfernt. Die API liefert bei deren Verwendung lediglich eine oAuth Exception zurück.

Entfernte Seiten-Metriken

  • page_impressions_unique
  • page_impressions_paid_unique
  • page_impressions_viral_unique
  • page_impressions_nonviral_unique

Neue Alternative:

page_total_media_view_unique

Entfernte Beitrags-Metriken

  • page_posts_impressions
  • page_posts_impressions_unique
  • page_posts_impressions_paid
  • page_posts_impressions_paid_unique
  • page_posts_impressions_organic_unique
  • page_posts_served_impressions_organic_unique
  • page_posts_impressions_viral
  • page_posts_impressions_viral_unique
  • page_posts_impressions_nonviral
  • page_posts_impressions_nonviral_unique

Entfernte Post-Metriken

  • post_impressions_unique
  • post_impressions_paid_unique
  • post_impressions_fan_unique
  • post_impressions_organic_unique
  • post_impressions_viral_unique
  • post_impressions_nonviral_unique

Neue Alternative:

post_total_media_view_unique

Änderungen zum 15. November 2025

Die zweite große Bereinigung erfolgte am 15. November 2025. Besonders betroffen sind Fan- und Impression-Kennzahlen.

Fans werden zu Follows

Meta ersetzt den Begriff Fans zunehmend durch Follows.

Veraltete Kennzahl Neue Kennzahl
page_fans page_follows
page_fans_city page_follows_city
page_fans_country page_follows_country

Seiten-Impressions werden durch Media Views ersetzt

Veraltete Kennzahl Neue Lösung
page_impressions page_media_view
page_impressions_paid page_media_view mit is_from_ads-Breakdown

Post-Impressions werden ersetzt

Veraltete Kennzahl Neue Lösung
post_impressions post_media_view
post_impressions_paid post_media_view mit is_from_ads-Breakdown
post_impressions_fan post_media_view mit is_from_followers-Breakdown
post_impressions_organic post_media_view mit is_from_ads-Breakdown

Was bedeutet das für Dich?

Wenn Deine Anwendung, Dein Dashboard oder Dein Reporting-System noch auf die alten Metriken zugreift, solltest Du zeitnah handeln.

  • Eigene API-Abfragen prüfen
  • Automatisierte Reportings kontrollieren
  • BI-Tools und Dashboards aktualisieren
  • WordPress-Plugins überprüfen
  • CRM- und ERP-Integrationen anpassen
  • Individuell entwickelte Schnittstellen aktualisieren

So behebst Du den Fehler

Wenn Du bisher Folgendes verwendet hast:

metric=post_impressions

oder

metric=post_impressions_unique

musst Du Deine Anwendung auf die neuen Kennzahlen umstellen.

Beispiel

Alt:

metric=post_impressions

Neu:

metric=post_media_view

Alt:

metric=post_impressions_unique

Neu:

metric=post_total_media_view_unique

Fazit

Der Fehler

OAuthException: (#100) The value must be a valid insights metric

bei post_impressions oder post_impressions_unique ist die direkte Folge der Änderungen an der Facebook Pages Insights API.

Meta hat zahlreiche Impression-Kennzahlen eingestellt und durch neue Media-View-Metriken ersetzt. Wenn Du die alten Kennzahlen weiterhin verwendest, erhältst Du zwangsläufig einen API-Fehler.

Überprüfe deshalb Deine API-Abfragen und stelle sie auf die neuen Metriken um, damit Deine Facebook-Integrationen, Dashboards und Reportings weiterhin zuverlässig funktionieren.

Quellen