Neu: Facebook Graph API v15.0 und Marketing API v15.0

Heute führen wir die Facebook Graph API v15.0 und die Marketing API v15.0 ein. Weiter unten erläutern wir daher einige Änderungen, die für Teile unserer Entwickler*innen-Community relevant sind. Zu diesen Änderungen zählen Ankündigungen, Produkt-Updates und Benachrichtigungen zu Einstellungen, die unserer Ansicht nach die Integration deiner Anwendung(en) mit unserer Plattform betreffen.

Eine vollständige Liste aller Änderungen mit zugehörigen Details findest du in unserem Änderungsprotokoll.

Allgemeine Ankündigungen und Updates

Vereinfachung der Kriterien zum Erstellen von selbstdefinierten Conversions

Um den Prozess des Kampagnenerstellens für Werbetreibende zu vereinfachen, benötigen neu erstellte selbstdefinierte Conversions ab dem Release der Graph API v15.0 mindestens eine verknüpfte Regel. Selbstdefinierte Conversions, die keine Regeln benötigen, sollten die Optimierung für selbstdefinierte Events verwenden, mit der Werbekampagnen direkt im selbstdefinierten Event optimiert werden können. Wir arbeiten aktiv daran, unsere bestehenden selbstdefinierten Conversions von einem einzigen allumfassenden Angebot in mehrere wertspezifische Produkte zu transformieren, um die Bedürfnisse und Anwendungsfälle unserer Werbetreibenden besser bedienen zu können. Diese Änderung wird dazu führen, dass Werbetreibende von auf selbstdefinierten Events basierenden selbstdefinierten Conversions auf die Optimierung für selbstdefinierte Events umsteigen.

Updates der Plattformbedingungen

Wir aktualisieren die Plattformbedingungen in Bezug darauf, wann wir den Zugriff einer App auf beliebige Plattform-APIs, Berechtigungen oder Funktionen entfernen können, auf die deine App innerhalb eines bestimmten Zeitraums nicht zugegriffen hat. Ab dem 15. Dezember 2022 wird in den Plattformbedingungen vorgesehen, dass Apps nur dann als „aktiv“ gelten, wenn sie innerhalb der jeweils vorausgehenden 28 Tage Aktivität gezeigt haben.

Wenn dir mitgeteilt wird, dass deine App inaktiv war, und du sie wiederherstellen möchtest, kannst du dies über deine Admin-Rolle für die App tun.

Du kannst die Plattformbedingungen hier einsehen und dir eine komplette Vorschau der Änderungen ansehen.

Einstellungen und funktionsgefährdende Änderungen

Einführung von Advantage Custom Audience

Ab dem 19. September 2022 beginnen wir mit der Einführung von Advantage Custom Audience. Advantage Custom Audience verwendet die Custom Audience eines Werbetreibenden, um die Auslieferung zu leiten und mehr Personen zu finden, die wahrscheinlich ihr angegebenes Optimierungsziel erreichen werden. Das bedeutet, dass wir Anzeigen über ihre Custom Audience hinaus ausliefern werden, wenn das wahrscheinlich die Performance steigert. Advantage Custom Audience ist Teil unserer Produktreihe Advantage Targeting, die auch Advantage-Detailtargeting und Advantage Lookalikes umfasst. Unsere Advantage-Targeting-Produkte setzen auf fortgeschrittene Automatisierungs- und Machine-Learning-Technologie und verbessern damit die Kampagnen-Performance der Werbetreibenden bei geringerem manuellem Aufwand.

Werbetreibende, die Custom Audiences nutzen, werden Advantage Custom Audiences auswählen können. Mit Advantage Custom Audiences werden Werbetreibende weiterhin Custom Audiences erstellen (Website, App-Aktivität, Kundenliste oder Interaktionen) und relevante Einschluss-/Ausschlusskriterien anwenden. Dabei profitieren sie von unserer fortgeschrittenen Automatisierungs- und Machine-Learning-Technologie, die deine Custom Audience nutzt, um die Auslieferung zu leiten und so mehr Nutzer*innen zu erreichen, die wahrscheinlich dein angegebenes Optimierungsziel erreichen werden.

Wenn du eine neue Kampagne erstellst, die eine Website, Mobile oder Engagement Custom Audience enthält, werden Advantage Custom Audiences automatisch aktiviert. Du kannst dieses Produkt deaktivieren, indem du in unserem Anzeigenerstellungstool die Auswahl für „Advantage Custom Audience“ im Bereich „Custom Audience“ aufhebst.

Einstellung von Special Ad Audiences

Als Teil unserer Vereinbarung mit dem US-Ministerium für Wohnungsbau und Stadtentwicklung werden wir Special Ad Audiences einstellen. Mit diesem Tool können Werbetreibende ihre Audiences um mit Wohnen, Arbeit und Kredit verbundene Anzeigengruppen erweitern. Ab dem 15. September 2022 können Special Ad Audiences nicht mehr über die Marketing API erstellt werden.

Für Werbetreibende und Partner wird die Sperrung neuer Special Ad Audiences am 15. September 2022 eine funktionsgefährdende Änderung darstellen, da mit dieser nicht-versionierenden Änderung die vorherigen Werte veraltet sind. 2019 haben wir einige Targeting-Optionen für Anzeigen in Verbindung mit Wohnen, Arbeit und Kredit abgeschafft und zusätzlich Special Ad Audiences als Alternative zu Lookalike Audiences eingeführt. Aber Fairness im maschinellen Lernen ist ein dynamisches und sich ständig weiterentwickelndes Gebiet, und Special Ad Audiences waren eine frühe Methode, auf Bedenken einzugehen. Jetzt werden wir uns auf neue Ansätze zur Verbesserung der Fairness konzentrieren, einschließlich der bereits angekündigten Methode.

Unten findest du eine Liste der betroffenen Endpunkte in Verbindung mit dieser Einstellung:

Zum Lesen der Audience:

• endpoint gr:get:AdAccount/customaudiences
• field operation_status

Zum Erstellen von Anzeigengruppen:

• endpoint gr:post:AdAccount/adsets
• field subtype

Zum Bearbeiten von Anzeigengruppen:

• endpoint gr:post:AdCampaign
• field subtype

Zum Erstellen von Custom Audiences:

• endpoint gr:post:AdAccount/customaudiences
• field subtype

Zum Bearbeiten von Custom Audiences:

• endpoint gr:post:CustomAudience

Bitte lies den früheren Blogbeitrag und die Entwicklerdokumentation, um weitere Details zur Unterstützung der Codeimplementierung zu erfahren.

Gleichstellung von Advantage-Detailtargeting/Advantage Lookalike

Dieses Projekt stellt Detailtargeting als Signal (Advantage-Detailtargeting) für API-Nutzer*innen gleich, die Anzeigengruppen mit Nachrichten/App-Installationen als Ziele verwenden (nach dem Release von Ads Manager). Zuvor haben wir Advantage-Detailtargeting für API für Anzeigengruppen mit Conversions als Ziel und Conversions/Wert als Optimierungszielen gelauncht (Anzeigengruppen VO/OC).

Wenn Werbetreibende derzeit Anzeigegruppen via API erstellen und Nachrichten oder App-Installationen zum Ziel haben, geben sie zwei Dinge als Teil der Targeting-Kriterien weiter (L2): eine Liste mit detaillierten Targeting-Inputs (z. B. Cricket, Fußball, Hunde etc.) und eine Kennzeichnung, die anzeigt, ob sie ihre Reichweite über diese Inputs hinaus erweitern möchten (als Advantage-Detailtargeting bezeichnet). Wenn die Kennzeichnung aktiviert ist, liefern unsere Systeme die Anzeigen über die Detailtargeting-Auswahl hinaus aus, wenn dies wahrscheinlich die Performance steigert. Wenn sie deaktiviert ist, beschränken unsere Systeme die Auslieferung auf die Auswahlliste, die vom Werbetreibenden bereitgestellt wurde.

Wenn Werbetreibende zukünftig (nach dem Release von Ads Manager) neue Kampagnen mit Nachrichten oder Mobilapp-Installationen als Ziel erstellen, werden ihre Detailtargeting-Eingaben als Input verwendet, um die Anzeigenauslieferung zu leiten. Daher werden wir das DTE-Kennzeichen für diese Ziele einstellen und die Targeting-Ausweitung zum Standardverhalten der Detailtargeting-Auswahl machen. Dabei können wir über ihre Detailtargeting-Eingaben hinaus gehen, wenn dies wahrscheinlich die Performance steigert. Alle anderen Targeting-Auswahlen und Ausschlüsse bleiben unberührt. Diese Änderung gilt nicht für Sonderkategorien.

