Số lượng quảng cáo

Xem số lượng quảng cáo đang chạy hoặc đang được xét duyệt của các tài khoản quảng cáo mà bạn sở hữu. Những quảng cáo này được tính vào giới hạn quảng cáo trên mỗi trang mà chúng tôi đã đưa ra vào đầu năm 2021. Hãy truy vấn số lượng quảng cáo đang chạy hoặc đang được xét duyệt của một tài khoản quảng cáo cụ thể.

Xem số lượng quảng cáo của tài khoản quảng cáo

Cách xem số lượng quảng cáo của tài khoản quảng cáo:

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

Phản hồi

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

Hãy xem bài viết Giới thiệu về cách quản lý số lượng quảng cáo để biết thông tin về cách quản lý số lượng quảng cáo.

Xem trạng thái đang chạy hoặc đang được xét duyệt

Để xem liệu một quảng cáo có đang chạy hoặc đang được xét duyệt hay không, chúng tôi kiểm tra effective_status, configured_status và trạng thái của tài khoản quảng cáo:

  • Nếu quảng cáo có effective_status1 - active, chúng tôi sẽ xem quảng cáo đó là ở trạng thái đang chạy hoặc đang được xét duyệt.
  • Nếu quảng cáo có configured_statusactiveeffective_status9 - pending review hoặc 17 - pending processing, chúng tôi sẽ xem quảng cáo đó là ở trạng thái đang chạy hoặc đang được xét duyệt.
  • Quảng cáo chỉ có thể đang chạy hoặc đang được xét duyệt khi trạng thái của tài khoản quảng cáo là 1 - active, 8 - pending settlement hoặc 9 - in grace period.

Chúng tôi cũng dựa vào lịch chạy của nhóm quảng cáo để xác định xem một quảng cáo có đang chạy hoặc đang được xét duyệt hay không:

  • Nếu thời gian bắt đầu trước thời gian hiện tại và thời gian hiện tại trước thời gian kết thúc, chúng tôi sẽ xem quảng cáo đó là đang chạy hoặc đang được xét duyệt.
  • Nếu thời gian bắt đầu trước thời gian hiện tại và nhóm quảng cáo không có thời gian kết thúc, chúng tôi cũng sẽ xem quảng cáo đó là đang chạy hoặc đang được xét duyệt.

Ví dụ: nếu lịch chạy của nhóm quảng cáo là trong tương lai thì các quảng cáo đó hiện không chạy hoặc không được xét duyệt. Tuy nhiên, nếu lịch chạy của nhóm quảng cáo là từ giờ cho đến 3 tháng sau, chúng tôi sẽ xem các quảng cáo đó là đang chạy hoặc đang được xét duyệt.

Nếu bạn sử dụng các tính năng lên lịch quảng cáo đặc biệt, chẳng hạn như chia theo ngày, chúng tôi sẽ xem quảng cáo đó là đang chạy hoặc đang được xét duyệt trong cả ngày, chứ không chỉ một phần trong ngày khi quảng cáo bắt đầu chạy.

Số liệu chia nhỏ theo thành phần

Sử dụng trường show_breakdown_by_actor để lấy số liệu chia nhỏ về giới hạn quảng cáo theo actor_id cụ thể:

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"

Phản hồi

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

Sử dụng page_id để lấy giới hạn quảng cáo của một trang cụ thể:

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"

Phản hồi

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

Trường được hỗ trợ

TrườngMô tả

actor_id

Thành phần mà dựa vào đó để thực thi giới hạn. Hiện tại, thành phần này luôn là ID trang.

ads_running_or_in_review_count

Số lượng quảng cáo đang chạy hoặc đang được xét duyệt của một thành phần cụ thể.

current_account_ads_running_or_in_review_count

Số lượng quảng cáo đang chạy hoặc đang được xét duyệt trong tài khoản quảng cáo hiện tại trên một thành phần cụ thể.

actor_name

Thành phần mà dựa vào đó để tổng hợp số lượng quảng cáo. Hiện tại, thành phần này chỉ có thể là tên trang.

ad_limit_scope_business

Được dùng trong các trường hợp mà một tài khoản quảng cáo thuộc về Trình quản lý kinh doanh tài khoản quảng cáo đó phải tuân theo các giới hạn quảng cáo ở cấp độ Trình quản lý kinh doanh.


Trường này có doanh nghiệp xác định giới hạn quảng cáo của một tài khoản quảng cáo.

ad_limit_scope_business_manager_id

Được dùng trong các trường hợp mà một tài khoản quảng cáo thuộc về Trình quản lý kinh doanh tài khoản quảng cáo đó phải tuân theo các giới hạn quảng cáo ở cấp độ Trình quản lý kinh doanh.


Trường này có ID Trình quản lý kinh doanh của doanh nghiệp xác định giới hạn quảng cáo của một tài khoản quảng cáo.

ad_limit_set_by_page_admin

Giới hạn quảng cáo do quản trị viên trang đặt cho doanh nghiệp sở hữu tài khoản quảng cáo.

ads_running_or_in_review_count_subject_to_limit_set_by_page

Số lượng quảng cáo đang chạy hoặc đang được xét duyệt của một nhóm tài khoản quảng cáo. Trong trường hợp này, nhóm đó có thể chứa các tài khoản quảng cáo thuộc về một doanh nghiệp hoặc những tài khoản quảng cáo riêng lẻ.


Nếu người sở hữu trang không đặt giới hạn quảng cáo, hệ thống sẽ trả về null.


Nếu người sở hữu trang đặt giới hạn quảng cáo, hệ thống sẽ trả về số lượng quảng cáo đang chạy hoặc đang được xét duyệt của nhóm tài khoản quảng cáo.

future_limit_activation_date

Ngày bắt đầu của giới hạn quảng cáo sẽ có hiệu lực trong tương lai.

future_limit_on_ads_running_or_in_review

Giới hạn quảng cáo sẽ có hiệu lực trong tương lai. Giới hạn này liên quan đến số lượng quảng cáo đang chạy hoặc đang được xét duyệt của thành phần cụ thể.

limit_on_ads_running_or_in_review

Giới hạn quảng cáo hiện tại cho một ID thành phần cụ thể. Giới hạn này liên quan đến số lượng quảng cáo đang chạy hoặc đang được xét duyệt.

recommendations

Đề xuất giúp giảm số lượng quảng cáo. Hiện tại, các giá trị được hỗ trợ là:

  • zero_impression
  • learning_limited
  • top_campaigns_with_ads_under_cap
  • top_adsets_with_ads_under_cap

Bạn có thể xem thêm thông tin trong Trung tâm trợ giúp doanh nghiệp.

Thông số

TrườngMô tả

recommendation_type

Loại đề xuất giúp giảm số lượng quảng cáo. Hiện tại, các giá trị được hỗ trợ là:

  • zero_impression
  • learning_limited
  • top_campaigns_with_ads_under_cap
  • top_adsets_with_ads_under_cap

Xem thêm thông tin về cách quản lý số lượng quảng cáo.