Version 11.0

Graph API

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

Konsumenten-Apps

Zugriffslevels

Gilt für alle Versionen.

In den nächsten Wochen werden Zugriffsebenen auf alle bestehenden Konsumenten-Apps angewendet. Bei diesen Apps werden Berechtigungen und Features, die bereits über den App-Review-Prozess genehmigt wurden, automatisch für erweiterten Zugriff genehmigt. Alle anderen Berechtigungen und Features werden automatisch für Standardzugriff genehmigt.

Außerdem werden Zugriffsebenen in den nächsten Wochen auch auf alle neu erstellten Apps angewendet. Bei neu erstellten Apps werden die Berechtigungen email und public_profile automatisch für erweiterten Zugriff genehmigt. Beide Berechtigungen werden allerdings standardmäßig auf den Standardzugriff gesetzt und müssen manuell auf den erweiterten Zugriff gesetzt werden, bevor App-Nutzer, die keine Rollen in den Apps haben, sie anfordern können.

Support für Entwickler*innen

Wir haben das Tool Facebook for Business Status veröffentlicht, um den Zustand von Plattform- und Unternehmensprodukten wie Ads Manager, WhatsApp Business und Facebook Developer Platform zu überwachen.

Facebook Analytics

Eingestellte Funktionen

Gilt für alle Versionen.

Nach dem 30. Juni 2021 ist Facebook Analytics nicht mehr verfügbar. Darüber hinaus wird das App Dashboard Plugin for Marketing API eingestellt. Weitere Informationen findest du im Hilfebereich für Unternehmen.

Die folgenden Felder im application-Node sind nicht mehr verfügbar:

• analytics_config
• analytics_platform_metrics_config
• permissible_ad_accounts

Die folgenden Endpunkte sind nicht mehr verfügbar:

• GET Application/analytics_cohort_query
• GET Application/analytics_entity_user_config
• GET Application/analytics_event_types
• GET Application/analytics_funnel_query
• GET Application/analytics_query
• GET Application/analytics_segments

Instagram Basic Display API

Zugriffsschlüssel-Debugger

Gilt für alle Versionen.

Der Access Token Debugger gibt beim Debuggen eines Tokens nun nur eine App-spezifische ID zurück.

API-Versionierung

Gilt für alle Versionen.

Die API unterstützt jetzt versionierte Aufrufe. Um eine bestimmte API-Version abzufragen, gib die Versionsnummer nach der Basis-URL im Abfragepfad an. Zum Beispiel:

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

Nicht versionierte Anfragen (ohne Versionsnummer) werden in die Version aufgelöst, die unter App-Dashboard > Einstellungen > Erweitert > API-Version aktualisieren der aufrufenden App angegeben ist.

App-spezifische Nutzer-IDs

Gilt ab Version 11.0.

App-spezifische Nutzer*innen-IDs (ASIDs) wurden eingeführt. In voraussichtlich zwei Jahren, wenn Version 10.0 veraltet ist, werden die reinen Nutzer*innen-IDs durch ASIDs ersetzt. Du solltest daher bereits jetzt beginnen, die reinen Nutzer*innen-IDs deiner App-Nutzer*innen mit ihren entsprechenden ASIDs zu verknüpfen.

• Alle Versionen unterstützen auf reinen Nutzer*innen-IDs basierende Abfragen.
• Nur Aufrufe ab Version 11.0 unterstützen ASID-basierte Abfragen.
• Aufrufe ab Version 11.0 erhalten ASIDs in Antworten. Das gilt auch dann, wenn reine Nutzer*innen-IDs abgefragt werden.

Zeitbasierte Paginierung

Gilt ab Version 11.0.

Die Parameter since und until wurden zum Endpunkt GET /{user-id}/media hinzugefügt, um zeitbasierte Paginierung zu unterstützen.

Instagram Graph API

Anzahl der „Gefällt mir“-Angaben

Gilt ab Version 11.0. Gilt ab dem 7. September 2021 für alle Versionen.

