Autorisierung
Im Rahmen des Autorisierungsprozesses werden die Nutzer*innen und Apps, die auf die Marketing API zugreifen werden, überprüft und es werden ihnen Berechtigungen erteilt.
App-Rollen
Im Dashboard deiner App kannst du nach Bedarf Rollen für dich selbst oder Teammitglieder festlegen: Admin, Entwickler*in, Tester*in.
Hinweis: Je nach Anwendungsfall musst du deine App zur Review einreichen, um Zugang zu bestimmten Berechtigungen im Zusammenhang mit der Anzeigenverwaltung zu erhalten.
Zugriffsebenen, Berechtigungen und Features
Business-Apps sind einer weiteren Ebene für die Graph API-Autorisierung namens Zugriffsebenen unterworfen. Bei der App-Review muss deine App außerdem bestimmte Berechtigungen und Features anfordern.
Auf jeder Ebene gelten Einschränkungen. Weitere Informationen findest du unter Zugriffsebenen und Features. Alle Entwickler*innen müssen Meta-Plattform-Nutzungsbedingungen und Entwicklungsrichtlinien einhalten. Aufrufe erfolgen auf ALLEN Zugriffsebenen für Produktionsdaten.
Feature-Zugriffsebenen
| Feature-Zugriffsebene | Beschreibung |
|---|---|
Business-Apps wird automatisch Standardzugriff für alle Berechtigungen und Features genehmigt, die für den App-Typ „Business“ verfügbar sind. Verwende diese Option am Anfang. Du kannst End-to-End-Workflows erstellen, bevor du volle Berechtigungen beantragst, und du kannst auf eine unbegrenzte Anzahl von Werbekonten zugreifen. Einige API-Aufrufe sind mit dem Standardzugriff möglicherweise nicht verfügbar, weil sie eventuell zu mehreren Konten gehören oder das betreffende Konto nicht programmgesteuert ermittelt werden kann. | |
Der erweiterte Zugriff muss für jede Berechtigung und jedes Feature einzeln den App-Review-Prozess durchlaufen.
Nach der Einreichung genehmigt Meta den Antrag oder lehnt ihn ab. Wenn deine App für den Standardzugriff nicht qualifiziert ist, erhältst du zusätzliche Informationen. Wenn der erweiterte Zugriff genehmigt wird, musst du Folgendes tun, damit du deinen Status beibehältst:
|
Deine aktuelle Zugriffsebene kannst du unter App-Dashboard > App-Review > Berechtigungen und Features prüfen.
Zugriff auf Marketing API im Vergleich zu Standardzugriffszuordnung für das Anzeigenmanagement
| Zugriff auf die Marketing API | Standardzugriff für das Anzeigenmanagement | Maßnahme |
|---|---|---|
Entwicklungszugriff | Standardzugriff | Standardmäßig |
Standardzugriff | Erweiterter Zugriff | In App-Dashboard beantragen |
Berechtigungen und Features
Welche Berechtigungen du anfordern musst, hängt von der API ab, auf die du zugreifen möchtest.
Wenn deine App nur dein Werbekonto verwaltet, reichen der Standardzugriff und die Berechtigungen ads_read und ads_management aus. Wenn deine App jedoch auch die Werbekonten anderer Nutzer*innen verwaltet, benötigst du erweiterten Zugriff sowie die Berechtigung ads_read und/oder ads_management. Siehe alle verfügbaren Berechtigungen für Business-Apps.
Welche Features du anfordern musst, hängt davon ab, wie du die APIs verwenden möchtest. Wenn du Anzeigen verwaltest, ist Standardzugriff für das Anzeigenmanagement ein häufig angefordertes Feature. Siehe alle verfügbaren Features für Business-Apps.
Um den erweiterten Zugriff für den Standardzugriff für das Anzeigenmanagement zu erhalten, muss deine App die folgenden Anforderungen erfüllen:
- Deine App muss in den letzten 15 Tagen mindestens 1.500 Marketing API-Aufrufe erfolgreich generiert haben.
- Deine App muss in den letzten 15 Tagen Marketing API-Aufrufe mit einer Fehlerrate von unter 10 % getätigt haben.
Wenn du die Werbeanzeigen für eine andere Person verwaltest, verwende den Parameter scope, um die Person um die Berechtigung ads_management oder ads_read zu bitten. Deine App erhält Zugriff, wenn die Person auf Erlauben klickt.
https://www.facebook.com/v21.0/dialog/oauth?
client_id=<YOUR_APP_ID>
&redirect_uri=<YOUR_URL>
&scope=ads_management
Hinweis: Gib bei der Eingabe für das Feld YOUR_URLYOUR_URL einen nachgestellten / ein (z. B. http://www.facebook.com/).
Beispiele
| Anwendungsfall | Anforderung |
|---|---|
Du möchtest Werbeanzeigen für Werbekonten lesen und verwalten, die dir gehören oder für die du den Zugriff von dem*der Kontoinhaber*in erhalten hast. |
|
Du möchtest Anzeigenberichte für Werbekonten lesen, die dir gehören oder für die du den Zugriff von dem*der Eigentümer*in des Werbekontos erhalten hast. |
|
Du möchtest Anzeigenberichte aus einer Gruppe von Kund*innen extrahieren und Anzeigen einer anderen Kund*innengruppe lesen und verwalten. |
|
Zugriffsebenen und Features
In der nachstehenden Tabelle ist dargestellt, wie sich die Ebenen Standardzugriff und erweiterter Zugriff auf das Feature „Standardzugriff für das Anzeigenmanagement“ auswirken.
| Standardzugriff | Erweiterter Zugriff | |
|---|---|---|
Kontobeschränkungen | Verwaltung einer unbegrenzten Zahl von Werbekonten. App-Administrator*innen oder Entwickler*innen können im Namen von Werbekonto-Administrator*innen oder Werbetreibenden API-Aufrufe durchführen. | Verwaltung einer unbegrenzten Zahl von Werbekonten unter der Annahme, dass für das Werbekonto die Berechtigung |
Ratenbegrenzungen | Starke Ratenbegrenzung pro Werbekonto. Nur zur Entwicklung. Nicht für Produktions-Apps, die von echten Werbetreibenden verwendet werden. | Geringfügige Ratenbegrenzung pro Werbekonto. |
Business Manager | Eingeschränkter Zugriff auf Business Manager- und Katalog-APIs. Kein Business Manager-Zugriff zur Verwaltung von Werbekonten, Nutzer*innenberechtigungen und Seiten. | Zugriff auf alle Business Manager- und Produktkatalog-APIs. |
Systembenutzer | Kann 1 Systemnutzer und 1 Admin-Systemnutzer erstellen. | Kann 10 Systemnutzer und 1 Admin-Systemnutzer erstellen. |
Seitenerstellung | Kann keine Seiten über die API erstellen. | Kann keine Seiten über die API erstellen. |
Zugriffsebenen im Vergleich zu Standardzugriff für das Anzeigenmanagement
Berechtigungen und Features für Apps verfügen über zwei verschiedene Zugriffsebenen: Standardzugriff und erweiterter Zugriff. Wir weisen darauf hin, dass sich der Begriff „Standardzugriff“ in diesem Zusammenhang nicht auf das Feature „Standardzugriff für das Anzeigenmanagement“ bezieht. Für den erweiterten Zugriff für den Standardzugriff im Anzeigenmanagement muss eine App nach wie vor die Review durchlaufen, um auf das Feature zugreifen zu können.
Unternehmensverifizierung
Die Unternehmensverifizierung ist ein Prozess, mit dem wir deine Identität als Unternehmen bestätigen können. Dies ist erforderlich, wenn deine App auf vertrauliche Daten zugreift. Erfahre mehr über die Unternehmensverifizierung.