Introducing Graph API v20.0 and Marketing API v20.0

Heute führen wir die Facebook Graph API v20.0 und Marketing API v20.0 ein. Wir erläutern Änderungen im Rahmen dieser Veröffentlichung, die für Teile unserer Entwicklungs-Community relevant sind. Zu diesen Änderungen zählen Ankündigungen, Produkt-Updates und Benachrichtigungen zu Beendigungen, welche 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 Updates

Automatisches Versionsupgrade für die Marketing API

Wir möchten das API-Nutzungserlebnis insgesamt verbessern, indem wir es reibungsloser und effizienter gestalten. Hierzu freuen wir uns, die bevorstehende Einführung der MAPI-Funktion zum automatischen Versionsupgrade anzukündigen. Ab sofort wird die Funktion zum automatischen Versionsupgrade für Marketing API-Endpunkte aktiviert, die zwischen Versionen nicht betroffen sind. Dies bedeutet Folgendes: Wenn ein Endpunkt zwischen einer Version, die als veraltet markiert werden soll, und der nächsten verfügbaren Version nicht betroffen ist, führt die Plattform automatisch ein Upgrade des Aufrufs auf die nächste verfügbare Version durch, anstatt die Anfrage direkt fehlschlagen zu lassen.

Mehr Informationen über dieses Verhalten findest du unter Marketing API – Versionierung sowie im Blogeintrag zum Launch.

Welche Endpunkte in den einzelnen Versionen betroffen sind, kannst du dem Änderungsprotokoll entnehmen.

Nachstehend findest du weitere Informationen zu den Updates in Version 20.0.

Reminder Ads für die Marketing API

Bis 13. Mai 2024 konnten Entwickler*innen das Erstellen von Instagram Reminder Ads nicht über die Instagram Marketing API anbieten, sodass ihre Kundschaft stattdessen Reminder Ads im Meta-Werbeanzeigenmanager erstellen musste. Diese fehlende Kompatibilität führte bei unseren Partnern zu unnötigen Problemen, wenn Kund*innen Reminder Ads schalten wollten.

Angesichts des Feedbacks zu dieser Inkompatibilität unterstützen wir seit 13. Mai 2024 das Erstellen von Reminder Ads über die Instagram Marketing API.

Wir bedanken uns für die Rückmeldungen von unserer Entwickler*innen-Community und ihrer Kundschaft und hoffen, das Erlebnis beim Erstellen von Reminder Ads über die Marketing API noch weiter zu verbessern.

Instagram Reminder Ads

Instagram Reminder Ads helfen Werbetreibenden dabei, die Zeit zwischen Ankündigung und Launch zu überbrücken, indem Interessent*innen dazu angehalten werden, eine Erinnerung einzurichten. Melden sich Personen dafür an, erhalten sie im entscheidenden Moment vor dem Event eine Erinnerung.

Veranstaltungen erstellen und bearbeiten

Wann bei Instagram Reminder Ads die Erinnerung ausgelöst wird, richtet sich nach Datum und Uhrzeit des Veranstaltungsbeginns. Dank dieser Änderung können Entwickler*innen nun Veranstaltungen über die Instagram Graph API erstellen und bearbeiten. Nachdem du einer Anzeige eine Veranstaltung zugewiesen hast, kannst du Reminder Ads über die Instagram Marketing API erstellen.

Neue API für den Werbekonto-Node

Das neue Update für den Werbekonto-Node ist keine funktionsgefährdende Änderung, sondern eine hinzugefügte API. Beim Aufruf werden alle Kampagnen eines Werbekontos aufgelistet, für die es Empfehlungen gibt, sowie die jeweiligen Empfehlungen samt der zu erwartenden Verbesserung der Kosten pro Handlung (CPA).

Mithilfe der neuen API können Werbetreibende die Empfehlungen von Meta für ihre Kampagnen einsehen. Diese Daten sind im Partner Center bereits für alle Partner verfügbar. Über die Bedienoberfläche ist allerdings die manuelle Auswahl eines einzelnen Werbekontos erforderlich, um die Empfehlungen einzusehen.

Die Automatisierung des Zugriffs auf diese Daten mithilfe der CPA_GUIDANCE API soll die manuellen Schritte reduzieren, die erforderlich sind, um die Empfehlungen für jedes Werbekonto zu überprüfen. Mit dem Zugriff auf diese API können unsere Partner intern personalisierte Ansichten erstellen und Trends im Zeitverlauf beobachten.

