Zurück zu den Neuigkeiten für Entwickler

Introducing Facebook Graph API v10.0 and Marketing API v10.0

23. Februar 2021VonKirk Thaker

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.

Ankündigungen und Updates

Überprüfung der Datennutzung bestätigen

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.

Groups API: Datenzugriffsebenen und Datenbegrenzungen für 90-Tage-Zeitfenster:

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

Zugriffsebenen für public_profile- und E-Mail-Berechtigungen für Business Apps

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

Erinnerungen zu Datenlöschungsanfragen

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.

Graph AdsInsight API Änderungsoptionen beim Retention Reduction Project

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.

  • Veröffentlichungsdatum 23.2.2021:
    • Version 10.0
      • Aktiviere „date_preset = maximum“
      • Deaktiviere „date_preset = lifetime“
      • Fehlermeldung, wenn die Anfrage explizite Datumsbereiche enthält, die über die 37 Monate Aufbewahrung hinausgehen
    • Versionen 9.0 und älter
      • Keine Änderung der derzeitigen Funktionalität
  • 90 Tage nach Veröffentlichung - 24.5.2021:
    • Versionen 9.0 und älter
      • Aktiviere „date_preset = maximum“ (wie bei neuer Version)
      • Fehlermeldung, wenn die Anfrage explizite Datumsbereiche enthält, die über die 37 Monate Aufbewahrung hinausgehen (wie bei neuer Version)
      • „date_preset = lifetime“ kann weiterhin funktionieren, gibt aber nur Daten innerhalb von 37 Monaten zurück, das heißt, verhält sich wie Maximum

Weitere Informationen erhältst du im Änderungsprotokoll zu v10.0

Neue Löschrichtlinie für ThreatExchange-Daten in externem Besitz

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

Targeting-Änderungen in der neuen API

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.

Einführen einer neuen Platform Live Status-Seite

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.

Einstellungen

Einstellung des Dialogs „Live-Übertragung starten“

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:

  • Rufe Live Producer direkt über facebook.com/live/producer auf (oder andere Einstiegspunkte auf Facebook, wie beispielsweise der Button „Live Video“ auf einer Seite oder einem Profil)
  • Integriere benutzerdefinierte Lösungen mithilfe von Live API

Weitere Informationen erhältst du im Änderungsprotokoll zu v10.0

Einstellung von Connections Targeting

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

Einstellungsrücknahmen

Einstellungsrücknahme für Endpunkt gr:delete:Page/tabs

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

Einstellungsrücknahme für die Endpunkte gr:post:Business/business_users, gr:post:Business/system_users und gr:post:User/access_tokens

Mit der Einführung von Graph API v9.0 hatten wir den Zugriff auf drei Unternehmensendpunkte eingeschränkt:

  • gr:post:Business/business_users
  • gr:post:Business/system_users
  • gr:post:User/access_tokens

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:

  • Dem Zielunternehmen gehört die aufrufende App
  • Das Zielunternehmen ist ein untergeordnetes Unternehmen (in einem 2-stufigen Geschäftsmodell) des Unternehmens, dem die aufrufende App gehört

Weitere Informationen erhältst du im Änderungsprotokoll zu v10.0

Aufgabenkalender

Marketing API-Versionseinstellungen:

Beachte bitte die im Rahmen unseres Marketing API Versionierungsplans anstehenden Einstellungen der folgenden Marketing API-Versionen:

  • 3. März 2021: Marketing API v7.0 wird eingestellt und von der Plattform entfernt
  • 4. Mai 2021: Marketing API v8.0 wird eingestellt und von der Plattform entfernt
  • 25. August 2021: Marketing API v9.0 wird eingestellt und von der Plattform entfernt

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.)

Graph API-Versionseinstellungen:

Beachte bitte die im Rahmen unseres Graph API Versionierungsplans anstehenden Einstellungen der folgenden Graph API-Versionen:

  • 4. Mai 2021: Graph API v3.2 wird eingestellt und von der Plattform entfernt
  • 3. August 2021: Graph API v3.3 wird eingestellt und von der Plattform entfernt

Allgemeine Einstellungen

  • 24. Mai 2021:
    • Der Dialog „Live-Übertragung starten“ wird eingestellt und von der Plattform entfernt
    • Connections Targeting wird eingestellt und von der Plattform entfernt

Entwicklermaßnahme erforderlich

  • Fortlaufende Anmeldung: Überprüfung der Datennutzung bestätigen
    • Abschluss nach Anmeldung innerhalb von 60 Tagen
    • Spezieller FAQs-Abschnitt zur Überprüfung der Datennutzung.
  • 23. Februar 2021: Einführung von Graph AdsInsight API mit Änderungen nur für Graph v10.0
  • 24. Mai 2021:
    • Einführung von Graph AdsInsight API mit Änderungen für Graph v9.0 und älter
    • Änderungen an Zugriffsebenen basierend auf App Review werden wirksam
      • Groups API-Datenzugriff auf 90 Tage begrenzt
      • Gestaffelter Groups API-Datenzugriff implementiert
      • Änderung bei „public_profile“ und E-Mail-Berechtigungen für Business-Apps treten in Kraft
    • Neue „Hard Deletion“-Datenrichtlinie zu ThreatExchange ist implementiert
  • 10. November 2022: Anfragefrist zu Datenlöschung