Version 7.0
Graph API
Veröffentlicht am 5. Mai 2020 | Verfügbar bis 4. August 2022 | Blogbeitrag
Facebook Business Extension, v2
Diese Änderung gilt für alle Versionen.
Es wurden zwei neue Felder zur Facebook Business Extension v2 hinzugefügt.
Werbekonto-ID (
ad_account_id): Die Werbekonto-ID, die der*die Nutzer*in in FBE ausgewählt hat. Mit diesem Werbekonto können Werbeanzeigen verwaltet werden, wenn deine App überads_management-Berechtigungen verfügt.Katalog-ID (
catalog_id): Die Katalog-ID, die der*die Nutzer*in in FBE ausgewählt hat. Diese ID kann zum Verwalten des Produktkatalogs verwendet werden.
Hashtag-Suche
Diese Änderung gilt für v7.0+.
Du kannst jetzt das timestamp-Feld für IG-Medien anfragen, die von GET /{ig-hashtag-id}/top_media-Anfragen und GET /{ig-hashtag-id}/recent_media-Hashtag-Such-Anfragen zurückgegeben werden. Beispiel: GET /{ig-hashtag-id}/top_media?fields=timestamp.
Messenger
Kunden-Chat-Plugin
Diese Änderung gilt für v7.0+ und gilt ab 2. November 2020 für alle Versionen.
Wenn über das Kunden-Chat-Plugin eine neue Unterhaltung begonnen oder eine bestehende Unterhaltung fortgesetzt wird, enthalten die anfänglichen messaging_postbacks- und messaging_referrals-Webhook-Benachrichtigungen eine anonyme user_ref-ID für den*die Nutzer*in anstelle der seitenspezifischen ID (PSID) für den*die Nutzer*in. Sobald der*die Nutzer*in eine Nachricht gesendet hat, enthalten nachfolgende Webhook-Benachrichtigungen die PSID für den*die Nutzer*in.
Seiten-Messengerprofile
Diese Änderung gilt für v7.0+.
Die Eigenschaft home_url von Seiten-Messengerprofilen ist für alle Vorgänge veraltet (GET, POST und DELETE).
Open Graph
Eingestellte Funktionen
Diese Änderung gilt für v7.0 und gilt ab 3. August 2020 für alle Versionen.
POST /{user-id}/{open-graph-action-type-id}
Seiten
App-spezifische Nutzer*innen-IDs
Diese Änderung gilt für v7.0+ und gilt ab 5. Mai 2021 für alle Versionen.
Seit dem 1. Mai 2018 gibt die Pages API für alle neuen Apps seitenspezifische Nutzer*innen-IDs (PSID) anstelle von appspezifischen Nutzer*innen-IDs (ASID) zurück. Vor diesem Datum erstellte Apps erhielten weiterhin ASIDs, wenn sie nicht dem Empfang von PSIDs zustimmten. Nun werden alle Apps PSIDs von der Pages API empfangen.
Mit der Page-Scoped ID API kannst du ASIDs den entsprechenden PSIDs zuordnen. Die API ist ab der Version 7.0 veraltet, kann jedoch bis zum 5. Mai 2021 mit älteren Versionen verwendet werden.
Eingestellte Funktionen
Diese Änderungen gelten für v7.0+ und ab 3. August 2020 für alle Versionen.
Die folgenden Endpunkte werden eingestellt:
Berechtigungen
Die Berechtigung manage_pages ist veraltet und wurde durch vier neue Berechtigungen ersetzt:
Die Berechtigung publish_pages ist veraltet und wurde durch zwei neue Berechtigungen ersetzt:
Apps, die bereits für manage_pages oder publish_pages oder beide zugelassen wurden, werden zum 1. Juni 2020 zu den neuen Berechtigungen migriert.
Für Apps, die bereits für manage_pages oder publish_pages oder beide eingereicht, aber noch nicht überprüft wurden, wird der Überprüfungsprozess normal fortgesetzt. Wenn die Genehmigung erteilt wurde, werden die Apps zum 1. Juni 2020 zu den neuen Berechtigungen migriert.
Um vor dem 1. Juni 2020 Seitenberechtigungen zu beantragen oder erneut zu beantragen, wähle die Berechtigungen aus, die du in deinem App-Dashboard siehst, entweder manage_pages oder publish_pages oder beide oder die neuen Berechtigungen. Falls nötig, wird deine App zum 1. Juni 2020 automatisch zu den neuen Berechtigungen migriert.
Nach dem 1. Juni 2020 werden manage_pages und publish_pages nicht mehr in der Auswahl unter App Review > Berechtigungen und Funktionen im App-Dashboard verfügbar sein.
Die Berechtigungen manage_pages und publish_pages werden im Mai 2022 vollständig eingestellt. Änderungen an deinem Code müssen vor diesem Datum vorgenommen werden.
SDKs
Im iOS-SDK-Änderungsprotokoll und im Android-SDK-Änderungsprotokoll erfährst du mehr über wichtige anstehende Änderungen an diesen SDKs.
Nutzer*innen
Eingestellte Funktionen
Diese Änderungen gelten für v7.0+ und ab 3. August 2020 für alle Versionen.
Die folgenden Endpunkte werden eingestellt:
Marketing API
Veröffentlicht am 5. Mai 2020 | Verfügbar bis 3. März 2021 | Blogbeitrag
Werbekampagnen
Optimierung des Kampagnenbudgets
Diese Änderung gilt für v7.0+.
Du kannst jetzt nicht mehr sowohl lifetime_budget als auch spend_cap gleichzeitig für eine spezifische Werbekampagne einstellen. Du kannst nur lifetime_budget auswählen.
Ein Laufzeitbudget für eine Kampagne wird über den Verlauf deiner Kampagne hinweg verteilt. Wenn du lifetime_budget auf Kampagnenebene verwendest, sind die Informationen zum Ausgabengrenzwert bereits einbezogen. Daher gibt es keinen Grund, einen zweiten Ausgabengrenzwert hinzuzufügen.
Du kannst spend_cap weiterhin für Kampagnen verwenden, bei denen keine Optimierung des Kampagnenbudgets eingesetzt wird.
Spezielle Anzeigenkategorie
Diese Änderung gilt für v7.0+.
Der Parameter special_ad_category für den POST /act_<AD_ACCOUNT_ID>/campaigns-Endpunkt ist veraltet und wurde durch einen neuen special_ad_categories-Parameter ersetzt.
Der neue special_ad_categories-Parameter ist erforderlich und akzeptiert ein Array. Wenn du den special_ad_category-Parameter abrufst, gibt er weiterhin einen String zurück, aber du solltest GET /{campaign-id}?fields=special_ad_categories verwenden, um ein Array zurückzubekommen.
Details findest du unter Spezielle Anzeigenkategorien.
Mehr dazu: Hilfebereich für Werbeanzeigen: Spezielle Anzeigenkategorien.
Eingestellte Funktionen
Diese Änderung gilt für v7.0+.
Der budget_rebalance_flag-Parameter ist veraltet. Wir empfehlen dir, stattdessen die Optimierung des Kampagnenbudgets zu verwenden.
Atlas-Werbekampagnen
Eingestellte Funktionen
Diese Änderung gilt für v7.0+.
GET /{atlas-ad-campaign-id}/cumulative_edited_date
Produktkatalog
Eingestellte Funktionen
Diese Änderung gilt für v7.0+.
Der cpas_parent_catalog_settings-Parameter der POST /PRODUCT_CATALOG_ID-Edge ist für Drittanbieter-Apps veraltet.