Wenn dein Unternehmen Hunderte oder gar Tausende Konten verwaltet, kann es schwierig sein, die Kennzahlen für jedes einzeln zu überprüfen. Das gilt besonders, wenn die Zeit ein Faktor ist. (RSS-Empfehlungen für Kampagnen der letzten 28 Tage werden jeden Tagen aktualisiert.) Mithilfe dieser API können Agenturen die vielversprechendsten Kampagnen identifizieren, die sich mit den Empfehlungen optimieren lassen. Letztere werden dann in ihre Systeme übernommen.

Die CPA_GUIDANCE API ermöglicht es Agenturen gezielt, ihre Markenpartner darüber zu informieren, welche Produkte oder Kategorien die höchsten Kosten pro Neukund*in (CPA) verursachen. Mit diesen Informationen können Agenturen ihre Markenpartner dabei unterstützen, ihre Werbeausgaben zu optimieren und die Gesamtperformance ihrer gemeinsamen Kampagnen zu verbessern.

Außerdem können Agenturen so verfolgen, ob eine Empfehlung umgesetzt wurde, wenn ein positiver Trend bei den CPA zu erkennen ist.

Multi-Advertiser Ads

Heute führen wir für Werbetreibende die Möglichkeit ein, Multi-Advertiser Ads über die Marketing API zu nutzen. Bislang konnten Entwickler*innen das Erstellen von Multi-Advertiser Ads nicht über die API anbieten, sodass ihre Kundschaft stattdessen Multi-Advertiser Ads im Werbeanzeigenmanager erstellen musste.

Multi-Advertiser Ads

Bei Multi-Advertiser Ads können Menschen Produkte und Dienstleistungen verschiedener Unternehmen entdecken. Bei ausgewählten Platzierungen auf Facebook und Instagram können Anzeigen in derselben Werbeeinheit wie andere Anzeigen ausgespielt werden. So können Nutzer*innen speziell auf sie zugeschnittene Produkte und Dienstleistungen von Unternehmen entdecken. Eine Werbeeinheit ist ein Container, in dem – meist auf derselben Seite – mehrere Anzeigen präsentiert werden. Weitere Informationen findest du in unserem Hilfebereich für Unternehmen.

Auswirkungen für Entwickler*innen

Zum Launch ist die Auslieferung von über die Marketing API erstellten Multi-Advertiser Ads standardmäßig deaktiviert. Entwickler*innen müssen also noch Code-Änderungen vornehmen, damit die Werbeanzeigen ihrer Kundschaft über diese Funktion ausgeliefert werden können. Multi-Advertiser Ads können mit allen Versionen der Marketing API erstellt werden. Bei allen für Multi-Advertiser Ads geeigneten Anzeigenerstellungsanfragen muss aber angegeben werden, ob die jeweilige Anzeige die Option nutzt oder nicht. Ab dem 19. August 2024 werden Multi-Advertiser Ads standardmäßig aktiviert. Dann müssen auch Entwickler*innen die Code-Änderungen implementieren, die das bislang nicht getan hatten, damit ihre Kundschaft die Option deaktivieren kann.

Generative KI für Werbeanzeigen in der Marketing API: Texte und Hintergründe generieren und Bilder erweitern

Im Oktober 2023 haben wir unsere ersten KI-gestützten Funktionen für die Anzeigengestaltung im Werbeanzeigenmanager angekündigt: Textgenerierung, Bilderweiterung und Hintergrundgenerierung. Heute dürfen wir verkünden, dass wir diese KI-gestützten Funktionen für die Anzeigengestaltung auch auf die Marketing API (MAPI) ausweiten. So können Partner, Agenturen und Werbetreibende die generative KI von Meta auch über die MAPI nutzen.

Die Funktionen ermöglichen die schnelle und automatische Erstellung von Anzeigenvarianten. Damit läuten wir ein neues Zeitalter der Kreativität ein, das für alle Werbetreibenden die Produktivität, Individualisierung und Performance steigert:

• Hintergrundgenerierung: Erstellt bis zu vier passende Hintergründe für Produktbilder, um deine Werbung für verschiedene Zielgruppen zu diversifizieren. Die generierten Hintergründe basieren auf deinen ursprünglichen Produktbildern und zeigen meist einfache Farben und Muster.

• Bilderweiterung: Passt Anzeigenbilder nahtlos an die Seitenverhältnisse unterschiedlicher Oberflächen an – beginnend bei Platzierungen im Feed und demnächst auch in Reels. Das ermöglicht die schnelle und kostengünstige Wiederverwertung vorhandener Assets.

