Zurück zu den Neuigkeiten für Entwickler

Einführung von Facebook Graph API v19.0 und Marketing API v19.0

23. Januar 2024VonMohamed Amr Abouelhassan

Heute führen wir die Facebook Graph API v19.0 und die Marketing API v19.0 ein. Wir erläutern Änderungen im Rahmen dieser Veröffentlichung, die für Teile unserer Entwicklungs-Community relevant sind. Zu diesen Änderungen zählen Ankündigungen, Produkt-Updates und Benachrichtigungen zu Beendigungen, welche die Integration deiner Anwendung(en) mit unserer Plattform betreffen.

Eine vollständige Liste aller Änderungen sowie der Änderungsdetails findest du in unserem Änderungsprotokoll.

Allgemeine Updates

Aktivierung von Advantage-Detailtargeting für alle Kampagnenziele und Optimierungen

Im Rahmen unserer ständigen Bemühungen um eine bessere Werbeperformance erweitern wir die Verfügbarkeit von Advantage-Detailtargeting auf alle Kampagnenziele und Optimierungen.

Unsere Advantage-Produkte setzen fortschrittliche Automatisierung und maschinelles Lernen ein, um die Kampagnenperformance von Werbetreibenden zu verbessern. Dazu zählt auch Advantage-Detailtargeting. Mit Advantage-Detailtargeting kann unser System eine größere Anzahl von Personen erreichen, als Werbetreibende im detaillierten Targeting ausgewählt haben. Dadurch kann die Kampagnenperformance verbessert werden.

Am 23. Januar 2024 werden wir die folgenden Änderungen für Werbetreibende und Partner einführen, welche die Marketing API nutzen:

Alle Kampagnen, die für Impressionen, Videoaufrufe, Reichweite, Interaktionen oder Steigerung der Werbeerinnerung optimiert sind, können ab sofort Advantage-Detailtargeting nutzen.
Bei allen Kampagnen, die für Leads optimiert sind, wird Advantage-Detailtargeting automatisch aktiviert und kann manuell deaktiviert werden.
- Hinweis: Bei neuen und duplizierten Kampagnen/Anzeigengruppen ist die Funktion automatisch vorausgewählt. Du kannst sie über die entsprechende Schaltfläche deaktivieren.
Bei allen Kampagnen, die für Link-Klicks oder Landingpage-Aufrufe optimiert sind, wird Advantage-Detailtargeting automatisch aktiviert und kann nicht deaktiviert werden.

Für Werbetreibende und Partner, welche die Marketing API nutzen, stellt diese Umstellung eine funktionsgefährdende Änderung dar. Entwickler*innen können ab dem 23. Januar 2024 mit der Umsetzung der Codeänderungen beginnen und haben bis zum 22. April 2024 Zeit, sie abzuschließen. Diese Änderungen werden mit der neuen API-Version V19 eingeführt.

<Impacted endpoints>

Anfragetyp	Endpunkt	Änderungen
GET	/act_{ad-account-id}/delivery_estimate /{adset-id}/delivery_estimate	Das Feld targeting_optimization wird bei Kampagnen, die für Link-Klicks oder Landingpage-Aufrufe optimiert sind, nicht akzeptiert. Dies gilt auch für frühere Optimierungen im Advantage-Detailtargeting, die nicht deaktiviert werden konnten, z. B. Conversions, Wert, App-Installationen, App-Events und Unterhaltungen. Das Feld targeting_as_signal sollte bei Kampagnen, die für Impressionen, Videoaufrufe, Reichweite, Interaktionen, Steigerung der Werbeerinnerung oder Leads optimiert sind, entweder leer oder 0 sein, sonst wird ein Fehler ausgelöst.
POST	/act_{ad_account_id}/{adsets} /{adset-id}	Das Feld targeting_optimization wird bei Kampagnen, die für Link-Klicks oder Landingpage-Aufrufe optimiert sind, nicht akzeptiert. Dies gilt auch für frühere Optimierungen im Advantage-Detailtargeting, die nicht deaktiviert werden konnten, z. B. Conversions, Wert, App-Installationen, App-Events und Unterhaltungen. Für alle Optimierungen, bei denen Advantage-Detailtargeting nicht mehr deaktiviert werden kann, wird das Feld targeting_as_signal automatisch auf 1 oder 3 gesetzt, je nachdem, welche Ziele und Optimierungen ausgewählt wurden.