So funktioniert’s:

Früher gaben Werbetreibende das Kennzeichen „targeting_optimization“ mit einem Wert von „expansion_all“ oder „none“ weiter, um die Detailtargeting-Ausweitung zu aktivieren oder zu deaktivieren. Aufgrund der semantischen Änderungen an der Funktionsweise von Detailtargeting für diese Anzeigengruppen müssen Werbetreibende dieses Kennzeichen nicht weitergeben, wenn sie Anzeigengruppen mit Nachrichten oder App-Installationen als Ziel erstellen, da es keine Auswirkungen auf ihre neu erstellten Anzeigengruppen hat. Alle diese neu erstellten Anzeigengruppen werden stets Detailtargeting-Eingaben als Signal an unsere Backend-Systeme verwenden, welche dann entscheiden können, Anzeigen über diese Auswahl hinaus auszuliefern, wenn dies zu einer besseren Performance für die Werbetreibenden führt.

Da das Kennzeichen „targeting_optimization“ keine Auswirkungen auf die neu erstellten Anzeigengruppen hat, planen wir, dieses Feld in Zukunft für neue Kampagnen, die Nachrichten und/oder App-Installationen zum Ziel haben, einzustellen.

• Wenn Werbetreibende zukünftig beim Erstellen neuer MAI-/Nachrichten-Anzeigengruppen oder beim Abfragen der geschätzten Auslieferzeiten das Kennzeichen „targeting_optimization“ weitergeben, werden wir ihnen eine Fehlermeldung anzeigen und sie bitten, diesen Parameter nicht mehr zu senden.
• Ein neues Feld namens „targeting_as_signal“ wird beim Erstellen von neuen App-Installations-/Nachrichten-Anzeigengruppen im Backend festgelegt. Dieses Feld ist nur über GET-Befehle verfügbar, damit Werbetreibende verifizieren können, ob ihre Anzeigengruppen über die Detailtargeting-Eingaben hinaus ausgeliefert werden.

HINWEIS: Diese Änderungen an Detailtargeting als Signal gelten nur für neu erstellte Anzeigengruppen, die Nachrichten und/oder App-Installationen zum Ziel haben.

Betroffene API-Endpunkte:

• gr:post:/act_XXXX/ adsets
• gr:get:/<adset_id>/delivery_estimate

Einstellung von Seiten-Tabs

Wir geben bekannt, dass die Funktionen von Pages Custom Tab API künftig nicht mehr über Graph API verfügbar sind. Da wir die neue Seitenversion einführen, werden einige API-Funktionen künftig eingestellt. Die Custom-Tab-Funktionen werden in der neuen Seitenversion nicht verfügbar sein, daher stellen wir ihre API-Unterstützung ein. Wir geben diese Updates jetzt bekannt, um Entwickler*innen und ihrer Kundschaft genug Zeit zu geben, um die Einstellung dieser Funktionen ihrer Seite(n) zu kommunizieren und die notwendigen Änderungen an ihren Seiten vorzunehmen. Diese Funktion wird zum 14.12.2022 vollständig eingestellt.

Einstellungen von API-Versionen:

Beachte bitte die folgenden bevorstehenden Einstellungen, die Teil des Versionierungszeitplans von Facebook für Graph API und Marketing API sind:

Graph API

• 1. November 2022: Graph API v8.0 wird eingestellt und von der Plattform entfernt
• 23. Februar 2023: Graph API v9.0 wird eingestellt und von der Plattform entfernt
• 8. Juni 2023: Graph API v10.0 wird eingestellt und von der Plattform entfernt

Um Unterbrechung des Geschäftsbetriebs zu vermeiden, empfehlen wir die Migration aller Aufrufe auf die neueste Version der API, die heute veröffentlicht wurde.

Facebook Platform SDK

Beachte bitte die folgenden bevorstehenden Einstellungen und Ausphasungen, die Teil unseres 2-Jahres-Einstellungszeitplans für Platform SDKs sind:

• Januar 2023: Facebook Platform SDK v8.0 oder niedriger werden ausgephast
• Juni 2023: Facebook Platform SDK v9.0 oder niedriger werden ausgephast
• Oktober 2023: Facebook Platform SDK v11.0 oder niedriger werden ausgephast