广告量

查看广告账户的广告量

如要查看您广告账户的广告量：

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

支持的字段

参数