Anfragetyp

Endpunkt

Änderungen

GET

/act_{ad-account-id}/delivery_estimate

/{adset-id}/delivery_estimate

Das Feld targeting_optimization wird bei Kampagnen, die für Link-Klicks oder Landingpage-Aufrufe optimiert sind, nicht akzeptiert. Dies gilt auch für frühere Optimierungen im Advantage-Detailtargeting, die nicht deaktiviert werden konnten, z. B. Conversions, Wert, App-Installationen, App-Events und Unterhaltungen.
Das Feld targeting_as_signal sollte bei Kampagnen, die für Impressionen, Videoaufrufe, Reichweite, Interaktionen, Steigerung der Werbeerinnerung oder Leads optimiert sind, entweder leer oder 0 sein, sonst wird ein Fehler ausgelöst.

POST

/act_{ad_account_id}/{adsets}

/{adset-id}

Das Feld targeting_optimization wird bei Kampagnen, die für Link-Klicks oder Landingpage-Aufrufe optimiert sind, nicht akzeptiert. Dies gilt auch für frühere Optimierungen im Advantage-Detailtargeting, die nicht deaktiviert werden konnten, z. B. Conversions, Wert, App-Installationen, App-Events und Unterhaltungen.
Für alle Optimierungen, bei denen Advantage-Detailtargeting nicht mehr deaktiviert werden kann, wird das Feld targeting_as_signal automatisch auf 1 oder 3 gesetzt, je nachdem, welche Ziele und Optimierungen ausgewählt wurden.

Marketing API: Neue Anzeigen, Anzeigengruppen und Kampagnen mit bisherigen Zielen

Mit der neuen Marketing API v19.0 können neue Anzeigen, Anzeigengruppen und Kampagnen mit den bisherigen Zielen (siehe unten) nicht mehr per Ad Copy erstellt werden. Alle Werbeziele müssen an unsere neuen vereinfachten Werbeziele angepasst werden.

Ab Version 20 der Marketing API wird das Erstellen von Anzeigen und Anzeigengruppen im Rahmen von Kampagnen mit den bisherigen Zielen nicht mehr unterstützt. Alle Versionen der API vor v20 (d. h. v19, v18 etc.) unterstützen diese Funktion jedoch weiterhin. Für bestehende Anzeigen mit den bisherigen Zielen besteht kein unmittelbarer Handlungsbedarf.

Betroffene bisherige Werbeziele

BRAND_AWARENESS
CONVERSIONS
EVENT_RESPONSES
LEAD_GENERATION
LINK_CLICKS
LOCAL_AWARENESS
MESSAGES
OFFER_CLAIMS
PAGE_LIKES
POST_ENGAGEMENT
REACH
STORE_VISITS
VIDEO_VIEWS

Betroffene POST-Endpunkte

/{ad_id}/copies
/{campaign_id}/copies
/{adset_id}/copies

Hier findest du einen Blogeintrag mit weiteren Informationen zu den API-Änderungen beim Erstellen von Kampagnen mit den bisherigen Zielen.

Häufig gestellte Fragen

F: Erfordert diese Änderung ein Code-Update?

A: Ja, mehrere API-Aufrufe für V18 werden in V19 nicht mehr funktionieren (z. B. können neue Anzeigen, Anzeigengruppen und Kampagnen mit den bisherigen Zielen nicht mehr per Ad Copy erstellt werden).

F: Wie sieht das erwartete Verhalten vor und nach der Änderung aus?

A: Vor der Änderung sind API-Aufrufe zum Duplizieren einer Anzeige, Anzeigengruppe oder Kampagne mit den bisherigen Zielen erfolgreich, danach werden sie fehlschlagen.

