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

Heute führen wir die Facebook Graph API v16.0 und die Marketing API v16.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.

Allgemeine Ankündigungen und Updates

WhatsApp Business Plattform – Fehlerantworten

Im Rahmen unserer fortlaufenden Bemühungen, das Antwortverhalten bei API-Fehlern zu verbessern, haben wir die folgenden Änderungen vorgenommen.

• Fehler-Subcodes, die selten verwendet werden und nicht verlässlich sind, kommen in den Fehlerantworten ab v16.0 nicht mehr zur Anwendung. Nutze stattdessen „code“ und „details“.
• Fehlercode 100 ("code":100) hatte mehrere eindeutige Titel, die die Art eines bestimmten Code-100-Fehlers angaben. Alle Code-100-Fehler verwenden als Titel jetzt „Invalid Parameter“. Alte Titel, die die Art eines bestimmten Code-100-Fehlers angaben, wurden in die Eigenschaft „details“ verschoben. Diese Änderung wird nun außerdem in den Webhooks-Payloads wiedergegeben, die eine Code-100-Fehlerantwort beschreiben.
• Die „errors“-Objekte in Webhooks enthalten jetzt eine neue „message“-Eigenschaft, die sich auf die Eigenschaft „message“ in Payloads von API-Fehlerantworten bezieht.

Die Entwicklungsplattform erfordert jetzt eine Unternehmensverifizierung für den erweiterten Zugriff auf sämtliche APIs

Wie am 1. Februar 2023 angekündigt, bittet Meta Entwickler*innen nun um die Verifizierung ihrer Unternehmen, um erweiterten Zugriff auf alle Berechtigungen auf der Meta-Entwicklungsplattform zu erhalten. Dies ist Bestandteil unserer Bemühungen, die Authentizität und Legitimität eines Unternehmens oder einer Organisation zu bestätigen.

Für Apps, die nach dem 1. Februar 2023 erstellt wurden, erfolgt die Einführung schrittweise und zwar sobald eine neue App erweiterten Zugang anfordert. Apps, die vor dem 1. Februar 2023 erstellt wurden und über erweiterten Zugriff verfügen, müssen ab dem 1. Mai 2023 mit einem verifizierten Unternehmen verknüpft sein. Auf dieser Seite findest du eine Liste aller Berechtigungen, für die eine Unternehmensverifizierung erforderlich ist, bevor der erweiterte Zugriff genehmigt werden kann.

Einstellungen und funktionsgefährdende Änderungen

Einstellung der Reiseerwägung

Die Reiseerwägung wurde 2018 als wählbare Option für Werbetreibende in der Reisebranche eingeführt. Das Feature ermöglichte die bevorzugte Anzeigenauslieferung an Personen, die eine Reiseabsicht ausgedrückt, sich aber noch nicht entschieden haben, wohin sie reisen möchten. In Verbindung mit vorhandenen Targeting-Optionen unterstützte die Reiseerwägung Werbetreibende bei der Auslieferung von Anzeigen an die richtigen Personen zur richtigen Zeit auf Facebook, Instagram und im Audience Network. Wir haben unsere maschinellen Lernsysteme in den vergangenen vier Jahren kontinuierlich weiterentwickelt und ausgiebig getestet. Dank unserer Fortschritte können wir Werbetreibende in der Reisebranche nun auch ohne wählbare Option dabei unterstützen, Verbraucher*innen mit Reiseabsichten zu erreichen – und das bei einer vergleichbaren Performance.

Ab dem 2. Februar 2023 entfernen wir daher die Option „Reiseerwägung“ im Werbeanzeigenmanager und in der API für neue Kampagnen. Wir sind zu dem Schluss gekommen, dass die Option nicht mehr notwendig ist. Werbetreibende sollten mit dem Entfall der Option keine Einbußen hinsichtlich ihrer Performance feststellen. In der Übergangszeit wird sich das Aktivieren bzw. Deaktivieren der Option voraussichtlich nicht nennenswert auf die Kampagnenperformance auswirken.

