Wir veröffentlichen heute Facebook Graph API v10.0 und Marketing API v10.0.
Diese Version enthält zahlreiche Ankündigungen, Updates, Einstellungen und Einstellungsrücknahmen, die Einfluss auf die Einbindung deiner Anwendung(en) in unsere Plattform haben können. Dieser Beitrag erläutert diese Updates und die notwendigen Schritte für Entwickler, um eventuelle Störungen zu vermeiden.
Nachstehend findest du ausführliche Informationen in Bezug auf alle Änderungen. Technische Spezifikationen findest du in unserem v10.0 Änderungsprotokoll.
Auf dem Hub für Plattforminitiativen erfährst du mehr über unsere Entwicklerplattform.
Um zu vermeiden, dass du nicht mehr auf deine Facebook Platform API zugreifen kannst, schließe bitte die Überprüfung der Datennutzung innerhalb von 60 Tagen nach Anmeldung ab. Du kannst die Überprüfung der Datennutzung auf der Seite „Meine Apps“ in deinem App-Dashboard abschließen.
Im letzten Herbst hat Facebook die Überprüfung der Datennutzung eingeführt. Das ist ein neuer jährlicher Prozess für Entwickler, mit dem sichergestellt werden soll, dass API-Zugriff und Datennutzung den Facebook-Plattformbedingungen und Entwickler-Richtlinien entsprechen.
Im Rahmen unserer schrittweisen Einführung für alle Apps wirst du dazu in einer Entwicklerwarnung ein Fälligkeitsdatum und weitere Anweisungen erhalten. Außerdem senden wir dir dazu eine E-Mail an die registrierte Kontaktadresse und du erhältst eine Benachrichtigung in deiner Aufgabenliste auf dem App-Dashboard.
Ausführliche Anweisungen, wie du die Überprüfung der Datennutzung ausführst, findest du in unserer Entwicklerdokumentation. Darüber hinaus gibt es einen speziellen FAQs-Abschnitt, in dem du weitere Informationen zur Überprüfung der Datennutzung findest.
Ab dem 24. Mai 2021 ist bei der Benutzung der Groups API das in Anwendungen verfügbare Datenzugriffsfenster auf 90 Tage begrenzt.
Außerdem führen wir einen gestaffelten Groups API-Zugriff für Verbraucheranwendungen ein, abhängig davon, ob sich diese im Entwicklungsmodus oder Live-Modus befinden. Groups API-Berechtigungen funktionieren nun ähnlich dem Standardzugriff und erweiterten Zugriff für Unternehmensanwendungen.
Derzeit können Apps im Entwicklungsmodus auf alle Inhalte von Öffentlichen Gruppen und Privaten Gruppen zugreifen, bei denen der Entwickler ein Administrator ist. Nach Abschluss des App Review können diese Apps auf alle Inhalte von Gruppen zugreifen, die diese App installiert haben.
Ab dem 24. Mai 2021 können Apps im Entwicklungsmodus nur auf eigene Inhalte in Öffentlichen Gruppen und Privaten Gruppen zugreifen, bei denen der Entwickler ein Administrator ist. Das heißt, dass die App keinen Zugriff auf Inhalte hat, die andere Gruppenbenutzer (ohne Rollen in der App) veröffentlicht haben, wie z. B. Beiträge und Kommentare.
Weitere Informationen erhältst du im Änderungsprotokoll zu v10.0
Im Rahmen unserer fortlaufenden Initiativen zum Schutz von Nutzerdaten haben wir die Berechtigungen public_profile (d. h. Default Public Profile Fields) und E-Mail zum Zugriffsebenen-Modell hinzugefügt, das wir mit Graph v8.0 für neue und bestehende Apps des Typs Business angekündigt haben.
Neu erstellte Apps des Typs „Business“ starten jetzt mit einem Standardzugriff für die public_profile- und E-Mail-Berechtigungen. Wenn eine App Standardzugriff auf public_profile hat, können nur Nutzer nach der App suchen oder sich dort anmelden, die eine Rolle in der App oder in dem Unternehmen haben, dem die App gehört. Falls sich externe Nutzer bei deiner App anmelden müssen, können App-Administratoren den erweiterten Zugriff im App-Dashboard beantragen. Dieser Zugriff wird automatisch gewährt.
Weitere Informationen erhältst du im Änderungsprotokoll zu v10.0
Wie am 10. November 2020 angekündigt, müssen Verbraucher- und Gaming-Apps, die zum App Review eingereicht oder vom Entwicklermodus zum Live-Modus wechseln, einen Rückruf zur Datenlöschungsanforderung oder eine URL mit detaillierten Anweisungen für Nutzer bereitstellen, wie eine Löschung ihrer Daten zu beantragen ist. Wir haben vor, diese Anforderung bis zum 10. November 2022 durchzusetzen und werden App-Entwickler 60 Tage vor der Durchsetzung daran erinnern.
Die Ads Manager UI wird in Zukunft das Reporting von Ads Insights-Metriken, die älter als 37 Monate sind, nicht mehr unterstützen. Die API gibt einen Fehler aus, wenn die Anfrage Datenbereiche enthält, die über die 37-monatige Aufbewahrung hinausgehen. Wir deaktivieren „date_preset = lifetime“ und ersetzen es durch „date_preset = maximum“.
Graph API v10.0 ändert sich zu AdsInsight, ausgenommen „date_preset = lifetime“, das für alle sonstigen Versionen der Graph API nach 90 Tagen gilt. Das jeweils aufgerufene Feld muss nicht geändert werden. Es wird eine Voreinstellungsfunktion geben, und alle „Lifetime“-Aufrufe werden standardmäßig auf maximal 37 Monate Aufbewahrung gesetzt.
Diese Veränderung betrifft keine Daten im Zusammenhang mit Anzeigengestaltung, Zielgruppen, Liefereinstellungen oder Anzeigeobjektnamen, und es wird keine Änderung bei der Berechnung bestehende Metriken geben. Diese Änderung gilt für alle Anzeigenberichtsoberflächen, einschließlich Werbeanzeigenmanager, Anzeigenberichte und einfache Werbeanzeigenerfahrungen.
Weitere Informationen erhältst du im Änderungsprotokoll zu v10.0
Ab dem 24. Mai 2021 werden wir Daten zum angegebenen Ablaufdatum permanent löschen („hard delete“), wenn Partner für die Daten, die sie zu ThreatExchange hochladen, ein Ablaufdatum (expire_time) festsetzen. Wenn du angeben möchtest, dass Daten nicht mehr gültig sind, lege für das Feld „expired_on“ das automatische Löschen fest.
„Soft delete“ hat bisher bedeutet, dass wir abgelaufenen Inhalt entsprechend kennzeichnen. „Soft deletes“ werden nicht mehr unterstützt, d. h. nachdem ein Inhalt abgelaufen ist, wird dieser permanent gelöscht und in ThreatExchange nicht mehr angezeigt.
Zusätzlich werden alle nicht von Facebook stammenden ThreatDescriptors in ThreatExchange nach ihrem Ablauf permanent gelöscht. Der Ablaufzeitpunkt wird weiterhin vom Ersteller des ThreatDescriptor festgesetzt. Die Löschung beginnt dann bei allen abgelaufenen ThreatDescriptors, die nicht von Facebook erstellt wurden. Wenn deine Anwendung derzeit über abgelaufene ThreatDescriptors verfügt, die du bei Inkrafttreten dieser Richtlinie nicht löschen möchtest, musst du das Ablaufdatum zurücksetzen oder auf „0“ (null) festlegen, um sicherzustellen, dass die Daten nie ablaufen.
Klicke hier, um mehr über die Änderungen zu erfahren
Ab dem 24. Mai 2021 werden wir nicht mehr nach den Parametern „location_spec“ und „country“ fragen, wenn eine Lookalike Custom Audience in allen Versionen der API erstellt wird.
Wenn eine Lookalike Audience erstellt wird, wählt der Nutzer die Lookalike-Quelle und das gewünschte Verhältnis aus. Der Standort für die Lookalikes wird über den länderspezifischen Standort in der Targeting-Spezifikation der Kampagne festgelegt. Diese Änderung hat keine Auswirkungen auf vorhandene Kampagnen. Diese Änderung hat nur Auswirkungen auf neue und bearbeitete Kampagnen.
Die neue Facebook-Seite Business Status erhöht die Transparenz und proaktive Kommunikation mit externen Entwicklern, die Facebook-Plattformprodukte verwenden. Diese Seite wird als zentrale Anlaufstelle zur Überprüfung des Plattformstatus von Facebook-Unternehmensprodukten fungieren (Werbeanzeigen, WhatsApp Business API, Facebook-Entwicklerplattform usw.). Die Seite ist derzeit verfügbar für Werbeanzeigenmanager und Whatsapp Business API, wobei weitere Unternehmensprodukte im Mai 2021 hinzukommen werden.
Ab dem 24. Mai 2021 werden wir das SDK für den Dialog „Live-Überragung starten“ (GLD) SDK einstellen. Diese Einstellung eines älteren Live-Produktions-Tools erfolgt bei allen Versionen der API. Diese Änderung betrifft nur die Live-Übertragung auf Facebook. Entwicklern empfehlen wir, Live Producer und Live API für alle individuellen Live-Produktionslösungen zu nutzen.
Lösungen für Live-Übertragungen nach der Einstellung des GLD SDK:
Weitere Informationen erhältst du im Änderungsprotokoll zu v10.0
Ab dem 24. Mai 2021 wird Connections Targeting nicht mehr unterstützt, wenn eine Anzeigengruppe erstellt/gelöscht wird. Diese Anforderung hat nur Auswirkungen auf neue und bearbeitete Kampagnen und nicht auf bestehende Kampagnen.
Weitere Informationen erhältst du im Änderungsprotokoll zu v10.0
Mit der Einführung von Graph API v8.0 hatten wir den Endpunkt gr:delete:Page/tabs für die Seiten-Tabs eingestellt. Wir haben beschlossen, diesen Endpunkt für Graph API v10.0 sofort wieder zuzulassen und den Zugang am 24. Mai 2021 in allen anderen Graph-Versionen wiederherzustellen.
Weitere Informationen erhältst du im Änderungsprotokoll zu v10.0
Mit der Einführung von Graph API v9.0 hatten wir den Zugriff auf drei Unternehmensendpunkte eingeschränkt:
Mit der Einführung von Graph v10.0 werden wir diese Endpunkte für API-Aufrufe wieder öffnen, wenn Apps eine dieser beiden Bedingungen erfüllen:
Weitere Informationen erhältst du im Änderungsprotokoll zu v10.0
Beachte bitte die im Rahmen unseres Marketing API Versionierungsplans anstehenden Einstellungen der folgenden Marketing API-Versionen:
Um Geschäftsunterbrechungen zu vermeiden, empfehlen wir, alle Aufrufe auf die heute veröffentlichte neueste Marketing API Version zu migrieren. (Weitere Details findest du im Änderungsprotokoll.)
Beachte bitte die im Rahmen unseres Graph API Versionierungsplans anstehenden Einstellungen der folgenden Graph API-Versionen: