Anzeigenvolumen

Sieh für deine Werbekonten das Volumen der Anzeigen an, die laufen oder überprüft werden. Diese Anzeigen werden mit der Anzeigenbeschränkung pro Seite abgeglichen, die wir Anfang 2021 eingeführt haben. Frage für ein bestimmtes Werbekonto die Anzahl der Anzeigen ab, die laufen oder überprüft werden.

Anzeigen des Anzeigenvolumens für dein Werbekonto

So zeigst du das Anzeigenvolumen für dein Werbekonto an:

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

Antwort

{"data":[{"ads_running_or_in_review_count":2}]}

Informationen zum Verwalten des Anzeigenvolumens findest du unter Anzahl der Werbeanzeigen verwalten.

Anzeigen des Status „Läuft“ oder „Wird überprüft“

Um zu überprüfen, ob eine Anzeige läuft oder überprüft wird, prüfen wir effective_status, dann configured_status und dann den Status des Kontos:

  • Wenn eine Anzeige den effective_status1 - active aufweist, bedeutet das für uns den Status „Läuft“ oder „Wird überprüft“.
  • Wenn eine Anzeige den configured_statusactive und den effective_status9 - pending review oder 17 - pending processing hat, bedeutet das für uns Läuft oder Wird überprüft.
  • Die Anzeige kann nur dann den Status Läuft oder Wird überprüft haben, wenn das Werbekonto den Status 1 - active, 8 - pending settlement oder 9 - in grace period hat.

Wir ermitteln außerdem anhand des Zeitplans der Anzeigengruppe, ob eine Anzeige läuft oder überprüft wird:

  • Wenn die Startzeit vor der aktuellen Zeit und die aktuelle Zeit vor der Endzeit liegt, gehen wir davon aus, dass die Anzeige läuft oder überprüft wird.
  • Wenn die Startzeit vor der aktuellen Zeit liegt und die Anzeigengruppe keine Endzeit hat, gehen wir auch davon aus, dass sie läuft oder überprüft wird.

Wenn die Anzeigengruppe beispielsweise in der Zukunft ausgeführt werden soll, laufen die Anzeigen nicht und werden nicht überprüft. Wenn die Anzeigengruppe beispielsweise ab dem jetzigen Zeitpunkt bis in 3 Monaten ausgeführt werden soll, gehen wir davon aus, dass die Anzeigen laufen oder überprüft werden.

Wenn du spezielle Funktionen zur Anzeigenterminierung verwendest, wie zum Beispiel Tagestrennung, gehen wir davon aus, dass die Anzeige den ganzen Tag läuft oder überprüft wird und nicht nur für den Teil des Tages, ab dem die Anzeige läuft.

Aufschlüsselung nach Kategorien

Rufe mit dem Feld show_breakdown_by_actor eine Aufschlüsselung von Anzeigenbeschränkungen nach einer bestimmten actor_id auf:

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

Antwort

{
  "data": [
    {
      "ads_running_or_in_review_count": 0,
      "current_account_ads_running_or_in_review_count": 0,
      "actor_id": "<ACTOR_ID_1>",
      "recommendations": [
      ]
    },
    {
      "ads_running_or_in_review_count": 2,
      "current_account_ads_running_or_in_review_count": 2,
      "actor_id": "<ACTOR_ID_2>",
      "recommendations": [
      ]
    }
  ],
}

Rufe mit page_id die Anzeigebeschränkungen für eine bestimmte Seite ab:

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

Antwort

{
  "data": [
    {
      "ads_running_or_in_review_count": 2,
      "current_account_ads_running_or_in_review_count": 2,
      "actor_id": "<ACTOR_ID>",
      "recommendations": [
      ]
    }
  ],
}

Unterstützte Felder

FeldBeschreibung

actor_id

Kategorie, auf die diese Einschränkung angewendet wird. Das ist derzeit immer die Seiten-ID.

ads_running_or_in_review_count

Anzahl der Anzeigen, die für eine bestimmte Kategorie laufen oder überprüft werden.

current_account_ads_running_or_in_review_count

Anzahl der Anzeigen, die im aktuellen Werbekonto für eine bestimmte Kategorie laufen oder überprüft werden.

actor_name

Kategorie, für die das Anzeigenvolumen erfasst wird. Aktuell wird nur der Seitenname unterstützt.

ad_limit_scope_business

Wird in Fällen verwendet, in denen ein Werbekonto zu einem Business Manager gehört und das Werbekonto den Anzeigenbeschränkungen auf Business Manager-Ebene unterliegt.


Dieses Feld enthält das Unternehmen, das die Anzeigenbeschränkungen für ein Werbekonto definiert.

ad_limit_scope_business_manager_id

Wird in Fällen verwendet, in denen ein Werbekonto zu einem Business Manager gehört und das Werbekonto den Anzeigenbeschränkungen auf Business Manager-Ebene unterliegt.


Dieses Feld enthält die Business Manager-ID für ein Unternehmen, das die Anzeigenbeschränkungen für ein Werbekonto definiert.

ad_limit_set_by_page_admin

Die von einem*einer Seitenadmin festgelegte Anzeigenbeschränkung für das Unternehmen, dem das Werbekonto gehört.

ads_running_or_in_review_count_subject_to_limit_set_by_page

Anzahl der Anzeigen, die laufen oder überprüft werden, für eine Gruppe von Werbekonten. In diesem Fall kann die Gruppe Werbekonten von Einzelpersonen oder Unternehmen enthalten.


Wird die Anzeigenbeschränkung nicht von dem*der Seiteninhaber*in festgelegt, wird null zurückgegeben.


Wird die Anzeigenbeschränkung von dem*der Seiteninhaber*in festgelegt, wird die Anzahl der laufenden oder in Überprüfung befindlichen Anzeigen für die Werbekontogruppe zurückgegeben.

future_limit_activation_date

Startdatum der Anzeigenbeschränkung, das in der Zukunft aktiviert wird.

future_limit_on_ads_running_or_in_review

Anzeigenbeschränkung, die in der Zukunft aktiviert wird. Diese Beschränkung bezieht sich auf die Anzahl der Anzeigen, die für die jeweilige Kategorie laufen oder überprüft werden.

limit_on_ads_running_or_in_review

Aktuelle Anzeigenbeschränkung für die jeweilige Kategorien-ID. Diese Beschränkung bezieht sich auf die Anzahl der Anzeigen, die laufen oder überprüft werden.

recommendations

Empfehlungen zur Verringerung des Anzeigenvolumens. Derzeit werden die folgenden Werte unterstützt:

  • zero_impression
  • learning_limited
  • top_campaigns_with_ads_under_cap
  • top_adsets_with_ads_under_cap

Weitere Informationen findest du im Hilfebereich für Unternehmen.

Parameter

FeldBeschreibung

recommendation_type

Art der Empfehlung zur Verringerung des Anzeigenvolumens. Derzeit werden die folgenden Werte unterstützt:

  • zero_impression
  • learning_limited
  • top_campaigns_with_ads_under_cap
  • top_adsets_with_ads_under_cap

Weitere Informationen zur Verwaltung des Anzeigenvolumens.