Durch die stetige Verbesserung der maschinellen Lernmodelle können mittlerweile die gleichen Ziele und die gleiche Performance auch ohne die wählbare Option erreicht werden. Mit dem Wegfall entsteht für Werbetreibende zudem ein optimiertes Nutzungserlebnis.

Einstellung von Flight Ads für die Neukund*innengewinnung

Im September 2018 führten wir mit großem Erfolg Flight Ads für die Neukund*innengewinnung ein. Mitte 2021 stieß das Produkt auf technische Schwierigkeiten. Es wurden Fehler festgestellt, die eine effiziente Auslieferung von Kampagnen verhinderten. Aus diesem Grund hatten wir Werbetreibende proaktiv dazu angehalten, auf andere Optionen für die Neukund*innengewinnung umzuschwenken. Die Retargeting-Funktion ist weiterhin verfügbar und kann von Werbetreibenden verwendet werden.

Falls du oder einer deiner Partner derzeit noch Flight Ads für die Neukund*innengewinnung nutzt, raten wir zur Abschaltung aller laufenden Kampagnen bis zum 1. Mai 2023.

Einstellung der Anzeigenplatzierung in Instant Articles

Ab dem 20. April 2023 entfernen wir Instant Articles sowie die Anzeigenplatzierung in Instant Articles von Facebook. Instant Articles wurden 2015 eingeführt, um es Publishern zu ermöglichen, interaktive Medienartikel auf Mobilgeräten zu veröffentlichen und diese mithilfe von Werbeanzeigen auf Facebook zu monetarisieren. Für die meisten Plattform-Nutzer*innen spielt die Entdeckung von Nachrichten jedoch nur eine untergeordnete Rolle in ihrem Facebook-Erlebnis. Darüber hinaus wünschen sie sich, weniger dieser Inhalte in ihren Feeds zu sehen. Vor diesem Hintergrund möchten wir unsere Investitionen neu ausrichten, um den Vorlieben der Nutzer*innen Rechnung zu tragen.

Ab dem 20. April 2023 steht die Anzeigenplatzierung in Instant Articles im Werbeanzeigenmanager und in der Marketing API nicht mehr für die Erstellung neuer Kampagnen zur Verfügung. Anzeigengruppen, die bisher ausschließlich die Platzierung in Instant Articles enthielten, werden nach dem 20. April 2023 pausiert. Alle anderen Anzeigengruppen, in denen die Platzierung in Instant Articles verwendet wurde, werden automatisch aktualisiert, um die Platzierung auszuschließen.

Ausblenden von Reaktionen, Kommentaren und Markierungen bei auf Nutzer*innenprofilen veröffentlichten Inhalten

In dieser Version führen wir eine Änderung ein, die dazu führt, dass die Kommentare, Reaktionen und Markierungen des*der Sitzungsnutzer*in ausgeblendet werden. Außerdem werden bei den Feldern „via“ und „sharedposts“ leere Datensätze für Beiträge auf Nutzer*innenprofilen zurückgegeben. Diese Änderung wirkt sich nur auf Inhalte aus, die auf Nutzer*innenprofilen veröffentlicht werden.

Einstellung der Unterstützung für TLS-Versionen vor 1.2

Um unsere Sicherheit weiterhin gewährleisten zu können, stellen wir die Unterstützung der Graph APIs für TLS-Versionen vor 1.2 ein. Solltest du TLS 1.2 verwenden, beachte bitte, dass der Zugriff über statische RSA-Verschlüsselungen (AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA) ebenfalls eingestellt wird. Für mit älteren TLS-Versionen erstellte API-Anfragen wird nach 90 Tagen eine Fehlermeldung zurückgegeben.

Nach dem 1. Mai 2023 blockieren wir zudem den Webtraffic zu developer.facebook.com von Browsern, die ältere TLS-Versionen verwenden (älter als TLS 1.2 und für TLS 1.2, wenn statische RSA-Verschlüsselungen [AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA] verwendet werden).

Vorlagenkategorien für WhatsApp