F: In welchem Zeitraum müssen die Code-Änderungen implementiert werden?

A: Bis zur Einstellung von v18.0, die voraussichtlich im September 2024 erfolgen wird.

Zusätzliche Dokumentation für Entwickler*innen

Hilfeartikel

PPCA (Zugriff auf öffentliche Seiteninhalte)

Der Anwendungsfall für Daten, die mithilfe von PPCA (Zugriff auf öffentliche Seiteninhalte) erfasst wurden, hat sich geändert. Unter diesem Link findest du weitere Informationen dazu.

Advantage+ Audience API

Im Oktober letzten Jahres haben wir mit Advantage+ Audience ein neues und vereinfachtes Verfahren zur Erstellung von Zielgruppen eingeführt. Advantage+ Audience erweitert die Zielgruppe einer Werbeanzeige, ohne dabei die gewünschten Zielgruppen der Werbetreibenden zu vernachlässigen, und steigert so die Kampagnenperformance.

Jetzt führen wir Advantage+ Audience auch für die Marketing API ein.

Um das neue Feature zu aktivieren, musst du den Parameter targeting_automation in advantage_audience auf 1 setzen.
Um das neue Feature zu deaktivieren, setzt du den Parameter targeting_automation in advantage_audience auf 0.

Einstellungen und funktionsgefährdende Änderungen

Beendigung der Facebook Groups API

Die Facebook Groups API wird in v19 eingestellt und innerhalb von 90 Tagen aus allen Versionen entfernt. Die Beendigung betrifft alle Berechtigungen (publish_to_groups, groups_access_member_info) und überprüfbaren Features (Groups API) im Zusammenhang mit der Facebook Groups API.

Ein wesentlicher Anwendungsfall der Groups API waren private Antworten in Gruppen. In v19 werden wir eine weitere Änderung einführen, die diesen Anwendungsfall weiterhin ermöglicht, ohne dass Entwickler*innen die Groups API nutzen müssen. Die meisten Entwickler*innen für private Antworten müssen in v19 keine Änderungen vornehmen. Entwickler*innen, die nach dem Empfang eines Webhooks für private Antworten Aufrufe der Gruppen-Post-Endpunkte über die Groups API genutzt haben, müssen jetzt einen Seiten-Zugriffsschlüssel für diese Anfragen verwenden.

Bei Unsicherheiten, ob ihre Endpunkte eine veraltete Berechtigung nutzen, können Entwickler*innen die Endpunkte in Version 19.0 testen.

Änderungen an der Page Insights API – Kennzahlen werden eingestellt

Im Rahmen des Wechsels von der klassischen zur neuen Seitenversion auf Facebook werden wir eine Reihe von Kennzahlen der Page Insights API einstellen. Hier findest du weitere Informationen dazu.

Eingestellte API-Versionen:

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

Graph API

8. Februar 2024: Graph API v12.0 wird eingestellt und von der Plattform entfernt
28. Mai 2024: Graph API v13.0 wird eingestellt und von der Plattform entfernt
17. September 2024: Graph API v14.0 wird eingestellt und von der Plattform entfernt

Marketing API

06. Februar 2024: Marketing API v16.0 wird eingestellt und von der Plattform entfernt
14. Mai 2024: Marketing API v17.0 wird eingestellt und von der Plattform entfernt

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

Meta Business SDK

Einführung Meta Business SDK v19

Das Meta Business SDK v19 wird kurz nach der Graph API v19 eingeführt. Diese Version enthält Fehlerbehebungen, Aktualisierungen der Abhängigkeiten, neue Features und vor allem eine aktualisierte API-Oberfläche, die der Graph API v19 entspricht. In Zukunft planen wir, das SDK häufiger zu aktualisieren, um die Frequenz an die API-Updates anzupassen. So stehen den Entwickler*innen immer die neuesten APIs, Funktionalitäten und Features zur Verfügung.

Beachte bitte die folgenden bevorstehenden Einstellungen und Ausphasungen, die Teil unseres 2-Jahres-Beendigungszeitplans für Platform SDKs sind: