Количество объявлений

Просмотр количества объявлений для рекламного аккаунта

Чтобы посмотреть количество объявлений, выполните следующий запрос:

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

Ответ

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

Подробнее об управлении количеством объявлений см. в этой статье.

Просмотр рекламы со статусом "Текущий показ" или "На проверке"

Чтобы проверить статус рекламы, сначала нужно проверить effective_status, затем configured_status и статус рекламного аккаунта:

• если параметр объявления effective_status имеет значение 1 или active, оно находится в текущем показе или на проверке;
• если параметр объявления configured_status имеет значение active, а параметр effective_status имеет значение 9 (pending review) или 17 (pending processing), объявление находится в текущем показе или на проверке;
• объявление может быть в текущем показе или на проверке только тогда, когда рекламный аккаунт имеет статус 1 (active), 8 (pending settlement) или 9 (in grace period).

Статус рекламы также определяется по расписанию группы объявлений:

• если время начала раньше текущего, а текущее время раньше времени окончания, то объявление считается находящимся в текущем показе или на проверке;
• если время начала раньше текущего, а время окончания не задано, то объявление также считается находящимся в текущем показе или на проверке.

Например, если показ группы объявлений запланирован на будущее, то ее объявления не считаются находящимися в показе или на проверке. Но если показ группы начинается с текущего момента и длится 3 месяца, объявления считаются таковыми.

Если вы используете особые функции планирования показа рекламы, например почасовой показ, считается, что реклама находится в показе или на проверке весь день, а не только на момент показа.

Разбивка по агентам

Используйте поле show_breakdown_by_actor, чтобы получить разбивку ограничений рекламы по actor_id:

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"

Ответ

{
  "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": [
      ]
    }
  ],
}

Используйте поле page_id, чтобы получить ограничения рекламы для конкретной страницы:

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"

Ответ

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

Поддерживаемые поля

Параметры