Neu: Graph API v25.0 und Marketing API v25.0

Im Folgenden findest du die Highlights der neuen Änderungen an GAPI/MAPI für Version 25. In unserem Änderungsprotokoll findest du eine vollständige Liste der Änderungen sowie der Details dazu.

Allgemeine Updates

Graph API: Kennzahl zu „Seitenaufrufe“

Bis Ende Juni 2026 möchten wir die Kennzahl „Seitenaufrufe“ in die Graph API integrieren. Die Kennzahl „Aufrufe“ soll die bisherige Kennzahl „Reach“ ersetzen und bietet eine plattformübergreifende Messung (Facebook und Instagram), wie viele Personen einen Inhalt gesehen haben. Entwickler*innen sollten nun mit der Planung der Umstellung auf Zuschauer*innen beginnen, um weiterhin Zugriff auf Zielgruppen-Insights zu haben.

Änderungen

Kennzahlen zu Aufrufe sind jetzt in den Insights für Seiten und Stories verfügbar

Beitrags-/Seiten-Insights

• GET {page-id}/insights/page_total_media_view_unique*
• GET {post-id}/insights/post_total_media_view_unique*

Story-Insights

• Eine neue Kennzahl wird hinzugefügt
• GET {stories-id}/insights/metric
  • PAGE_STORY_TOTAL_MEDIA_VIEW_UNIQUE

Die oben genannten Graph APIs sind nach dem Launch von V25 verfügbar. Wir empfehlen Entwickler*innen, das Änderungsprotokoll der Graph API auf die aktuellsten Informationen zu prüfen.

mTLS-Zertifikate für Webhooks

Ab dem 31. März 2026 beginnt Meta, mTLS-Zertifikate für Webhooks mit einer anderen Zertifizierungsstelle (Certificate Authority, CA) zu signieren, die Meta gehört.

Was bedeutet das für Entwickler*innen?

Wenn deine Server so konfiguriert sind, dass sie das mTLS-Zertifikat für Webhooks verlangen und verifizieren, musst du dem neuen Meta-CA vertrauen. Wenn du deinen Trust Store nicht bis zum genannten Datum aktualisierst, führt dies zu TLS-Handshake-Fehlern und deine Server empfangen keine Webhook-Events mehr.

Handlung erforderlich: Aktualisiere deinen Trust Store

Um weiterhin ohne Unterbrechung Webhooks empfangen zu können, musst du:

1. das Zertifikat der Stammzertifizierungsstelle von Meta herunterladen: Gehe zu Erste Schritte mit Webhooks und lade die Datei namens meta-outbound-api-ca-2025-12.pem herunter.
   Die Stammzertifizierungsstelle signiert das Leaf Certificate, das dann in Webhooks-Anfragen angezeigt wird.
2. es zu deinem Trust Store hinzufügen: Füge dieses Zertifikat zum Trust Store aller Server hinzu, die Webhooks empfangen.
3. das aktuelle Zertifikat beibehalten: Du solltest das neue Zertifikat zu deinem Trust Store hinzufügen, während das aktuelle noch aktiv ist.

Wichtig: Warte nicht bis zum Ende der Frist. Du solltest das neue Zertifikat sofort zu deinem Trust Store hinzufügen, um am 31. März einen reibungslosen Übergang zu gewährleisten.

Frist: vor dem 31. März 2026.

Warum diese Änderung

Das aktuelle mTLS-Zertifikat für Webhooks wird von der Stammzertifizierungsstelle DigiCert signiert. Da DigiCert den Einsatz der Client-Authentfizierungs-EKU einstellt, kann das Zertifikat nach seinem Ablauf am 15. April 2025 nicht mehr durch diese Stammzertifizierungsstelle verlängert werden.

Folglich wird das neue mTLS-Zertifikat für Webhooks durch eine interne Meta-Stammzertifizierungsstelle signiert. Es behält denselben gängstigen Namen (client.webhooks.fbclientcerts.com) des aktuellen Zertifikat bei.

Die öffentliche Dokumentation zu Webhooks mTLS wurde um einen Hinweis zu dieser Änderung ergänzt. Die technischen Details in der Dokumentation werden im April 2026 nach Abschluss der Umstellung dauerhaft aktualisiert.

Einstellungen und funktionsgefährdende Änderungen

Verbesserte Fehlermeldungen für die Ads Insights Async API

