Einführung Facebook Graph API v12.0 und Marketing API v12.0
Heute führen wir Facebook Graph API v12.0 und Marketing API v12.0 ein. Nachfolgend heben wir Änderungen hervor, die Teile unserer Entwickler-Community betreffen. Zu diesen Änderungen zählen Ankündigungen und Produkt-Updates, Erinnerungen von vorherigen Launches sowie Benachrichtigungen zur Einstellung mehrerer Elemente, die möglicherweise die Integration deiner Anwendung(en) mit unserer Plattform betrifft.
Eine vollständige Liste aller Änderungen sowie der Änderungsdetails findest du in unserem Änderungsprotokoll.
Allgemeine Ankündigungen und Updates
Conversions API: Erweiterung der aufrufbaren Mindestversion
Abwärtskompatibilität der Graph API für Apps, die mit One-Click-Zugriffstoken erstellt wurden Ab v 12.0 werden neu erstellte Zugriffstoken, die auf dem Tab „Einstellungen“ in der Conversions API im Events Manager generiert wurden, in allen verfügbaren Graph API-Versionen unterstützt (unterstützte Versionen findest du hier).
Beachte, dass über diese Token durchgeführte Anrufe an veraltete Graph API-Versionen automatisch an die älteste verfügbare Version aufgelöst werden. Dieses Verhalten trifft nur auf Graph API-Endpunkte zu. Marketing API-Endpunkte, einschließlich der Conversions API, unterstützen das automatische Upgrade-Verhalten nicht und lösen eine Ausnahme aus.
User Profile API für Instagram Messaging: Neue Felder
Wir nehmen Verbesserungen an der User Profile API für Instagram Messaging vor. Bisher wurden in der User Profile API für Instagram Messaging zwei Felder unterstützt: 1) Name und 2) URL des Profilbilds. Damit Unternehmen Nachrichten basierend auf öffentlich zugänglichen Nutzerinformationen besser personalisieren und priorisieren können, haben wir die API aktualisiert, sodass sie auch folgende Informationen enthält:
1. Anzahl der Follower
2. Verifizierungsabzeichen
3. Unternehmen folgt dem Nutzerkonto [Ja/Nein]
4. Nutzerkonto folgt dem Business-Konto [Ja/Nein]
Weitere Informationen findest du in der Entwicklerdokumentation.
Neue Möglichkeiten für detailliertes Targeting
Wenn Werbetreibende detailliertes Targeting nutzen und es unter Verwendung des Ziels „Conversions“ für Conversions, Auswahl- oder App-Events optimieren, werden sie automatisch in die Targeting-Ausweitung aufgenommen, damit sie zusätzliche Chancen erhalten, die ihnen vorher nicht verfügbar waren. Weitere Informationen findest du im Artikel „Ausweitung des detaillierten Targeting“ im Hilfebereich.
Video API: neue Felder
Wir haben zwei neue Felder zum [Video]-Node hinzugefügt: views und post_views. Weitere Informationen findest du in der Entwicklerdokumentation Video API.
Einstellungen und funktionsgefährdende Änderungen
Fehlertransparenz
Das Standardverhalten von Graph API und Marketing API besteht darin, einen Fehler auszulösen, wenn eine App ein Feld oder eine Edge auf einem Node anfordert, das/die einen zugehörigen Node/zugehörige Nodes zurückgibt, jedoch nicht über die entsprechenden von den zugehörigen Nodes erforderten Berechtigungen verfügt. Viele dieser Felder und Edges folgten jedoch nicht diesem Protokoll und wurden stattdessen bei API-Antworten einfach ausgelassen, wenn die anrufenden App nicht über die entsprechenden Berechtigungen verfügte.
Ab Version v12.0 werden diese Felder und Edges das Standardverhalten befolgen. Diese Änderung gilt ab dem 13. Dezember 2021 für alle Versionen.
Systemnutzer und App-Rollen
Die Möglichkeit, SystemnutzernRollen in Apps zuzuweisen, wird eingestellt, es sei denn, der Nutzer und die App sind demselben Unternehmen zugehörig. Um Unterbrechungen deiner App oder deines Geschäftsbetriebs zu vermeiden, sollten diese Systemnutzer aus deiner App entfernt werden und stattdessen die API „Business On Behalf Of“ verwenden. Diese funktionsgefährdende Änderung tritt am 13. Dezember 2021 in Kraft.
Geplante Live-Videos
Der Parameter „planned_start_time“ der Planungsfunktion in der Live API wird abgeschafft. Diese funktionsgefährdende Änderung tritt am 13. Dezember 2021 in Kraft. Ein neuer Parameter wir zu einem späteren Zeitpunkt eingeführt.
Messenger Plattform: Conversation API
Das Feld „user_id“ wird aus den Thread-Metadaten in der Conversation API entfernt. Entwickler müssen jede Referenz auf user_id (IGID) migrieren und vollständig auf IGSID als primärer Identifikator eines Threads zwischen dem Nutzer und dem Unternehmen setzen.
Diese funktionsgefährdende Änderung tritt am 13. Dezember 2021 für frühere Versionen von Graph API in Kraft. Weitere Informationen findest du in der Entwicklerdokumentation Conversation API.
Messenger Plattform: Instagram Webhooks
Wir aktualisieren unsere Messenger API für den Instagram-Reaktionen-Webhook, damit Reaktionen per Emoji besser unterstützt werden. In der aktuellen Version wird das Feld „Emoji“ als Zeichenfolge zurückgegeben. Mit diesem Update geben Reaktions-Webhooks ein neues Unicode-Format zurück. Beachte, dass im Feld „Reaktion" nur Standard-Emojis unterstützt werden. Für alle anderen Emojis wird im Feld „Reaktion“ der Wert „Sonstige“ zurückgegeben, der „MSGR“ entspricht.
Diese funktionsgefährdende Änderung tritt am 13. Dezember 2021 für frühere Versionen von Graph API in Kraft. Um weiterhin Emoji-Reaktionen zu unterstützen, müssen Entwickler eine Migration auf den neuen Unicode vornehmen, der ab dem 13. Dezember 2021 zurückgegeben wird. Weitere Informationen findest du in der Webhook-Entwicklerdokumentation.
Einstellungen von API-Versionen:
Beachte die folgenden bevorstehenden Einstellungen, die Teil des Versionierungszeitplans von Facebook für Graph API und Marketing API sind:
Graph API
- 02. November 2021: Graph API v4.0 wird eingestellt und von der Plattform entfernt
- 03. Februar 2022: Graph API v5.0 wird eingestellt und von der Plattform entfernt
- 22. Mai 2022: Graph API v6.0 wird eingestellt und von der Plattform entfernt
Um Unterbrechung des Geschäftsbetriebs zu vermeiden, empfehlen wir die Migration aller Anrufe auf die neueste Version der API, die heute veröffentlicht wurde.
Marketing API
- Marketing API v10.0 wird am 04.10.2021 eingestellt.
- Marketing API v11.0 wird am 23.02.2022 eingestellt.
Um Unterbrechung des Geschäftsbetriebs zu vermeiden, empfehlen wir die Migration alle Anrufe auf die neueste Version der Marketing API, die heute veröffentlicht wurde. (Weitere Informationen findest du im Änderungsprotokoll).
Facebook Platform SDK
- Am 19. Januar 2021 haben wir den zweijährigen Zeitplan für die Einstellung von Facebook Platform SDK v8.x und älteren Versionen angekündigt. Diese Versionen werden im Januar 2023 eingestellt.
- Am 08. Juni 2021 haben wir Facebook Platform SDK v11.0 veröffentlicht, womit der zweijährige Zeitplan für die Einstellung von Facebook Platform SDK v9.0 begonnen hat. SDK v9.0 wird im Juni 2023 eingestellt.
Allgemeine Einstellungen
Einstellung des Endpunkts für native Angebote
Am 08. Juni 2021 haben wir die Einstellung der Offers Ads API angekündigt. Diese tritt umgehend mit der Veröffentlichung von Graph API v12.0 ein.
Messenger-Plattform – Flugplanvorlagen
Am 08. Juni 2021 haben wir die Einstellung von Flugplanvorlagen angekündigt. Diese tritt am 06. Dezember 2021 ein.