• Textgenerierung: Generiert mehrere Versionen von Anzeigentext. Diese basieren auf deinem ursprünglichen Text und stellen die Verkaufsargumente für deine Produkte bzw. Dienstleistungen in den Vordergrund. Mit den unterschiedlichen Textoptionen kannst du deine Anzeigen für verschiedene Zielgruppen diversifizieren.

Heute machen wir diese Funktionen für noch mehr Werbetreibende zugänglich. Wir freuen uns, dass unsere leistungsstarke generative KI damit für ein größeres Publikum verfügbar ist.

Entsprechend unserem Vorgehen beim Testen neuer Produkte, für die möglicherweise zusätzliche Überprüfungen notwendig sind, erhalten bestimmte Branchen wie Finanzdienstleistungen und Pharmazie/Gesundheit sowie Werbetreibende, die Werbung für Wohnraum, Jobangebote und Kredite oder Wahlwerbung bzw. Werbung zu politisch oder gesellschaftlich relevanten Themen schalten, möglicherweise nicht sofort Zugang zu allen generativen KI-Funktionen.

Funktionsweise

Heute führen wir diese Funktionen für unsere Marketing API ein, genauer die Ad Creative APIs. Werbetreibende können sich für die Verwendung dieser Funktionen über die API entscheiden und eine Vorschau auf mit generativer KI erstellte Anzeigen erhalten.

Im folgenden Beispiel siehst du, wie du für deine Anzeigengestaltung die generativen KI-Funktionen der Marketing API aktivierst.

          curl -X POST \
          -F 'name=Generative AI Creative' \
          -F 'object_story_spec={
          ...
          }' \
          -F 'degrees_of_freedom_spec={
          "creative_features_spec": {
          "image_background_gen": {
          "enroll_status": "OPT_IN"
          }
          }
          }' \
          -F 'access_token=<ACCESS_TOKEN>'\
          https://graph.facebook.com/<GRAPH_API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives
        

Hinweis: Das Beispiel oben zeigt die Aktivierung der Hintergrunderweiterung. Für die Bilderweiterung verwendest du analog dazu bei creative_features_spec den Schlüssel image_uncrop und für die Textgenerierung den Schlüssel text_generation.

Außerdem können Werbetreibende über die API eine Vorschau von Werbeinhalten einsehen, die mit generativer KI optimiert wurden. In der Dokumentation für Entwickler*innen erfährst du mehr zu den einzelnen generativen KI-Funktionen und darüber, wie sich Inhalte generieren, Anzeigen bereitstellen und Vorschauen erzeugen lassen.

Instagram Video API: Uploads fortsetzen

Seit dem 15. Mai 2024 unterstützt das neue „Resumable Upload Protocol“ die Veröffentlichung von Instagram-Videos (Reels, Video-Stories und Video-Carousels) aus lokalen Videos oder bei öffentlich gehosteten Videos per URL. Das neue Protokoll ermöglicht den Upload lokaler Dateien, nur für Reels den Upload längerer Videos (bis zu 15 Minuten) und das Fortsetzen von Uploads nach Netzwerkunterbrechungen oder anderen Übertragungsfehlern.

Bislang musste zur Veröffentlichung von Instagram-Videos die Videodatei bei einem öffentlich zugänglichen Hosting-Anbieter hochgeladen, eine teilbare URL abgerufen und diese dann bei Meta eingegeben werden.

Details zum verbesserten Veröffentlichungsprozess findest du in der entsprechenden Dokumentation für Entwickler*innen. Weiterführende Informationen zu Medien auf Instagram gibt es hier.

Instagram Graph API: Onboarding neuer Kennzahlen

Heute veröffentlichen wir für die Graph API sechs zusätzliche Metriken zu Carousel-Container-Medien. Es handelt sich um folgende Kennzahlen: „‚Gefällt mir‘-Angaben“, „Kommentare“, „Geteilte Inhalte“, „Neue Follower“, „Profilaktivitäten“ (Anzahl der Handlungen, die Nutzer*innen beim Besuch deines Profils ausgeführt haben) und „Profilaufrufe“ (wie oft dein Profil aufgerufen wurde). Diese Kennzahlen sind bereits über die Insights auf Instagram verfügbar, lassen sich nun aber auch über die Graph API abrufen.

Wenn du „‚Gefällt mir‘-Angaben“, „Kommentare“, „Geteilte Inhalte“, „Neue Follower“, „Profilaktivitäten“ und „Profilaufrufe“ zu den Graph API-Endpunkten für Carousel-Posts hinzufügst, solltest du diese Kennzahlen direkt über den API-Aufruf einsehen können.

