Beispieleinreichung für Marketing API

Angenommen, du entwickelst eine browserbasierte App, mit der deine Kunden Werbeanzeigen erstellen und auf Facebook schalten können. Damit deine App über die Marketing API auf Werbekonten, Kampagnen und Produktkataloge deiner Kunden zugreifen kann, muss sie für die Zugriffsebene Standardzugriff für das Anzeigenmanagement sowie für die Berechtigungen ads_management, pages_read_engagement und catalog_management genehmigt werden.

Nachdem du das Marketing API-Produkt hinzugefügt und konfiguriert, Facebook Login implementiert und bestätigt hast, dass deine App Daten entsprechend den Plattform-Nutzungsbedingungen von Facebook und unseren Entwickler-Richtlinien verwendet, beginnst du den App Review-Prozess, damit du deine App live schalten kannst.

Schritt 1: Berechtigungen hinzufügen

Du meldest sich beim App-Dashboard an und klickst auf App Review und dann auf Berechtigungen und Features.

Du suchst „ads_management“, um „ads_management“ und „Standardzugriff für das Anzeigenmanagement“ zu finden, und forderst beide an. Du suchst „add pages_read_engagement“ und „catalog_management“, fügst beide Berechtigungen hinzu und setzt die Anfrage fort.

Schritt 2: Datennutzung beschreiben

An dieser Stelle beschreibst du, wie deine App die Daten verwendet, auf die du Zugriff anforderst. Du klickst im Bereich Anfragen auf Anfrage bearbeiten.

Du klickst auf das Pfeil-Symbol in der Zeile Gib an, wie du ads_management verwenden wirst.

Du gibst eine allgemeine Beschreibung der Funktionen deiner App an und erklärst dann, wie die Berechtigung „ads_management“ den Nutzern deiner App hilft. Du gibst die folgende Beschreibung im Abschnitt Teile uns mit, weshalb du ads_management beantragst ein:

„Die App wird von Werbekunden-Managern verwendet, um Werbekampagnen anzulegen, Werbeanzeigen zu verwalten und Berichte anzuzeigen, die Kennzahlen zu den Anzeigen enthalten. Mithilfe der Berechtigung „ads_management“ können sie Daten zu bestehenden Facebook-Werbeanzeigen abrufen und Werbeanzeigen erstellen. Ohne diese Berechtigung funktioniert die App nicht.“

Schritt 3: Eine Bildschirmaufzeichnung hochladen

Du klickst im Abschnitt Screencast hochladen auf Datei hochladen und lädst eine kurze, eineinhalbminütige Bildschirmaufzeichnung eines Nutzers hoch, der sich bei deiner App anmeldet und eine Funktionalität verwendet, die die Berechtigung „ads_management“ benötigt.

Du lädst diese Bildschirmaufzeichnung hoch:

Etwas ist schiefgelaufen
Leider kann dieses Video nicht richtig abgespielt werden.

Dann speicherst du deine Änderungen und wiederholst diese Schritte für die Berechtigungen „pages_read_engagement“ und „catalog_management“ und die Zugriffsebene Standardzugriff für das Anzeigenmanagement.

Schritt 4: App-Verifizierung abschließen

Um den Prozess der App-Verifizierung abzuschließen, klicke auf den Pfeil in der Zeile Verifizierungsdetails angeben.

Klicke auf Ja, um den Facebook-Plattform-Richtlinien zuzustimmen.

Gib dann Anweisungen an, die wir befolgen können, um zu verifizieren, dass deine App die von dir angeforderten Berechtigungen und Features so verwendet, wie du es beschreibst. Gib auch an, an welcher Stelle in der von dir hochgeladenen Bildschirmaufzeichnung dies geschieht.

„So kannst du sehen, wie unsere App diese Berechtigungen verwendet:

  1. Gehe zu AdsApp.com.
  2. Melde dich mit unserem Facebook-Konto an.
  3. Klicke in unserer linken Navigationsleiste auf „Accounts“.
  4. Wähle „test_account“ aus. (Nutzer können mit der App andere Facebook-Werbekonten verknüpfen. Wir haben die App mit diesem Testkonto, das wir nur für den App Review eingerichtet haben, vorab aufgefüllt.)
  5. Dir sollte eine Seite angezeigt werden, auf der die Kampagnen aufgeführt werden, die mit diesem Konto verknüpft sind.
  6. Klicke auf „test_campaign“ und dann unter „Ad Set“ auf „Create“.
  7. Dir sollte eine Benutzeroberfläche angezeigt werden, auf der du eine neue Anzeigengruppe erstellen kannst.
  8. Klicke unter „Ads“ auf „Create“. Dir sollte eine Benutzeroberfläche angezeigt werden, auf der du eine neue Anzeige erstellen und auch Bilder oder Videos hochladen kannst.
  9. Kehre zur linken Navigationsleiste zurück und klicke auf „Reports“.
  10. Dir sollte ein Bildschirm angezeigt werden, auf dem du Einstellungen für Berichte vornehmen kannst.

In der beigefügten Bildschirmaufzeichnung wird gezeigt, wie „ads_management“ verwendet wird, wenn der Nutzer Anzeigeninformationen anzeigt oder ein neues Objekt gespeichert wird: z. B. bei 00:10, 00:18, 00:32, 1:12 und 1:19.“

Schritt 5: Einreichen

Du hast sämtliche Informationen angegeben, die wir benötigen, um zu verifizieren, dass deine App alle Berechtigungen und Features verwendet, deren Genehmigung du anforderst. Du kannst daher auf Zur Überprüfung einreichen klicken.