Wir arbeiten kontinuierlich daran, die Erfahrung für Entwickler*innen mit unseren APIs zu verbessern. Um für mehr Transparenz zu sorgen und Entwickler*innen zu helfen, robustere Apps zu erstellen, verbessern wir die Fehlerberichte für den GET {AD_REPORT_RUN_ID}-Endpunkt der Ads Insights Async API.

Mit der nächsten Graph API-Version 25.0, die am 18. Februar 2026 veröffentlicht wird, erhalten Entwickler*innen Zugriff auf detaillierte Fehlerinformationen, wenn ein asynchroner Bericht fehlschlägt. So können Fehler leichter diagnostiziert und API-Integrationen effizienter gestaltet werden. Für alle Entwickler*innen, die derzeit Zugriff auf das Feld error_code haben, wird der Typ von uint zu int geändert.

Änderungen

Wir führen die folgenden neuen Standardfelder in der Antwort des Ads Insights Async API GET {AD_REPORT_RUN_ID}-Endpunkts für alle Apps ein:

• error_code: Der Fehlercode. Hinweis: Das Feld wird für alle Entwickler*innen, die derzeit Zugriff darauf haben, von uint zu int geändert.
• error_message: Eine Nachricht, die dem error_code entspricht.
• error_subcode: Der spezifische Untercode für den Fehler.
• error_user_title: Eine nutzungsfreundliche Bezeichnung für den Fehler-Untercode.
• error_user_msg: Eine nutzungsfreundliche Nachricht, die den Fehler-Untercode enthält.

Diese Felder werden ausgefüllt, wenn ein Berichtsaufruf fehlschlägt. Wir empfehlen dir, deine API-Integration zu überprüfen, um sicherzustellen, dass sie mit den neuen Standardfeldern in der Antwort kompatibel ist.

Dieses Update wird voraussichtlich mit der nächsten Graph API-Version eingeführt. Wir empfehlen Entwickler*innen, die aktuellsten Informationen im Graph API-Änderungsprotokoll zu überprüfen. Die Entwicklerdokumentation wurde ebenfalls entsprechend aktualisiert.

Graph API: Parameter für Metadaten-Abfrage wurde eingestellt

Ab Graph API v25 ist der metadata=1-Abfrageparameter eingestellt. Dieser Parameter wurde bisher verwendet, um Metadaten zu den Feldern und Verbindungen eines Nodes in API-Antworten zurückzugeben. Diese Funktion wird selten genutzt und wird eingestellt, um die Plattform zu vereinfachen. Nach der Einstellung wird der Parameter metadata in API-Anfragen ignoriert.

Entwickler*innen, die sich derzeit auf „metadata=1“ verlassen, sollten auf die Verwendung unserer offiziellen API-Dokumentation umsteigen, um die verfügbaren Felder und Verbindungen für jeden Node-Typ zu entdecken.

Änderungen

Vorher (v24 und älter):

Durch das Hinzufügen von ?metadata=1 zu einer Graph API-Anfrage wurden zusätzliche Metadaten über den Node zurückgegeben, einschließlich verfügbarer Felder und Verbindungen.

Nachher (v25+):

Der Parameter metadata=1 wird ignoriert. Anfragen mit diesem Parameter geben weiterhin Standardantworten ohne Metadaten zurück. Es gibt keine Fehler oder funktionsgefährdenden Änderungen – deine Anfragen führen nicht zu Fehlern oder Unterbrechungen, wenn sie „metadata=1“ enthalten; der Parameter hat einfach keine Auswirkung.

Graph API: Einstellung der Kennzahlen „Seitenreichweite“ und „-impressionen“

Im Juni 2026 planen wir, die Kennzahlen „Beitrags-/Seitenreichweite“, „Videoimpressionen“ und „Story-Impressionen“ in der Graph API einzustellen. Diese veralteten Kennzahlen werden in unseren Insights-Tools nicht mehr angezeigt, waren aber bisher noch über APIs verfügbar.

Um unsere Produkte und APIs auf ein einziges, konsistentes Kennzahlen-Framework auszurichten und die allgemeine Zuverlässigkeit des Systems zu verbessern, entfernen wir diese veralteten Kennzahlen. Nach der Einstellung sollten Entwickler*innen auf die neuen Kennzahlen „Media View“ und „Media Viewers“ umstellen, die die bisherigen Kennzahlen für Impression, Reichweite und Videoaufrufe ersetzen.

Änderungen

Die folgenden Kennzahlen werden ab Juni 2026 für alle API-Versionen eingestellt. Wir empfehlen Entwickler*innen, die aktuellsten Informationen im Graph API-Änderungsprotokoll zu überprüfen:

Beitrags-/Seitenreichweite

• GET {page-id}/insights/page_impressions_unique*
• GET {page-id}/insights/page_impressions_paid_unique*
• GET {page-id}/insights/page_impressions_viral_unique*
• GET {page-id}/insights/page_impressions_nonviral_unique*
• GET {page-id}/insights/page_posts_impressions*
• GET {page-id}/insights/page_posts_impressions_unique*
• GET {page-id}/insights/page_posts_impressions_paid*
• GET {page-id}/insights/page_posts_impressions_paid_unique*
• GET {page-id}/insights/page_posts_impressions_organic_unique*
• GET {page-id}/insights/page_posts_served_impressions_organic_unique*
• GET {page-id}/insights/page_posts_impressions_viral*
• GET {page-id}/insights/page_posts_impressions_viral_unique*
• GET {page-id}/insights/page_posts_impressions_nonviral*
• GET {page-id}/insights/page_posts_impressions_nonviral_unique*
• GET {post-id}/insights/post_impressions_unique*
• GET {post-id}/insights/post_impressions_paid_unique*
• GET {post-id}/insights/post_impressions_fan_unique*
• GET {post-id}/insights/post_impressions_organic_unique*
• GET {post-id}/insights/post_impressions_viral_unique*
• GET {post-id}/insights/post_impressions_nonviral_unique*
• GET {post-id}/insights/post_impressions_nonviral_unique*

Video-Impressionen

• GET {video-id}/video_insights/post_impressions_unique
• GET {video-id}/video_insights/total_video_impressions
• GET {video-id}/video_insights/total_video_impressions_unique
• GET {video-id}/video_insights/total_video_impressions_paid_unique
• GET {video-id}/video_insights/total_video_impressions_paid
• GET {video-id}/video_insights/total_video_impressions_organic_unique
• GET {video-id}/video_insights/total_video_impressions_organic
• GET {video-id}/video_insights/total_video_impressions_viral_unique
• GET {video-id}/video_insights/total_video_impressions_viral
• GET {video-id}/video_insights/total_video_impressions_fan_unique
• GET {video-id}/video_insights/total_video_impressions_fan
• GET {video-id}/video_insights/total_video_impressions_fan_paid_unique
• GET {video-id}/video_insights/total_video_impressions_fan_paid

Story-Impressionen

• Zwei Kennzahlen werden ersetzt
• GET {stories-id}/insights/metric
  • PAGE_STORY_IMPRESSIONS_BY_STORY_ID
  • PAGE_STORY_IMPRESSIONS_BY_STORY_ID_UNIQUE

Wir empfehlen stattdessen die folgenden Kennzahlen:

• GET {page-id}/insights/page_total_media_view_unique
• GET {post-id}/insights/post_total_media_view_unique

Für Aufschlüsselungen zwischen bezahlter und organischer Reichweite empfehlen wir die Verwendung der folgenden Kennzahlen, die im Wesentlichen ähnliche Erkenntnisse liefern:

• GET {page-id}/insights/page_media_view
• GET {post-id}/insights/post_media_view

Graph API: Einstellung der Kennzahl „3-sekündige Aufrufe“

Im Juni 2026 planen wir die Einstellung der Kennzahlen für 3-sekündige Aufrufe. Diese veralteten Kennzahlen werden in unseren Insights-Tools nicht mehr angezeigt, waren aber bisher noch über die Graph API verfügbar.

Um unsere Produkte und APIs auf ein einziges, konsistentes Kennzahlen-Framework auszurichten und die allgemeine Zuverlässigkeit des Systems zu verbessern, entfernen wir diese veralteten Kennzahlen. Nach der Einstellung sollten Entwickler*innen auf die neuen Kennzahlen „Media View“ und „Media Viewers“ umstellen, die die bisherigen Kennzahlen für Impression, Reichweite und Videoaufrufe ersetzen.

Änderungen

Die folgenden Kennzahlen werden ab Juni 2026 für alle API-Versionen eingestellt. Wir empfehlen Entwickler*innen, die aktuellsten Informationen im Graph API-Änderungsprotokoll zu überprüfen:

• GET {page-id}/insights/page_video_views_unique
• GET {post-id}/insights/post_video_views_organic_unique
• GET {post-id}/insights/post_video_views_paid_unique
• GET {post-id}/insights/post_video_views_unique
• GET {video-id}/video_insights/total_video_views_organic_unique
• GET {video-id}/video_insights/total_video_views_paid_unique
• GET {video-id}/video_insights/total_video_views_unique

Wir empfehlen stattdessen die folgenden Kennzahlen:

• GET {page-id}/insights/page_total_media_view_unique
• GET {post-id}/insights/post_total_media_view_unique

Für die Aufschlüsselung zwischen bezahlten und organischen 3-sekündigen Aufrufe empfehlen wir die Verwendung der folgenden Kennzahlen, die im Wesentlichen ähnliche Insights liefern:

• GET {page-id}/insights/page_media_view
• GET {post-id}/insights/post_media_view

Marketing API: Einstellung von ASC und AAC

Die zusammengeführte Automatisierung sorgt dafür, dass App-, Umsatz- und Lead-Kampagnen standardmäßig mit dem optimalen, automatisierungsbasierten Advantage+-Setup eingerichtet werden. Sie ermöglicht es Werbetreibenden und Partnern, leichter auf die neuesten und leistungsstärksten Automatisierungsprodukte von Meta zuzugreifen. Wir führen eine gestaffelte Einstellung der bisherigen APIs und eine Migration zur neuen Einheitlichen Automatisierung durch, Advantage+ Einstellung für Marketing API-Entwickler*innen.

Ab Version 25.0 (18. Februar 2026) können Advantage+-Shopping-Kampagnen und Advantage+-App-Kampagnen nicht mehr über die Marketing API erstellt oder aktualisiert werden. Nach 90 Tagen (bis zum 19. Mai 2026) wird dies auf alle MAPI-Versionen ausgeweitet.

Mit Version 26.0 (voraussichtlich September 2026) werden alle verbleibenden Advantage+-Shopping-Kampagnen und Advantage-Kampagnen für App Ads angehalten.

Advantage+-Shopping-Kampagnen oder Advantage+-App-Kampagnen, die Budgetgrenzwerte für Bestandskundschaft (ECBC) verwenden, können bis Version 26.0 bearbeitet werden. Bei Advantage+-Kampagnen ist diese Funktion nicht verfügbar. Entwickler*innen mit einer ECBC-Kampagne sollten eine der folgenden Methoden nutzen, um ECBC-Kampagnen vor V26.0 zu reproduzieren:

• Manuelle Duplizierung: Öffne eine bestehende ASC-/AAC-Kampagne mit ECBC im Werbeanzeigenmanager. Du wirst aufgefordert, die Kampagne zu duplizieren. Mit diesem Schritt wird durch 1 Klick eine neue Kampagne erstellt, die die Einrichtung der bestehenden Kampagne nachahmt.
• Bilde ECBC-Kampagnen mit der API nach. Nutze dazu die Anleitung in der Entwicklungsdokumentation zur Nachbildung der Kampagnen mit der API, die du hier findest.
• Beantrage die Bulk-Migration auf Werbekontoebene. Für Managed Partner ist es möglich, alle ECBC-Kampagnen an einem vereinbarten Datum auf einmal zu migrieren. Wende dich bitte an deine Kontaktperson bei Meta und gib die Konto-IDs sowie das bevorzugte Migrationsdatum an.

Hinweis: Beachte, dass bei einer Duplizierung einer ECBC-Kampagne eine neue Kampagnen-ID vergeben wird.

Diese Änderung betrifft die folgenden Endpunkte:

• POST /{campaign-id}
• POST /{campaign-id}/copies

In der aktualisierten Entwicklerdokumentation und den FAQs findest du weitere Informationen zu dieser Änderung.

Link zur Entwicklungsdokumentation

• Entwicklerdokumentation – Advantage+-Kampagnenerlebnis für Umsatz, Apps und Leads

Link zum Hilfeartikel zur Funktion

• Hilfebereich – Advantage+-Kampagnen
• Hilfebereich – Spezielle Anzeigenkategorien

Eingestellte API-Versionen:

Beachte bitte die folgenden bevorstehenden Einstellungen, die Teil des Versionierungszeitplans von Facebook für die Graph API und Marketing API sind:

Graph API

• 21. Mai 2026: Graph API v19 wird eingestellt und von der Plattform entfernt.
• 24. September 2026: Graph API v20 wird eingestellt und von der Plattform entfernt.

Um Unterbrechungen des Geschäftsbetriebs zu vermeiden, empfehlen wir die Migration aller Aufrufe auf die neuste Version der API, die heute veröffentlicht wurde.