Version 10.0

Graph API

Veröffentlicht 23. Februar 2021 | Verfügbar bis 8. Juni 2023 |Blog-Post

Business Apps

Zugriffsebenen

Gilt für alle nach dem 16. Februar 2021 erstellten Apps.

Alle Apps des Typs Business, die nach dem 16. Februar 2021 erstellt werden, erhalten automatisch Standardzugriff auf die Berechtigungen email und public_profile.

Gilt für alle vorhanden Apps, die nach dem 16. Februar 2021 erstellt wurden.

Alle Apps des Typs „Business“, die vor dem 16. Februar 2021 erstellt wurden, erhalten automatisch erweiterten Zugriff auf die Berechtigungen email und public_profile. Apps, die die Berechtigung email oder public_profile nicht verwenden, werden für diese beiden Berechtigungen auf Standardzugriff herabgestuft.

Apps des Typs „Business“ können ohne App-Review auf erweiterten Zugriff für die Berechtigungen email und public_profile hochgestuft werden.

Gruppen

Gilt ab Version 10.0. Gilt ab dem 25. Mai 2021 für alle Versionen.

• Um andere Richtlinien zur Datenaufbewahrung von Facebook einzuhalten, übernimmt die Groups API nur Daten, die innerhalb der letzten 90 Tage Ihrer Anfragen erstellt wurden. Welche Daten zurückgegeben werden, hängt von der Zugriffsebene oder dem Modus deiner App und deiner Rolle in der App ab.
• Die Groups API verwendet nun anstelle des Entwicklungsmoduszugriffs und des Live-Modus-Zugriffs ein zweistufiges API-Zugriffssystem (Standard und privilegiert). Mit dem Standardzugriff kannst du nur Daten für Benutzer abrufen, die eine Rolle in deiner App haben. Mit dem privilegierten Zugriff kannst du Daten von allen Benutzern in der Gruppe anrufen, in der die App installiert ist.

Seiten

Wiederhergestellter Endpunkt

Gilt ab Version 10.0. Gilt ab dem 25. Mai 2021 für alle Versionen.

Der DELETE /{page-id}/tabs-Endpunkt, der in v8.0 veraltet war wurde in v10.0 wiederhergestellt und wird am 25. Mai 2021 in allen Versionen wiederhergstellt.

Gefahrenaustausch

Löschen abgelaufener Daten

Gilt ab dem 25. Mai 2021 für alle Versionen.

Daten, die mit einem anderen Wert als null für expire_time hochgeladen werden, werden zum angegebenen Ablauftermin dauerhaft gelöscht. Wenn du Daten löschen möchtest, die nicht mehr gültig sind, lege für das Feld expired_on die aktuelle Uhrzeit fest, damit die Daten sofort gelöscht werden.

Darüber hinaus werden alle ThreatDescriptors, die nicht von Facebook stammen, dauerhaft gelöscht, wenn sie das vom Creator festgelegte Ablaufdatum erreichen. Wenn deine Anwendung derzeit über abgelaufene ThreatDescriptors verfügt, die du nicht löschen möchtest, musst du das Ablaufdatum verlängern oder auf „0“ (null) festlegen, um so sicherzustellen, dass die Daten nie ablaufen.

URL

Gilt ab Version 10.0. Gilt ab dem 25. Mai 2021 für alle Versionen.

Interaktionen

• Aus Datenschutzgründen entspricht die von einer GET /?id={url}/engagement-Anfrage zurückgegebene Anzahl möglicherweise nicht den Roh-Zahlen.
• Anfragen für das Feld GET /?id={url}/engagement mit derselben URL sind auf zehn Anfragen pro Stunde begrenzt.

Marketing API

Veröffentlicht 23. Februar 2021 | Verfügbar bis 4. Oktober 2021 | Blog-Post

Werbekonto

Feldänderungen

Gilt ab Version 10.0. Gilt ab dem 25. Mai 2021 für alle Versionen.

Für das Feld agency_client_declaration im Node AdAccount sind nun für alle Vorgänge Administratorrechte erforderlich.

Ads Insights API

date_preset-Parameter aktualisiert

Gilt ab Version 10.0.

• Der lifetime-Parameter (date_preset=lifetime) ist deaktiviert und wird durch date_preset=maximum ersetzt. Mit diesem Parameter können maximal 37 Monate an Daten abgerufen werden. Die API gibt einen Fehler zurück, wenn Anfragen Datumsbereiche enthalten, die über 37 Monate hinausgehen.
• Für die Version 9.0 und älter ändert sich die Funktion bis zum 25. Mai 2021 nicht. Zu diesem Zeitpunkt wird der Parameter date_preset=maximum aktiviert. Alle Aufrufe von lifetime verwenden standardmäßig maximum und geben Daten der letzten 37 Monate zurück.

Unternehmen

Lockerung der Einschränkungen für Endpunktzugriff

Gilt ab Version 10.

In der Version 9.0 war der Zugriff auf die unten aufgeführten Endpunkte eingeschränkt. Der Zugriff wurde für alle Apps wiederhergestellt. Apps können jetzt jedoch nur auf Unternehmen (oder deren untergeordnete Unternehmen) abzielen, die sie beansprucht haben:

• POST /<APP_SCOPED_SYSTEM_USER_ID>/access_tokens
• POST /{business-id}/business_users
• POST /{business-id}/system_users

Targeting

Verbindungs-Targeting

Gilt ab dem 24. Mai 2021 für alle Versionen.

Die folgenden Endpunkte akzeptieren beim Erstellen oder Bearbeiten von Werbekampagnen kein Verbindungs-Targeting mehr.

• POST /<ad_account_id>/adsets
• POST /<adset_id>

Diese Änderung wirkt sich nicht auf laufende Kampagnen aus.

Lookalike Audiences

Die Parameter location_spec und country werden für die Erstellung von Lookalike Audiences entfernt. Der Standort für die Lookalikes wird im länderspezifischen Standort für die Targeting-Spezifikation der Kampagne festgelegt.

Diese Änderung hat keine Auswirkungen auf vorhandene Kampagnen. Diese Anforderung hat nur Auswirkungen auf neue und überarbeitete Kampagnen.

Dies wirkt sich auf die folgenden Endpunkte und Felder aus:

• POST /<ad_account_id>/customaudiences
• POST /<ad_account_id>/adsets
• POST /<ad_account_id>/adaccounts?adaccounts=<SHARED_TO_AD_ACCOUNT_ID>
• GET /<ad_account_id>/reachestimate
• GET /<ad_account_id>/delivery_estimate
• GET /<ad_account_id>?fields=approximate_count
• GET /<ad_account_id>?fields=delivery_status
• GET /<ad_account_id>?fields=operation_status

Weitere Informationen zu diesen Updates findest du unter Lookalike Audiences: Bevorstehende Änderungen bei Lookalikes.