Übersicht

Die Marketing API ist eine HTTP-basierte API, mit der du programmgesteuert Daten abfragen, Werbeanzeigen erstellen und verwalten und zahlreiche andere Aufgaben ausführen kannst. In diesem Abschnitt findest du allgemeine Informationen zu den Marketing APIs, zum Zugriff, zur Versionierung usw.

Da die API HTTP-basiert ist, funktioniert sie mit jeder Sprache oder Software, die HTTP unterstützen, einschließlich cURL und fast allen modernen Web-Browsern. Die Marketing API ist auf der Graph API von Meta aufgesetzt, so dass fast alle Anfragen an die graph.facebook.com-Host-URL übergeben werden müssen.

Grundlegende Konzepte

Konzepte, die du kennen solltest, um die Marketing API zu nutzen:

Werbekampagnenstruktur

Die Kampagnenstruktur von Meta umfasst drei Ebenen: Kampagne, Werbeanzeigengruppe und Werbeanzeige. In der API haben Entwickler*innen Zugriff auf eine vierte Ebene, die Anzeigengestaltung.

Autorisierung

Um auf Endpunkte der Marketing API zuzugreifen, muss deine App mehrere Ebenen der Graph API-Autorisierung durchlaufen.

Authentifizierung

Erfahre hier, wie du den für deine API-Aufrufe benötigten Zugriffsschlüssel abrufst und speicherst.

Durchsatzratenbegrenzung

Die Marketing API weist eine eigene Logik zur Durchsatzratenbegrenzung auf und ist von allen Graph API-Durchsatzratenbegrenzungen ausgeschlossen.

Versionierung

Metas Plattform verfügt über die Versionierungsmodelle „Core“ und „Extended“. Erfahre mehr über bevorstehende Änderungen und veraltete Elemente anhand unserer Versionierungs- und Migrationssysteme. Siehe Versionszeitpläne, Migrationen und Änderungsprotokoll.

App Review

Um die Marketing API nutzen zu können, muss deine App den App-Review durchlaufen. Dies gilt nicht für die serverseitige API und Offline-Conversions.

Berechtigungen

Es gibt zwei Hauptberechtigungen für Werbeanzeigen: ads_management und ads_read. Berechtigungen müssen für die App erteilt werden, die du für deine Anrufe verwendest. Berechtigungen können während des App-Review-Prozesses angefordert werden. Sieh dir die Liste verfügbarer Berechtigungen für Business-Apps an.

Fehlercodes

Bei der Nutzung der API werden möglicherweise Fehlercodes angezeigt. Nutze diese als Referenz, um mehr über die einzelnen Fehlercodes zu erfahren.

Nachbearbeitung

Lerne die Nachverarbeitungsphase nach Eingang einer Anfrage bei Meta kennen.