廣告數量

查看您廣告帳戶當中有多少廣告的狀態為刊登中或審查中。這些廣告會計入我們由 2021 年年初起實施的每頁廣告限制。查詢指定廣告帳戶當中有多少廣告的狀態為刊登中或審查中。

查看您廣告帳戶的廣告數量

查看自家廣告帳戶廣告數量的方法:

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_status1 - active,其狀態則為刊登中或審查中
  • 如果廣告的 configured_statusactive,且 effective_status9 - pending review17 - pending processing,其狀態則為刊登中審查中
  • 只有當廣告帳戶狀態為 1 - active8 - pending settlement9 - 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": [
      ]
    }
  ],
}

支援的欄位

欄位說明

actor_id

受限制所限的操作者。目前一概顯示專頁編號。

ads_running_or_in_review_count

特定操作者有多少廣告處於刊登中或審查中的狀態。

current_account_ads_running_or_in_review_count

特定操作者在目前廣告帳戶內有多少廣告處於刊登中或審查中的狀態。

actor_name

廣告數量累計於哪位操作者名下。目前只可以為專頁編號。

ad_limit_scope_business

當廣告帳戶屬於企業管理平台所有,而且受限於企業管理平台級別的廣告限制時,便會使用此欄位。


此欄位包含企業資料,而此企業決定了廣告帳戶的廣告限制。

ad_limit_scope_business_manager_id

當廣告帳戶屬於企業管理平台所有,而且受限於企業管理平台級別的廣告限制時,便會使用此欄位。


此欄位包含企業的企業管理平台編號,而此企業決定了廣告帳戶的廣告限制。

ad_limit_set_by_page_admin

由擁有廣告帳戶的企業專頁管理員所設定的廣告限制。

ads_running_or_in_review_count_subject_to_limit_set_by_page

某個廣告帳戶群組有多少廣告處於刊登中或審查中的狀態。在此情況下,群組可包含企業廣告帳戶或個人廣告帳戶。


如果廣告限制並非由專頁擁有者所設定,則傳回 null


如果廣告限制是由專頁擁有者所設定,則傳回廣告帳戶群組有多少廣告處於刊登中或審查中的狀態。

future_limit_activation_date

將在未來生效的廣告限制開始日期。

future_limit_on_ads_running_or_in_review

將在未來生效的廣告限制。此限制與指定操作者處於刊登中或審查中狀態的廣告數量有關。

limit_on_ads_running_or_in_review

指定操作者編號目前的廣告限制。此限制與處於刊登中或審查中狀態的廣告數量有關。

recommendations

有助於減少廣告數量的推薦措施。目前支援的值如下:

  • zero_impression
  • learning_limited
  • top_campaigns_with_ads_under_cap
  • top_adsets_with_ads_under_cap

詳情請參閱企業商家幫助中心

參數

欄位說明

recommendation_type

有助減少廣告數量的推薦措施類型。目前支援的值如下:

  • zero_impression
  • learning_limited
  • top_campaigns_with_ads_under_cap
  • top_adsets_with_ads_under_cap

查看更多關於管理廣告數量的資訊。