Hier findest du eine vollständige Liste der Kennzahlen, damit du die relevanten noch heute zu deinen GET-API-Aufrufen für Carousel-Container-Beiträge hinzufügen kannst.

Aktualisierter Zeitplan für die Einstellung der Meta Offline Conversions API (OCAPI)

Letztes Jahr haben wir angekündigt, dass die Offline Conversions API ab Version 17 keine Offline-Events mehr unterstützen wird, und dass wir mit der Einstellung der OCAPI im dritten Quartal 2024 rechnen. Der voraussichtliche Zeitplan für die Einstellung wurde seitdem aktualisiert. Wir können nun bestätigen, dass die Einstellung der OCAPI im Mai 2025 erfolgt. Trotz der Verschiebung des Stichtags vom 3. Quartal 2024 auf Mai 2025 empfehlen wir Werbetreibenden, die derzeit Offline-Events über die OCAPI senden, mit der Migration ihrer derzeitigen Einrichtung fortzufahren und Offline-Events künftig über die Conversions API (CAPI für Offline) zu senden.

Einstellungen und funktionsgefährdende Änderungen

Einstellung des „Buchen“-Buttons in der Messenger API

Ab sofort wird der „Buchen“-Button bei Aufrufen der Messenger API nicht mehr unterstützt. Andere Vorlagen und Buttons bleiben von dieser Änderung unberührt, und Unternehmen können Terminbuchungen weiterhin über die Meta Business Suite verwalten.

Einstellung der Anzeigenart „Werbliche Nachricht“ in der Marketing API

Ab heute ist die Erstellung der Anzeigenart „Werbliche Nachricht“ über die Marketing API v20.0 nicht mehr verfügbar. Auch die Erstellung dieser Anzeigenart über ältere Versionen der API ist nur noch 90 Tage lang möglich. Andere Arten von Messaging Ads bleiben von diesen Änderungen unberührt.

Wir empfehlen, derzeitige Integrationen zu überprüfen und Apps bei Bedarf anzupassen, um einen reibungslosen Übergang sicherzustellen.

Entfernung nicht kritischer Zeiträume bei demografischen Insights-Kennzahlen (External Instagram Graph API)

Am 21. Mai 2024 haben wir Version 20 der Instagram Graph API veröffentlicht.

90 Tage nach dem Launch (also am 19. August 2024) teilt die Graph API keine demografischen Kennzahlen mehr zur interagierenden und erreichten Zielgruppe für nicht kritische Zeiträume (z. B. Länder, Städte, Alter und Informationen zur Geschlechterverteilung für die letzten 14 bzw. 90 Tage).

Stattdessen gibt die Instagram Graph API dann, ähnlich wie die Instagram-App, demografische Informationen für den letzten Monat („this_month“) und die letzte Woche („this_week“) aus. Damit verbessern wir die plattformübergreifende Einheitlichkeit der Kennzahlen.

Dieses neue Upgrade soll Verwirrung vermeiden sowie die Zuverlässigkeit und Qualität unseres Reportings steigern.

Weitere Informationen findest du in der Dokumentation für Entwickler*innen.

Eingestellte API-Versionen:

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

Graph API

• 28. Mai 2024: Graph API v13.0 wird eingestellt und von der Plattform entfernt.

• 17. September 2024: Graph API v14.0 wird eingestellt und von der Plattform entfernt.

• 20. November 2024: Graph API v15.0 wird eingestellt und von der Plattform entfernt.

Marketing API

• 13. August 2024: Marketing API v18.0 wird eingestellt und von der Plattform entfernt.

• 4. Februar 2025: Marketing API v19.0 wird eingestellt und von der Plattform entfernt.

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

Meta-Business-SDK

Einführung des Meta-Business-SDK v20

Das Meta-Business-SDK v20 wird kurz nach der Graph API v20 eingeführt. Diese Version enthält Fehlerbehebungen, Aktualisierungen der Abhängigkeiten, neue Features und vor allem eine aktualisierte API-Oberfläche, die der Graph API v20 entspricht.

Mit dieser Version verbessern wir auch die Unterstützung der folgenden Instagram APIs: IGMediaForIGOnlyAPI, IGUserForIGOnlyAPI, IGRefreshAccessTokenForIGOnlyAPI und IGAccessTokenForIGOnlyAPI. Diese bieten neben den vorhandenen Instagram APIs zusätzliche Optionen, Medien direkt abzurufen. Wir planen, auch weitere APIs für andere Meta-Produkte einzuführen, um das Ökosystem des Business-SDK auszubauen.

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

• Mai 2024: Facebook-Plattform-SDK v13.0 und darunter werden eingestellt.