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

Heute führen wir die Facebook Graph API v18.0 und die Marketing API v18.0 ein. Weiter unten erläutern wir daher einige Änderungen, die für Teile unserer Entwicklungs-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 Updates

Konsolidierung der Standort-Targeting-Optionen für den Standort-Status der Zielgruppe

Wie bereit im Mai 2023 angekündigt, haben wir bei der Auswahl der zu erreichenden Zielgruppe innerhalb der Standort-Targeting-Auswahl den Standort-Status der Zielgruppe zu unserer aktuellen Standardoption Personen, die an diesem Ort wohnen oder kürzlich dort waren konsolidiert. Diese Aktualisierung spiegelt eine Konsolidierung anderer zuvor verfügbarer Optionen sowie die Abschaffung der Option Personen, die diesen Ort besuchen wider.

Diese Änderung ist Teil unserer aktuellsten Maßnahmen, mit denen wir den Mehrwert und die Performance-Effizienz für Unternehmen steigern, unser Anzeigensystem vereinfachen, unsere Targeting-Optionen optimieren sowie wenig genutzte Optionen entfernen möchten.

Dieses Update gilt für neue und duplizierte Kampagnen. Bestehende Kampagnen, die vor der Einführung der neuen Version erstellt wurden, sind davon nicht betroffen, es sei denn, sie befinden sich im Entwurfsmodus oder werden dupliziert.

Hinzufügen von „add_security_recommendation“ und „code_expiration_minutes“ zur WhatsApp Message Templates API

Anfang des Jahres haben wir die Authentifizierungslösung von WhatsApp veröffentlicht. Sie ermöglicht das Erstellen und Versenden von Authentifizierungsvorlagen mit nativen Buttons und voreingestellten Authentifizierungsnachrichten. Mit der Einführung der Graph API v18 nehmen wir Verbesserungen beim Abruf von Authentifizierungsvorlagen vor, die den End-to-End-Prozess für Authentifizierungsvorlagen für BSPs und Unternehmen vereinfachen.

Mit der Graph API v18 können BSPs und Unternehmen den Inhalt voreingestellter Vorlagen für Authentifizierungsnachrichten nach der Erstellung besser einsehen. Insbesondere geben Payloads damit zusätzlich zu dem von WhatsApp verwendeten Text voreingestellte Konfigurationsoptionen aus. Dank dieser Verbesserung können BSPs und Unternehmen „Bearbeitungs“-UIs für Authentifizierungsvorlagen erstellen, die auf der API aufgebaut werden können.

Hinweis: Bei dem Upgrade auf die Graph API v18 können Fehler auftreten, wenn BSPs oder Unternehmen für die Aktualisierung von Vorlagen die gesamte Antwort der GET-Anfrage für die POST-Anfrage nutzen. Um dies zu beheben, sollten die Textfelder in Body/Header/Footer gelöscht werden, bevor sie wieder in die API gespeist werden.

Wiedereinführung von Entwicklungsdokumentation und Änderungsprotokollen für die Erstellung von Click-to-Call Ads

• Platzierung in Facebook Reels für Click-to-Call Ads
  Meta ermöglicht nun auch die Auslieferung von Click-to-Call Ads über die Facebook Reels-Plattform. Über Click-to-Call Ads können Nutzer*innen bei der Abwägung Unternehmen in dem Moment anrufen, in dem sie eine Anzeige sehen. Das ermöglicht es Unternehmen, komplexere Unterhaltungen mit interessierten Nutzer*innen zu führen. Nun haben Unternehmen außerdem die Möglichkeit, Click-to-Call Ads auf der Grundlage des Echtzeitverhaltens von Nutzer*innen auf Facebook zu schalten. Auf Anzeigengruppenebene im Werbeanzeigenmanager können Unternehmen jetzt „Facebook Reels“ im Abschnitt „Platzierungen“ hinzufügen.
• Wiedereinführung von Click-to-Call Ads über die API
  Am 12. September 2023 stellen wir eine aktualisierte Anleitung zur Erstellung von Click-to-Call Ads über die API zur Verfügung. Wir führen eine Dokumentation ausschließlich für Click-to-Call Ads ein, damit 3P-Entwickler*innen einfacher eine Click-to-Call-Kampagne erstellen können und wissen, wie sie Insights in ihre laufenden Click-to-Call-Kampagnen erhalten, einschließlicher anrufbezogener Kennzahlen. In Zukunft planen wir auch die Unterstützung von Anruf-Add-ons über unsere API-Plattform. Entwickler*innen sollten Zugang zu den allgemeinen Berechtigungen haben, die für die Erstellung allgemeiner Anzeigen erforderlich sind, um auch Click-to-Call Ads über die API-Plattform erstellen zu können.
  
  Weitere Informationen findest du in der Entwicklungsdokumentation.

