Business Management APIs

Einrichten eines neuen untergeordneten Business Managers

Die zweistufige Business Manager-Lösung wurde ursprünglich entwickelt, damit mit jedem Nutzer*innen-Zugriffsschlüssel nur ein untergeordneter Business Manager erstellt werden konnte. Allerdings kann der*die Nutzer*in nun mehrere untergeordnete Business Manager erstellen, solange in jedem Business Manager eine Hauptseite festgelegt wird.

Hinweis: Abhängig davon, ob in den Einstellungen deiner App appsecret_proof aktiviert ist, kann appsecret_proof bei jedem Aufruf, den du tätigst, als Parameter erforderlich sein. Im Dokument Sichern von Graph API-Anfragen erfährst du, wie du diese Option festlegen und appsecret_proof generieren kannst.

Erste Schritte

Bevor du beginnst, empfehlen wir dir, die folgenden Anforderungen und Informationen zu lesen:

App-Berechtigungen

  • business_management
  • ads_management

IDs

  • PARENT_BM_ID: ID des Business Managers des Partners, der Eigentümer der App ist.
  • CHILD_BM_ID: ID des Business Managers, den der übergeordnete BM für den*die Kund*in erstellt.

Zugriffsschlüssel

  • USER_Personal_Access_Token: Der Zugriffsschlüssel der Person mit den Anmeldedaten zum Erstellen des untergeordneten BM.
    • Dieser Zugriffsschlüssel wird mit Facebook Login generiert.
    • Der Partner sollte globale business_management-Bereiche für die Unternehmen und Seiten des*er Kund'in anfordern, anstelle von granularen Bereichen.
    • Diese Person sollte über Admin-Berechtigungen für die Seite verfügen, die für den untergeordneten BM geteilt wird.
    • Wenn die Seite einem anderen BM gehört, sollte diese Person über Admin-Berechtigungen für den BM verfügen, der Eigentümer der Seite ist.
    • Dieser Schlüssel dient zum Autorisieren der Erstellung des untergeordneten BM und zum Teilen der Seite mit dem untergeordneten BM für Werbezwecke.
  • PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN: Der Zugriffsschlüssel des Admin-Systemnutzers im übergeordneten Business Manager.
    • Dieser Schlüssel wird zum Erstellen und Verwalten von untergeordneten BMs verwendet.
  • CHILD_BM_SYSTEM_USER_ACCESS_TOKEN: Der Zugriffsschlüssel des Admin-Systemnutzers, der im untergeordneten BM erstellt wurde.
    • Dieser Schlüssel wird zum Erstellen und Verwalten von Kampagnen und für andere Aktivitäten im untergeordneten BM verwendet.

Einen untergeordneten Business Manager erstellen

Erstelle mithilfe des USER_Personal_Access_Token einen untergeordneten Business Manager.

Beispiel – Gibt die ID eines untergeordneten Business Managers zurück

curl \
  -F 'id=<Parent_Business_Manager_ID>' \
  -F 'name=Advertisers child BM (recommend naming similar to page)' \
  -F 'vertical=OTHER' \ // Specify the Business vertical
  -F 'shared_page_id=<PAGE_ID_FROM_USER>' \  //Optional parameter but needed if you want to publish ads promoting this page
                                             //Note: the user must be an admin of the BM that owns this page if this page is owned
  -F 'page_permitted_tasks=["ADVERTISE", "ANALYZE"]' \
  -F 'timezone_id=1' \
  -F 'access_token=<USER_Personal_Access_Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<PARENT_BM_Id>/owned_businesses

Antwort:

{
    “ID” : “12312812123132”  //store this child business manager ID and associate to user
}

Erstellen mehrerer untergeordneter Business Manager pro Nutzer*in

Wenn der*die Nutzer*in mehrere untergeordnete Business Manager mit denselben Anmeldedaten erstellen möchte, muss die primary_page in bestehenden untergeordneten Business Managern festgelegt werden, die für den*die betreffende*n Nutzer*in erstellt wurden. Führe einen weiteren POST-Aufruf durch, um die primary_page des bestehenden untergeordneten Business Managers festzulegen:

curl \
  -F 'primary_page=<PAGE_ID>' \
  -F 'access_token=<USER_Personal_Access_Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<BM_ID>

Für das Erstellen eines weiteren untergeordneten Business Managers gilt Folgendes:

  • Alle bestehenden untergeordneten Business Manager müssen eine individuelle primary_page haben.
  • Die shared_page_id muss im neuen untergeordneten Business Manager festgelegt werden.
  • Wenn die shared_page_id zum Erstellen eines neuen untergeordnetes Business Managers verwendet wird, darf sie keine primary_page in einem der bestehenden untergeordneten Business Manager sein.

Zahlungsmethode einrichten

Um für die Werbeanzeigen des untergeordneten BM zu bezahlen, musst du deine Kreditlinie mit jedem untergeordneten BM teilen.


Schritt 1: Öffne eine Kreditlinie. Kontaktiere deine*n Facebook-Vertreter*in und öffne innerhalb dieses Business Managers eine LOC, sofern nicht bereits vorhanden. Die LOC wird in deinem übergeordneten Business Manager als Zahlungsmethode angezeigt.

Schritt 2: Stimme den Nutzungsbedingungen für die Kreditlinie zu.

  1. Öffne Business Manager > Unternehmenseinstellungen > Zahlungsmethoden.
  2. Klicke auf Krediteinstellungen und dann auf „Nutzungsbedingungen“. Stimme den Nutzungsbedingungen zu.