Im vergangenen Jahr haben wir die Vorlagenkategorien im WhatsApp Manager und in der API aktualisiert, um neue Anwendungsfälle zu berücksichtigen, zu denen Nachrichten über die WhatsApp Business Platform versendet werden. Am 2. Februar 2023 benennen wir diese Vorlagenkategorien um, damit sie die Anwendungsfälle besser widerspiegeln:

• Marketing-Vorlagen heißen weiterhin Marketing (keine Änderung)
• Transaktionsvorlagen werden in Dienst umbenannt
• OTP-Vorlagen werden in Authentifizierung umbenannt

Wenn Unternehmen Vorlagen mit Graph v16 erstellen oder bearbeiten, müssen sie diese aktualisierten Vorlagenkategorien verwenden. Ab dem 1. Mai gilt diese Änderung für alle Versionen, d. h. alle Versuche, Vorlagen zu erstellen oder zu bearbeiten, müssen ungeachtet der Version diese neuen Kategorien verwenden. Damit es bei der Erstellung oder Bearbeitung von Vorlagen zu keinen Störungen kommt, sollten Unternehmen und BSPs ihre API-Aufrufe spätestens bis zum 1. Mai 2023 auf die neuen Kategoriewerte und Vorlagen umstellen.

Nachfolgend einige weitere wichtige Termine und Anmerkungen:

• Migration der Vorlagen: Am 1. April überführt WhatsApp alle bestehenden Vorlagen in die neuen Vorlagenkategorien. Unternehmen können die neue Kategorisierung ihrer Vorlagen im WhatsApp Manager einsehen und haben bis zum 15. Mai Zeit, sie zu überprüfen. Wenn ein Unternehmen mit der Kategorisierung nicht einverstanden ist, kann es bis zum 15. Mai Einspruch erheben. Alle mit Graph API v15 oder älteren Versionen zwischen dem 1. April und dem 1. Mai neu erstellten oder bearbeiteten Vorlagen werden am 5. Mai migriert. Wir empfehlen daher, ab dem 1. April Version 16 für die Vorlagenerstellung zu verwenden. Ab dem 1. Mai sind alle Vorlagen, die mit dem WhatsApp Manager oder einer beliebigen Graph API-Version erstellt werden, den neuen Vorlagenkategorien zugeordnet.
• Vorlagenerstellung in neuen Vorlagenkategorien: Ab dem 1. April muss bei allen Vorlagen, die in Graph API v16 und im WhatsApp Manager erstellt werden, zur Genehmigung die Vorlagenkategorie validiert werden. Neu erstellte oder bearbeitete Vorlagen werden möglicherweise abgelehnt, wenn WhatsApp feststellt, dass die ausgewählte Kategorie falsch ist. Im Ablehnungsgrund wird dann erklärt, dass die ausgewählte Kategorie nicht mit dem Inhalt der Vorlage im Sinne unserer Vorlagenrichtlinien übereinstimmt. Unternehmen können daraufhin entweder die Kategorieauswahl ändern und die Vorlage erneut einreichen, die Vorlage bearbeiten oder die Entscheidung anfechten. Ab dem 1. Mai müssen neu erstellte Vorlagen, die Variablen enthalten, mit Inline-Beispielen eingereicht werden. Ab dem 1. Juni gilt für Unternehmen die neue Preisgestaltung gemäß den Vorlagenkategorien.

Messenger API-Plattform

Wir vereinfachen die Funktion für regelmäßige Benachrichtigungen, indem wir ab Version 16 die Option zum Festlegen der Nachrichtenfrequenz entfernen. Weitere Informationen findest du im Änderungsprotokoll für die Messenger-Plattform.

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

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

Marketing API

• 25. April 2023: Marketing API v14.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.

Facebook Platform SDK

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

• Juni 2023: Facebook Platform SDK v9.0 oder niedriger werden ausgephast
• Oktober 2023: Facebook Platform SDK v11.0 oder niedriger werden ausgephast
• Februar 2024: Facebook Platform SDK v12.0 oder niedriger werden ausgephast