Eingestellte Features und funktionsgefährdende Änderungen

Graph API-Änderungen für die granulare Nutzungsberechtigung

Wir aktualisieren zwei Graph API-Endpunkte für WhatsApp-Unternehmenskonten. Dabei handelt es sich um folgende Endpunkte:

• Abrufen von Nachrichtenvorlagen, die mit dem WhatsApp-Unternehmenskonto verbunden sind
• Abrufen von Telefonnummern, die mit dem WhatsApp-Unternehmenskonto verbunden sind

Mit v18 führen wir eine neue Funktion ein: „granulare Nutzungsberechtigung“. Alle bestehenden Nutzer*innen, die bereits zum WhatsApp-Unternehmenskonto hinzugefügt wurden, werden ersetzt und haben weiterhin Zugriff (keine Auswirkungen).

Der*Die Admin hat die Möglichkeit, diese Berechtigungen zu ändern. Wenn der*die Admin die Berechtigung ändert und einem*einer Nutzer*in den Zugriff auf die Nachrichtenvorlagen oder Telefonnummer entzieht, erhält diese*r Nutzer*in eine Fehlermeldung, die besagt, dass er*sie keine Berechtigung zum Ansehen dieser Nachrichtenvorlagen oder Telefonnummern in allen Versionen bis v18 hat.

Entfernung veralteter Benennungen von Kennzahlen für IG Media und Nutzungs-Insights

Ab dem 12. September wird Instagram doppelte und veraltete Insights-Kennzahlen aus der Instagram Graph API entfernen und unseren Entwickler*innen nur noch eine einzige Quelle für Kennzahlen zur Verfügung stellen.

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

Nach 90 Tagen (d. h. am 11. Dezember 2023) werden wir diese doppelten und veralteten Insights-Kennzahlen in allen Versionen aus der Instagram Graph API entfernen, um eine größere Konsistenz mit der Instagram-App zu erreichen.

Wir bedanken uns für das Feedback, das wir aus der Entwickler*innen-Community erhalten haben, und freuen uns auf die weitere Zusammenarbeit.

In der Entwicklungsdokumentationen zu Medien-Insights und Nutzungs-Insights findest du weitere Informationen.

Entfernung aller Endpunkte für Facebook Wi-Fi v1 und Facebook Wi-Fi v2

Facebook Wi-Fi wurde entwickelt, um die Verbindung zu WLAN-Hotspots in Unternehmen und Geschäften zu verbessern. Damit konnten Kund*innen eines Händlers kostenloses WLAN nutzen, indem sie sich auf Facebook den Ort hinzufügten. Außerdem ermöglichte es Händlern, zu kontrollieren, wer wie lange ihr WLAN nutzte, und sie konnten Anzeigen integrieren, um Kund*innen anzusprechen, die ihr WLAN genutzt hatten. Dieses Produkt lief am 12. Juni 2023 aus. Nach Ablauf der Kündigungsfrist für Partner wurden alle von Facebook Wi-Fi v1 und Facebook Wi-Fi v2 verwendeten Endpunkte entfernt.

Eingestellte API-Versionen:

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

Graph API

• 14. September 2023: Graph API v11.0 wird eingestellt und von der Plattform entfernt
• 8. Februar 2024: Graph API v12.0 wird eingestellt und von der Plattform entfernt
• 28. Mai 2024: Graph API v13.0 wird eingestellt und von der Plattform entfernt

Marketing API

• 20. September 2023: Marketing API v14.0 wird eingestellt und von der Plattform entfernt
• 20. September 2023: Marketing API v15.0 wird eingestellt und von der Plattform entfernt
• 6. Februar 2024: Marketing API v16.0 wird eingestellt und von der Plattform entfernt

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

Facebook Platform SDK

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

• Oktober 2023: Facebook Platform SDK v11.0 oder niedriger wird eingestellt
• Februar 2024: Platform SDK v12.0 oder niedriger wird eingestellt