Schritt 3. Rufe die Kreditlinien-ID ab und teile sie mit dem untergeordneten Business Manager.

  1. Gehe zu deinem übergeordneten Business Manager und zu Unternehmenseinstellungen > Zahlungsmethoden. Klicke auf die Zahlungsmethode. Speichere die PARENT_BM_Line_Of_Credit_ID aus der URL. Die URL sollte in etwa wie folgt aussehen: 
    https://business.facebook.com/settings/payment-methods/<PARENT_BM_Line_Of_Credit_ID>?business_id=<BUSINESS_ID>
  2. Verwende diese Kreditlinien-ID des übergeordneten Business Managers in dem folgenden API-Aufruf, um die Kreditlinien-ID des übergeordneten Business Managers mit dem untergeordneten Business Manager zu teilen. Der amount ist optional. 
    curl \
  -F 'receiving_business_id=<CHILD_BUSINESS_MANAGER_ID>' \
  -F 'amount=<OPTIONAL_PARAMETER>' \  
  -F 'access_token=<Parent_BM_Admin_System_User_Access_Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<PARENT_BM_Line_Of_Credit_ID>/owning_credit_allocation_configs

Wenn du keinen Betrag angibst, wird deine Kreditlinie zu gleichen Teilen unter deinen untergeordneten Business Managern aufgeteilt.

Wenn du nur einen Betrag angibst, wird dieser Teil deiner Kreditlinie dem untergeordneten Business Manager zugewiesen.


Den untergeordneten Systemnutzer-Zugriffsschlüssel abrufen

Verwende unter dem untergeordneten Business Manager diesen API-Aufruf, um einen Systemnutzer zu erstellen und den Zugriffsschlüssel abzurufen. Dieser Zugriffsschlüssel wird für alle folgenden Aufrufe des untergeordneten Business Managers verwendet, um Anzeigen für diese*n Nutzer*in zu erstellen oder zu verwalten.

curl \
  -F 'id=<CHILD_BUSINESS_MANAGER>' \
  -F 'app_id=<App_ID>' \
  -F 'scope=ads_management,business_management' \
  -F 'access_token=<Parent BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET>' \
  https://graph.facebook.com/<API_VERSION>/<CHILD_BUSINESS_MANAGER_ID>/access_token

Die ID des Systemnutzers abrufen

Sobald du den Zugriffsschlüssel hast, kannst du damit die App-spezifische Nutzer-ID abrufen. Diese musst du für später aufbewahren.

curl -G \
  -d 'access_token=<Child BM System User Access Token>' \
  -d 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<CHILD_BM_ID>/system_users

Die Finanzierungsquellen-ID (LOC) abrufen

  1. Rufe die neue Finanzierungsquelle im untergeordneten Business Manager ab. Verwende in diesem Beispiel diese Finanzierungsquelle später, wenn du ein Werbekonto erstellst.
    2. curl -G \
  -d 'fields=id,max_balance' \
  -d 'access_token=<Child BM Admin System User Access Token>' \
  -d 'appsecret_proof=<APP_SECRET_PROOF>' \   // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<CHILD_BUSINESS_MANAGER_ID>/extendedcredits
    Alternativ kannst du die Finanzierungsquelle abrufen, wenn du in deinem untergeordneten Business Manager Zahlungen auswählst und dann auf die Methode Credit Line Payment (Kreditlinienzahlung) klickst. Dadurch wird die URL wie folgt mit einem Zahlungsparameter aufgefüllt: 
    payment-methods/<CHILD_PAYMENT_METHOD_ID>?business_id=
  2. Speichere diese Zahlungsmethoden-ID zur späteren Verwendung.

Mit der Standardfinanzierungsquelle ein neues Werbekonto erstellen

Verwende die Zahlungsmethoden-ID aus dem untergeordneten Business Manager als funding_id-Parameter.

funding_id kann nicht mehr aktualisiert werden, nachdem das Werbekonto erstellt wurde.

curl \
  -F 'name=Advertisers Ad Account' \
  -F 'currency=USD' \
  -F 'timezone_id=1' \
  -F 'end_advertiser=<PAGE_ID>' \
  -F 'media_agency=NONE' \
  -F 'partner=NONE' \
  -F 'funding_id=<PAYMENT_METHOD_ID(from above)>' \
  -F 'access_token=<Child BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/CHILD_BM_ID/adaccount

Den Systemnutzer als Admin zum neuen Werbekonto hinzufügen

Füge den Systemnutzer unter dem untergeordneten Business Manager als Admin zum neuen Werbekonto hinzu:

curl \
  -F 'user=<SYSTEM_USER_ID(from above)>' \
  -F 'tasks=MANAGE,ADVERTISE,ANALYZE' \
  -F 'business=<CHILD_BM_ID>' \
  -F 'access_token=<Child BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \   // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<act_ACCOUNT_ID>/assigned_users

Herzlichen Glückwunsch! Dies ist der letzte Schritt bei der Einrichtung eines untergeordneten Business Managers, um die Kampagnen deiner Kund*innen zu erstellen und zu verwalten.

Untergeordnete Business Manager finden

Um die IDs aller untergeordneten Business Manager zu finden, führe den folgenden Befehl aus. Damit wird nach der App-spezifischen Nutzer*innen-ID des*der Kund*in gefiltert:

curl -i -X GET \
  -F 'access_token=<PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
"https://graph.facebook.com/<API_VERSION>/<parent_bm_id>/owned_businesses?client_user_id=<Client’s app scoped user ID>

Finde die App-spezifische Nutzer*innen-ID mit /me?fields=ids_for_apps (Nutzer*innen-Zugriffsschlüssel des*der Kund*in).

Nächste Schritte

Die nächsten Themen umfassen zusätzliche Funktionen/Aktionen, mit denen du dein Business Manager-Erlebnis noch verbessern kannst.

Informationen zum Zugreifen auf Kund*innen-Assets in untergeordneten BMs findest du außerdem in Leitfäden zum Teilen von Assets: