Werbekonten

Als Unternehmens-Administrator kannst du Werbekonten beanspruchen, die zu einem Unternehmen gehören. So kannst du Personen ganz einfach den Werbekonten zuweisen, für die sie Zugriff benötigen. Du kannst deinen Werbekonten auch gemeinsame Finanzierungsquellen zuweisen.

Konten beanspruchen

Wenn du Werbekonten außerhalb eines Business Manager mit der Rolle Administrator verwaltest, kannst du diese Konten für dein Unternehmen beanspruchen. Das ist ein einmaliger Vorgang. Nach der Beanspruchung kannst du nur die Werbekonten in diesem Business Manager verwalten.

Werbeanzeigenkonten können nicht beansprucht werden.

Um ein Werbekonto für dein Unternehmen zu beanspruchen, benötigst du Werbekonto-ID im Format act_###. Sende eine POST-Anfrage: Der*die Anfragesteller*in muss ein*e Administrator*in des Unternehmens sein, das das Werbekonto beansprucht.

curl \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

Wenn du Administrator*in des Werbekontos bist, wird diese Beanspruchungsanfrage sofort genehmigt. Facebook gibt access_status mit dem Wert CONFIRMED zurück.

Wenn du ein*e Nutzer*in bist, der*die nicht über die richtigen Berechtigungen für das Werbekonto verfügt, senden wir eine Eigentumsanfrage an die Administrator*innen des Werbekontos. Die Antwort nach dem Senden der Anfrage enthält access_status mit dem Wert PENDING.

Um eine Eigentümeranfrage zu akzeptieren, musst du Administrator des Werbekontos sein, dich anmelden und die Anfrage im Werbeanzeigenmanager annehmen.

Kontozugriff anfordern

Die meisten Marketingfirmen müssen keine Werbekonten von ihren Kund*innen beanspruchen. Informationen zum Anfragen des Zugriffs auf Elemente, die anderen Business Managern gehören, findest du unter Business-to-Business-Funktionen.

Werbekonten erstellen

Zur Nutzung dieser API benötigst du ein gültiges Setup eines Unternehmens und einer Seite. Wenn du über unvollständige Werbekonten oder über Seiten verfügst, die nicht von Facebook veröffentlicht sind, kannst du kein neues Werbekonto erstellen.

Mit der Erstellung eines Kontos über die API können maximal 5 Werbekonten erstellt werden. Möchtest du mehr als 5 Anzeigenkonten erstellen, musst du das manuell tun.

Die folgenden Felder sind verfügbar:

Um ein neues Werbekonto für ein Unternehmen zu erstellen, musst du name, currency, timezone_id, end_advertiser, media_agency und partner angeben. Bitte beachte die folgenden Bedingungen:

• Bei media_agency und partner muss es sich um ein Facebook-Seiten-Alias, eine Facebook-Seiten-ID oder eine Facebook -App-ID handeln.
• Bei end_advertiser muss es sich um eine Unternehmens-ID handeln.

Wenn dein Werbekonto keine Werbetreibenden, Medienagenturen oder Partner hat, gib NONE an. Wenn dein Werbekonto einen Werbetreibenden, eine Medienagentur oder einen Partner hat, diese aber nicht als Seite oder App auf Facebook vertreten sind, gib UNFOUND an.

So erstellst du ein Werbekonto:

curl \
  -F "name=MyAdAccount" \
  -F "currency=USD" \
  -F "timezone_id=1" \
  -F "end_advertiser=<END_ADVERTISER_ID>" \
  -F "media_agency=<MEDIA_AGENCY_ID>" \
  -F "partner=NONE" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/adaccount"

Wenn du bereits eine erweiterte Kreditlinie bei Facebook hast, kannst du invoice auf true setzen. Dann verknüpfen wir dein neues Werbekonto mit deiner erweiterten Kreditlinie.

Die Antwort sieht folgendermaßen aus:

{
  "id": "act_<ADACCOUNT_ID>",
  "account_id": "<ADACCOUNT_ID>",
  "business_id": "<BUSINESS_ID>",
  "end_advertiser_id": "<END_ADVERTISER_ID>",
  "media_agency_id": "<MEDIA_AGENCY_ID>",
  "partner_id": "NONE"
}

Eigene Konten ansehen

Sieh dir alle Werbekonten, auf die dein Unternehmen zugreifen kann, mit einer GET-Anfrage an:

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

Dabei werden alle Werbekonten eines Unternehmens zurückgegeben. Einige Felder gelten speziell für die Beziehung zwischen Unternehmen und Werbekonto.

• permitted_tasks ist ein Array der Aufgaben, die du für das jeweilige Werbekonto zuweisen kannst.
• access_type legt fest, ob dein Unternehmen als OWNER oder AGENCY des Werbekontos handelt.

Um Werbekonten mit ausstehendem Zugriff anzuzeigen, tätige diesen GET-Aufruf:

curl -G \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_owned_ad_accounts"

Konten entfernen

Wenn du OWNER bist und die Konten CONFIRMED sind, kannst du keine Werbekonten von deinem Unternehmen entfernen. Wenn die Zugriffsanfrage den Status PENDING aufweist oder du AGENCY-Zugriff für das Werbekonto hast, kannst du diesen DELETE-Aufruf tätigen:

curl \
  -X DELETE \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_accounts"

Kontozugriff ansehen

Verwende diesen GET-Aufruf, um die Werbekonten anzuzeigen, für die jemand Berechtigungen hat:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_ad_accounts"

Tätige diesen GET-Aufruf, um die Berechtigungen anzuzeigen, die jemand für ein Werbekonto hat:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

Personen zu Konten hinzufügen

Nachdem dein Business Manager einem Werbekonto zugewiesen wurde, kannst du anderen Business-Nutzer*innen Aufgaben zuweisen. Mögliche Aufgaben:

Voraussetzungen:

• adaccount_id: die Werbekonto-ID im Format act_123
• user_id: die hinzuzufügende Nutzer-ID
• Aufgaben zur Zuweisung

Führe zum Hinzufügen eines neuen Nutzers mit den Aufgaben ['MANAGE', 'ADVERTISE', 'ANALYZE'] diesen POST-Anruf aus:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'ADVERTISE', 'ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

Berechtigungen für Konten ändern

Zum Ändern der Ausgaben eines vorhandenen Nutzers verwendest du denselben POST-Aufruf wie zum Hinzufügen eines neuen Nutzers:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

Personen von Werbekonten entfernen

Du benötigst Folgendes, um jemanden von einem Konto zu entfernen:

• adaccount_id: die Werbekonto-ID im Format act_123
• user_id: die zu entfernende Nutzer-ID

Der DELETE-Anruf lautet:

curl \
  -X DELETE \
  -F "user=<BUSINESS_SCOPED_USER_ID>" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"