廣告數量

查看廣告帳號的廣告數量

若要查看廣告帳號的廣告數量：

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

支援的欄位

參數