Zurück zu den Neuigkeiten für Entwickler

Neu: Facebook Graph API v17.0 und Marketing API v17.0

23. Mai 2023VonAyyad Farah

Heute führen wir die Facebook Graph API v17.0 und die Marketing API v17.0 ein. Weiter unten erläutern wir daher einige Änderungen, die für Teile unserer Entwicklungs-Community relevant sind. Zu diesen Änderungen zählen Ankündigungen, Produkt-Updates und Benachrichtigungen zu Einstellungen, die unserer Ansicht nach die Integration deiner Anwendung(en) mit unserer Plattform betreffen.

Eine vollständige Liste aller Änderungen mit zugehörigen Details findest du in unserem Änderungsprotokoll.

Einstellungen und funktionsgefährdende Änderungen

Einstellung von Ad Strategies

Das Beta-Produkt „Ad Strategies“ wurde am 28. Oktober 2022 eingestellt. Daher stellen wir mit der Veröffentlichung der Marketing API v17.0 die Felder ad_strategy_id und ad_strategy_group_id am Kampagnenendpunkt ein.

Einstellung der Offline Conversions API

Seit Februar 2023 unterstützt die Conversions API Offline-Events vollständig und stellt somit die vom aktuellen Offline Conversions API-Endpunkt bereitgestellten Paritätsfunktionen sicher. Durch die Konsolidierung unserer Web- und Offline-Event-APIs in einer einzigen API erwarten wir, dass für Werbetreibende die Nutzungsweise von kanalübergreifenden Marketingdaten zum Zweck der Verbesserung der Anzeigenoptimierung, der Custom Audiences und der Messungen vereinfacht und optimiert wird.

Ab Version 17 der Graph API, veröffentlicht am 23. Mai 2023, unterstützt die Offline Conversions API keine Offline-Events mehr. Wir empfehlen, dass Werbetreibende mit Offline Conversions API-Integrationen ihre Integration in eine Conversions API-Integration umwandeln und ihre Offline Conversions API erst zu aktualisieren, wenn sie dies erfolgreich durchgeführt haben.

Einstellung der Legacy-Zielerstellung

Wie im Dezember 2021 angekündigt, haben wir die Auswahl des Ziels beim Erstellen neuer Kampagnen neu gestaltet, sodass Werbetreibende effektiv zu Kampagneneinrichtungen geleitet werden, die sie dabei unterstützen, ihre Marketing-Ziele besser zu erreichen. Die neuen ergebnisorientierten Werbeerlebnisse führten zu Änderungen an der Marketing API.

Wir beginnen mit der Veröffentlichung der Marketing API v17.0 mit der Einstellung des Legacy-Erlebnisses und der Legacy-Ziele. Mit der Marketing API v17.0 können Kampagnen nur noch mit Zielen für ergebnisorientierte Werbeerlebnisse erstellt werden und ältere Ziele werden eingestellt. In dieser Version werden vorhandene Kampagnen und das Duplizieren vorhandener Kampagnen weiterhin unterstützt und davon nicht beeinflusst. Weitere Informationen findest du in unserem aktuellen Entwicklungs-Blog-Post.

Erforderliches Feld für Standardoptimierungen der Advantage+-Anzeigengestaltung

Anfang dieses Jahres haben wir Standardoptimierungen der Advantage+-Anzeigengestaltung für die Marketing API veröffentlicht. Marketing API-Nutzer*innen müssen ab dem 23. Mai 2023 die Registrierung einer Anzeige für die Standardoptimierung der Advantage+-Anzeigengestaltung festzulegen, indem sie „OPT_IN“ oder „OPT_OUT“ im Feld „enroll_status“ angeben. Wenn das Feld leer gelassen wird, erhält der*die Nutzer*in eine Fehlermeldung und wird aufgefordert, das Feld auszufüllen. Weitere Informationen über die Standardoptimierung der Advantage+-Anzeigengestaltung für die Marketing API findest du in diesem Entwicklungs-Blog-Post.

Die folgenden Endpunkte sind betroffen:

POST /{ad-account-id}/adcreatives
POST /{ad-account-id}/ads

Einstellung der Advantage+ Catalog Ads für das Streamen von Medientiteln

Mit der Veröffentlichung der Marketing API v17.0 stellen wir die Nutzung von Advantage+ Catalog Ads für Streaming (A+CA for Streaming) ein. Werbeanzeigen des Commerce-Katalogs sind die empfohlene Alternative für A+CA für Streaming. Hier findest du einen Leitfaden zur Einrichtung eines Commerce-Katalogs. Die folgenden Endpunkte werden eingestellt:

Einen Katalog für A+CA für Streaming erstellen: „owned_product_catalogs“ der Edge mit vertikalen „media_titles“
Medientitel-Feeds hochladen: „product_feeds“ der Edge für einen A+CA-Katalog für Streaming
Ein Medientitel-Element erstellen: „media_titles“ der Edge für einen A+CA-Katalog für Streaming
Eine Kampagne mit einem A+CA-Katalog für Streaming erstellen: „campaigns“ der Edge mit einem DAS-Katalog auf entweder L3, L2 oder L1

Ab dem 21. August 2023 gelten die oben genannten Änderungen für alle Marketing API-Versionen und wir werden alle Kampagnen pausieren, denen A+CA-Kataloge für Streaming auf der Ebene L3, L2 oder L1 angehängt sind.

Einstellung der Instant Articles API

Da das Produkt Instant Articles am 20. April 2023 eingestellt wurde, wird die dazugehörige API, mit der Publisher*innen ihre Instant Articles verwalten konnten, jetzt ebenfalls eingestellt.

Durchsetzung der Unternehmensverwaltungs-Berechtigung für Nutzer*innenkonten

Zuvor wurden zusätzliche vom Unternehmen verwaltete Seiten ohne den Berechtigungszugriff „business_management“ zurückgegeben. Wenn du ab dem 23. Mai 2023 weiterhin Zugriff auf die vom Unternehmen verwalteten Seiten erhalten möchten, ist die Berechtigung „business_management“ erforderlich. Weitere Details zu dieser Berechtigung findest du auf der Seite business_management.

Einstellungen von API-Versionen:

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

Graph API

8. Juni 2023: Graph API v10.0 wird eingestellt und von der Plattform entfernt
14. September 2023: Graph API v11.0 wird eingestellt und von der Plattform entfernt
8. Februar 2024: Graph API v12.0 wird eingestellt und von der Plattform entfernt

Marketing API

15. August 2023: Marketing API v14.0 wird eingestellt und von der Plattform entfernt
15. August 2023: Marketing API v15.0 wird eingestellt und von der Plattform entfernt

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