Bei der indirekten Abfrage eines IG-Medien-Objekts über einen anderen Endpunkt oder eine Felderweiterung wird das Feld like_count bei API-Antworten ausgelassen, wenn der*die Medien-Eigentümer*in die Anzahl der „Gefällt mir“-Angaben dafür verborgen hat. Die direkte Abfrage des IG-Medien-Objekts (die nur durch den*die Eigentümer*in des IG-Medien-Objekts ausgeführt werden kann) gibt die tatsächliche Anzahl der „Gefällt mir“-Angaben zurück, auch wenn „Gefällt mir“-Angaben verborgen sind.

Zeitbasierte Paginierung

Gilt ab Version 11.0.

Die Parameter since und until wurden zum GET /{ig-user-id}/media-Endpunkt hinzugefügt, um die zeitbasierte Paginierung zu unterstützen.

Instant Experiences

Vorlagen

Gilt ab Version 11.0.

Für Instant Experience-Vorlagen wurde der Betatest beendet. Sie sind nun für alle Entwickler verfügbar.

Messenger-Plattform

Messaging-Postbacks-Webhook

Gilt ab Version 11.0.

Das Feld mid wurde zum Webhook messaging_postbacks hinzugefügt, damit Apps die Nachrichten-ID abrufen können.

Einstellung von Airline-Vorlagen

Gilt ab Version 11.0. Gilt ab dem 6. Dezember 2021 für alle Versionen.

Aufrufe an POST /{page-id}/messages, die Airline-Vorlagen (template_type vom Typ airline_boardingpass, airline_checkin, airline_itinerary, airline_update) enthalten, schlagen fehl.

oEmbed

Neues oEmbed Read-Feature

Gilt für alle Versionen.

Das oEmbed-Produkt wurde durch das neue Feature oEmbed Read ersetzt. Wenn du das oEmbed-Produkt vor dem 8. Juni 2021 implementiert hast, kannst du bis zum 7. September 2021 den App Review für das oEmbed Read-Feature abschließen. Wenn du bis zum 7. September 2021 keine Genehmigung für das oEmbed-Feature hast, können deine oEmbed- Implementierungen nicht mehr geladen werden.

Pages API

Kommentar-IDs

Gilt ab Version 11.0. Gilt ab dem 7. September 2021 für alle Versionen.

Das Feld id für Kommentare wird für Apps, die für die Abfrage von Pages-Endpunkten nur die Funktion „Seitenzugriff auf öffentlichen Content“ verwenden, nicht zurückgegeben. Dies schließt auch die id-Felder /PAGEPOST-ID/comments oder /COMMENT-ID/comments ein. Um die id-Felder für Kommentare für Kommentare zu Seitenbeiträgen abzurufen, müssen App-Nutzer*innen auf der abgefragten Seite die MODERATE-Aufgabe ausführen können.

Neue Seitenversion

Im Laufe der nächsten Monate werden alle klassischen Seiten auf die neue Seitenversion umgestellt. Anhand des has_transitioned_to_new_page_experienceSeitenfelds kannst du feststellen, ob eine Seite migriert wurde. Wenn alle Seiten migriert wurden, ist die klassische Seitenversion nicht mehr verfügbar.

Die meisten Pages API-Endpunkte unterstützen sowohl klassische als auch NPE-Seiten (New Page Experiences, neue Seitenversion). Bei Endpunkten, die NPE-Seiten unterstützen, wird in den Referenzen der Abschnitt „Neue Seitenversion“ angezeigt.

Die folgenden Endpunkte unterstützen keine NPE-Seiten:

• /PAGE-ID/likes
• /PAGE-ID/global_brand_children
• /PAGE-ID/locations
• /PAGE-ID/tabs
• /PAGE-ID/visitor_posts

Zahlreiche Seitenfelder sind für NPE nicht verfügbar und geben null, einen anderen Datensatz oder einen Fehler zurück, wenn sie aufgerufen werden. In unserer Übersicht zur neuen Seitenversion findest du eine Liste dieser Seitenfelder.

Berechtigungen

user_likes

Gilt für alle Versionen.

Die zulässige Nutzung für die Berechtigung user_likes wurde aktualisiert. Ab dem 7. September 2021 wird Apps, die bereits für diese Berechtigung zugelassen sind, aber gegen die neue Nutzungsbeschreibung verstoßen, die Genehmigung entzogen.

• Alte zulässige Nutzung: Die Qualität des Nutzererlebnisses in deiner App sinnvoll verbessern. (Es muss für den Nutzer klar erkennbar sein, wie seine Daten verwendet werden, um dieses Erlebnis bereitzustellen.)
• Neue zulässige Nutzung: Eine personalisierte Erfahrung durch die Korrelation und Abbildung von Inhalten anbieten, die mit den mit „Gefällt mir“-Angaben eines Nutzers zusammenhängen. Dazu gehört das Kuratieren von Inhalten in einem Umfang, der es ermöglicht, Apps mit großen Inhaltsmengen individuell anzupassen und es Menschen zu ermöglichen, ihre „Gefällt mir“-Angaben mit anderen zu teilen, z. B. in Dating- und Musik-Apps.

user_posts

Gilt für alle Versionen.

Die zulässige Nutzung für die Berechtigung user_posts wurde aktualisiert. Ab dem 7. September 2021 wird Apps, die bereits für diese Berechtigung zugelassen sind, aber gegen die neue Nutzungsbeschreibung verstoßen, die Genehmigung entzogen.

• Alte zulässige Nutzung: Die Qualität des Nutzererlebnisses in deiner App sinnvoll verbessern. (Es muss für den Nutzer klar erkennbar sein, wie seine Daten verwendet werden, um dieses Erlebnis bereitzustellen.)
• Neue zulässige Nutzung: Den Nutzern das Erstellen physischer oder digitaler Bücher und Alben ihrer Chronik sowie das Teilen von Erinnerungen in ihrer Chronik auf Facebook oder in anderen sozialen Apps ermöglichen.

SDK

Im iOS-SDK-Änderungsprotokoll, Android-SDK-Änderungsprotokoll und Unity-SDK-Änderungsprotokoll erfährst du mehr über wichtige anstehende Änderungen an diesen SDKs.

Marketing API

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

Zielgruppen

Löschen von Custom Audiences, Lookalike Audiences und gespeicherten Zielgruppen

Gilt für alle Versionen.

Ab dem 8. Juni 2021 werden alle Custom Audiences, Lookalike Audiences oder gespeicherten Audiences, die seit über zwei Jahren nicht mehr in einer aktiven Anzeigengruppe verwendet wurden, als „auslaufende Zielgruppe“ gekennzeichnet. Die Zielgruppe wird dann 90 Tage, nachdem sie als „Auslaufende Zielgruppe“ markiert wurde, gelöscht.

Entwickler haben die Möglichkeit, mithilfe des Felds operation_status nach dem Status „Auslaufende Zielgruppe“ filtern und den voraussichtlichen Zeitpunkt der Löschung anhand des Felds delete_time sehen. Sie können wählen, ob sie die Zielgruppe proaktiv löschen oder in einer aktiven Anzeigengruppe verwenden möchten, um eine Löschung zu verhindern. Sobald eine Zielgruppe gelöscht wurde, können Werbetreibende die Zielgruppe nicht mehr erneut aktivieren.

Für Custom Audiences (außer Customer List Custom Audiences), Lookalike Audiences oder gespeicherte Zielgruppen:

• Wenn Werbetreibende möchten, dass die markierten Zielgruppen ab dem 6. September 2021 automatisch gelöscht werden, müssen sie nichts unternehmen. Werbetreibende können die Zielgruppe jedoch auch proaktiv vor dem Datum der automatischen Löschung löschen.
• Gekennzeichnete Zielgruppen, die Werbetreibende weiterhin verwenden möchten, sollten vor dem 6. September 2021 in einer aktiven Anzeigengruppe genutzt werden, um eine Löschung zu vermeiden.

Für Customer List Custom Audiences:

• Wir speichern diese im Namen von Werbetreibenden entsprechend deren Anweisungen. Wenn Werbetreibende vor dem 6. September 2021 keine Maßnahmen ergreifen, um gekennzeichnete Zielgruppen in einer aktiven Anzeigengruppe zu verwenden, betrachten wir dies als Aufforderung an uns, diese Zielgruppen zu löschen.

Dies wirkt sich auf die folgenden Endpunkte und Felder aus:

• GET /{custom-audience-id}
• GET /act_{ad-account-id}/customaudiences?filtering
• GET /act_{ad-account-id}/saved_audiences?filtering
• GET /{saved-audience-id}

Weitere Informationen zu diesen Änderungen findest du unter Überblick über Zielgruppen: Änderungen bei der Löschung von Custom Audiences.

Business API

Gilt für alle Versionen.

Wir beschränken vorübergehend den Zugriff auf die folgenden Endpunkte. Nur Apps, die diese Endpunkte innerhalb der letzten 30 Tage erfolgreich aufgerufen haben, haben weiterhin Zugriff.

• POST /BUSINESS-ID/client_ad_accounts
• POST /ADACCOUNT-ID/agencies

Alle anderen Apps erhalten einen Fehler, wenn sie Aufrufe an diese Endpunkte durchführen.

Catalog API

Einstellung des Produktbestandsfelds

Gilt ab Version 11.0

Das Feld inventory wird eingestellt und durch das neue Feld quantity_to_sell_on_facebook ersetzt. Wir werden das Feld inventory zwar noch eine Weile unterstützen, empfehlen dir aber, stattdessen das neue Feld quantity_to_sell_on_facebook zu verwenden.

Die folgenden Endpunkte sind betroffen:

• POST /{product-item-id}
• GET /{catalog-id}/products
• POST /{product-item-id}
• POST /{catalog-id}/items_batch

Weitere Informationen zu dieser Änderung findest du unter „Stückzahl für Verkauf“ und Unterstützte Felder für Produkte – Dynamic Ads & Commerce.

Löschung nicht leerer Produktgruppen

Gilt ab Version 11.0. Gilt ab dem 7. September 2021 für alle Versionen.

Das Löschen nicht leerer Produktgruppen wird standardmäßig nicht mehr erlaubt. Nicht leere Produktgruppen können durch Anwendung von deletion_method=delete_items auf die Löschanfrage gelöscht werden. Dadurch werden sowohl die Produktgruppe als auch die entsprechenden Artikel gelöscht.

Der folgende Endpunkt ist betroffen:

• DELETE /<product_group_id>

Löschung von Live-Produktpaletten

Gilt ab Version 11.0. Gilt ab dem 7. September 2021 für alle Versionen.

Das Löschen eines Katalogs mit Live-Produktpaletten wird standardmäßig nicht mehr erlaubt. Damit ein Katalog gelöscht werden kann, der eine Live-Produktpalette enthält, musst du den allow_delete_catalog_with_live_product_set-Parameter auf true festlegen.

Diese Änderung wirkt sich auf den folgenden Endpunkt aus:

• DELETE /<product_catalog_id>

Neuer Diagnose-Endpunkt

Gilt ab Version 11.0

Wir haben den neuen Endpunkt GET /{product_catalog_id}/diagnostics hinzugefügt. Mit diesem Endpunkt können Diagnosedaten für einen bestimmten Katalog abgerufen werden, wie z. B. Probleme, die die Anzeige von Produkte in Kanälen verhindern, oder Möglichkeiten zur Verbesserung der Auffindbarkeit von Produkten.

Commerce API

Details zur geschätzten Gesamtzahlung einer Bestellung

Gilt ab Version 11.0. Gilt ab dem 7. September 2021 für alle Versionen.

Wir ändern die Art und Weise, wie Details zur geschätzten Zahlung in Bestellsummen für Aufrufe an den Endpunkt {commerce-order-id}/?fields=estimated_payment_details angegeben werden. Bisher wurde bei nicht erfüllten Bestellungen ein geschätzter Steuerbetrag und bei erfüllten Bestellungen der erfüllte Steuerbetrag verwendet. Ab Version 11.0 verwendet dieser Endpunkt immer den geschätzten Steuerbetrag. Nähere Informationen zum erfüllten Steuerbetrag findest du mit {commerce-order-id}/items?fields=tax_details.

Conversion Lift

Änderungen bei Kennzahlen

Gilt ab Version 11.0. Gilt ab dem 7. September 2021 für alle Versionen.

Die vom Feld GET /{objective-id}/?fields=result zurückgegebenen Kennzahlen haben sich geändert.

Folgende Kennzahlen wurden hinzugefügt:

• conversions_incremental_share
• conversions_CPiC
• conversions_multicell_confidence
• conversions_multicell_rank
• sales_incremental_share
• sales_multicell_confidence
• sales_multicell_rank
• buyers_incremental_share
• buyers_CPiB
• buyers_multicell_confidence
• buyers_multicell_rank

Die folgenden Kennzahlen wurden entfernt:

• advancedBuyers.control
• ancedBuyers.informativeMultiCellBayesianConfidence
• advancedBuyers.lift
• advancedBuyers.test
• advancedConversions.control
• advancedConversions.informativeMultiCellBayesianConfidence
• advancedConversions.lift
• advancedConversions.test
• advancedSales.control
• advancedSales.informativeMultiCellBayesianConfidence
• advancedSales.lift
• advancedSales.test
• buyers.baseline
• buyers.bayesianCILower
• buyers.bayesianCIUpper
• buyers.control
• buyers.delta
• buyers.incremental
• buyers.isStatSig
• buyers.lift
• buyers.multiCellBayesianConfidence
• buyers.reachedPercent
• buyers.singleCellBayesianConfidence
• conversions.baseline
• conversions.bayesianCILower
• conversions.bayesianCIUpper
• conversions.control
• conversions.delta
• conversions.incremental
• conversions.isStatSig
• conversions.lift
• conversions.multiCellBayesianConfidence
• conversions.reachedPercent
• conversions.singleCellBayesianConfidence
• frequency
• incrementalROAS
• sales.baseline
• sales.bayesianCILower
• sales.bayesianCIUpper
• sales.control
• sales.delta
• sales.incremental
• sales.isStatSig
• sales.lift
• sales.multiCellBayesianConfidence
• sales.singleCellBayesianConfidence

Die folgenden Kennzahlen wurden umbenannt:

Eine vollständige Liste der verfügbaren Kennzahlen findest du im Glossar der Facebook-Lift-Kennzahlen.

Insights API

Einstellung von Kennzahlen für „Besuche im Geschäft“

Gilt ab Version 11.0. Gilt ab dem 6. September 2021 für alle Versionen.

Die Kennzahlen store_visits_actions und cost_per_store_visit_actions wurden eingestellt.

Die folgenden Endpunkte sind betroffen:

• GET /{adaccount-id}/insights
• GET /{campaign-id}/insights
• GET /{adset-id}/insights
• GET /{ad-id}/insights
• POST /{adaccount-id}/insights
• POST /{campaign-id}/insights
• POST /{adset-id}/insights
• POST /{ad-id}/insights

Offer Ads API

Einstellung von Offer Ads API-Endpunkten

Gilt ab Version 11.0. Gilt ab dem 7. September 2021 für alle Versionen.

Im Rahmen unserer laufenden Bemühungen, die Produktstabilität zu erhöhen, stellt Facebook am 8. Juni 2021 seine Unterstützung für das Offer Ads-Produkt ein. Zum Verteilen von Rabatten im Geschäft oder von Online-Rabatten werden ersatzweise Standard-Facebook-Werbeanzeigen empfohlen. Rabattinformationen, den Ort bzw. die Orte zum Einlösen, das Ablaufdatum und Promotioncodes sollten direkt in der Anzeigengestaltung auf Anzeigenebene platziert werden.

Die folgenden Endpunkte werden eingestellt:

• GET /{page-id}/nativeoffers
• POST /[page-id}/nativeoffers
• GET /pagename/nativeoffers
• GET /{native-offer-id}
• GET /{native-offer-id}/views
• POST /{native-offer-id}/codes
• POST /{native-offer-id}/nativeofferviews
• GET /{offer-id}/comments
• GET /{offer-id}/sharedposts
• GET /{offer-id}/likes