Autorisierung

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

Ebene 1: App-Typen

Beim Erstellen einer Facebook-App wirst du gefragt, wie die App verwendet wird. Von dieser Auswahl hängt der Typ der App ab: Business, Gaming oder Keine. Siehe App-Typen.

Zum Zugreifen auf Marketing API-Endpunkte musst du eine Business-App erstellen. Siehe Verfügbare Produkte für Business-Apps.

Nach der Registrierung deiner App kannst du jeder Person, die über ein Entwicklungskonto verfügt und dich bei der Entwicklung unterstützt, Rollen zuweisen.

Ebene 2: 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.

Zugriffsebenen

Zugriffsebene	Beschreibung
Standardzugriff	Business-Apps erhalten automatisch die Standardzugriff-Genehmigung für alle Berechtigungen und Features, die für den Business-App-Typ verfügbar sind. Verwenden diese Option am Anfang. Du kannst Ende-zu-Ende-Workflows erstellen, bevor du vollständige Berechtigungen anforderst. 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.
Erweiterter Zugriff	Der erweiterte Zugriff muss für jede Berechtigung und jedes Feature einzeln den App-Review-Prozess durchlaufen. Um den erweiterten Zugriff anzufordern, gehe zum Dashboard deiner App und klicke auf App-Review > Berechtigungen und Features. Suche nach der Berechtigung oder dem Feature, auf die bzw. das du zugreifen möchtest, und klicke unter Aktion auf Erweiterten Zugriff anfordern. Du kannst ein oder mehrere Features auswählen. Nachdem du die Optionen ausgewählt hast, klicke auf Anfrage fortsetzen. Daraufhin wird ein Bildschirm angezeigt, der dich durch den Einreichungsprozess führt. Nach der Einreichung genehmigt Facebook 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, muss Folgendes zutreffen, damit du deinen Status beibehältst: 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.

Zugriffsebene

Beschreibung

Standardzugriff

Business-Apps erhalten automatisch die Standardzugriff-Genehmigung für alle Berechtigungen und Features, die für den Business-App-Typ verfügbar sind.

Verwenden diese Option am Anfang. Du kannst Ende-zu-Ende-Workflows erstellen, bevor du vollständige Berechtigungen anforderst. 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.

Erweiterter Zugriff

Der erweiterte Zugriff muss für jede Berechtigung und jedes Feature einzeln den App-Review-Prozess durchlaufen.

Um den erweiterten Zugriff anzufordern, gehe zum Dashboard deiner App und klicke auf App-Review > Berechtigungen und Features.

Suche nach der Berechtigung oder dem Feature, auf die bzw. das du zugreifen möchtest, und klicke unter Aktion auf Erweiterten Zugriff anfordern. Du kannst ein oder mehrere Features auswählen. Nachdem du die Optionen ausgewählt hast, klicke auf Anfrage fortsetzen. Daraufhin wird ein Bildschirm angezeigt, der dich durch den Einreichungsprozess führt.

Nach der Einreichung genehmigt Facebook 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, muss Folgendes zutreffen, damit du deinen Status beibehältst:

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.

Auf jeder Ebene gibt es Einschränkungen. Siehe Zugriffsebenen und Features. Alle Entwickler*innen müssen alle Facebook-Plattformrichtlinien und Entwicklungsrichtlinien einhalten. Aufrufe erfolgen auf ALLEN Zugriffsebenen für Produktionsdaten.

Deine aktuelle Zugriffsebene kannst du unter App-Dashboard > App-Review > Berechtigungen und Features überprüfen.

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. Für die Verwaltung von Werbeanzeigen wird häufig das Feature Ads Management Standard Access angefordert. 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 eine Person um die Berechtigung ads_management oder ads_read zu bitten. Deine App erhält Zugriff, wenn eine Person auf Erlauben klickt:

https://www.facebook.com/v19.0/dialog/oauth?
  client_id=<YOUR_APP_ID>
  &redirect_uri=<YOUR_URL>
  &scope=ads_management

Gib bei der Eingabe für das Feld YOUR_URL einen nachstehenden / 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 vom Kontoinhaber erhalten hast.	Berechtigung: `ads_management` Feature: `Ads Management Standard Access`
Du möchtest Anzeigenberichte für Werbekonten lesen, die dir gehören oder für die du den Zugriff vom Kontoinhaber erhalten hast.	Berechtigung: `ads_read` Feature: `Ads Management Standard Access`
Du möchtest Anzeigenberichte aus einer Gruppe von Kundinnen extrahieren und Anzeigen einer anderen Kundinnengruppe lesen und verwalten.	Berechtigungen: `ads_management` und `ads_read` Feature: `Ads Management Standard Access`

Zugriffsebenen und Features

In der nachstehenden Tabelle ist dargestellt, wie sich die Ebenen Standardzugriff und erweiterter Zugriff auf die Funktion Anzeigenmanagement-Standardzugriff auswirken.

	Standardzugriff	Erweiterter Zugriff
Kontobeschränkungen	Management einer unbegrenzten Zahl von Werbekonten. App-Administratorinnen oder Entwicklerinnen können im Namen von Werbekonto-Administratoren oder Werbetreibenden API-Aufrufe durchführen.	Management einer unbegrenzten Zahl von Werbekonten unter der Annahme, dass für das Werbekonto die Berechtigung `ads_read` bzw. `ads_management` erteilt wurde.
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 Produktkatalog-APIs. Kein Business Manager-Zugriff zur Verwaltung von Werbekonten, Nutzer*innenberechtigungen und Seiten.	Zugriff auf alle Business Manager- und Produktkatalog-APIs.
Systemnutzer	Kann 1 Systemnutzer und 1 Admin-Systemnutzer mit 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 den Review durchlaufen, um auf das Feature zugreifen zu können.

Ebene 3: 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.