Volume Iklan

Lihat volume iklan yang ditayangkan atau sedang ditinjau untuk akun iklan Anda. Iklan ini dihitung dengan mengacu pada batas iklan per halaman yang kami tetapkan pada awal tahun 2021. Kueri jumlah iklan yang ditayangkan atau sedang ditinjau untuk akun iklan tertentu.

Melihat Volume Iklan Akun Iklan Anda

Untuk melihat volume iklan akun iklan Anda:

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

Tanggapan

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

Untuk informasi tentang pengelolaan volume iklan, lihat Tentang Pengelolaan Volume Iklan.

Melihat Status Aktif atau Sedang Ditinjau

Untuk melihat apakah iklan aktif atau sedang ditinjau, kami memeriksa effective_status, lalu configured_status, dan status akun iklan:

  • Jika iklan memiliki effective_status berupa 1 - active, kami menganggap statusnya aktif atau sedang ditinjau.
  • Jika iklan memiliki configured_status berupa active dan effective_status berupa 9 - pending review atau 17 - pending processing, kami menganggapnya aktif atau sedang ditinjau.
  • Iklan dapat dianggap aktif atau sedang ditinjau hanya jika status akun iklan 1 - active, 8 - pending settlement, atau 9 - in grace period.

Kami juga menentukan apakah iklan aktif atau sedang ditinjau berdasarkan jadwal set iklan:

  • Jika waktu mulai adalah sebelum waktu saat ini, dan waktu saat ini adalah sebelum waktu berakhir, kami menganggap iklan aktif atau sedang ditinjau.
  • Jika waktu mulai adalah sebelum waktu saat ini dan set iklan tidak memiliki waktu berakhir, kami juga menganggap iklan aktif atau sedang ditinjau.

Misalnya, jika set iklan dijadwalkan untuk aktif di masa mendatang, iklan tersebut tidak aktif atau sedang ditinjau. Namun, jika set iklan dijadwalkan untuk aktif dari sekarang sampai 3 bulan ke depan, kami menganggap iklan tersebut aktif atau sedang ditinjau.

Jika Anda menggunakan fitur penjadwalan iklan khusus, seperti penjadwalan iklan harian, kami menganggap iklan aktif atau sedang ditinjau sepanjang hari, bukan hanya pada waktu tertentu dalam hari tersebut ketika iklan mulai aktif.

Perincian menurut Aktor

Gunakan kolom show_breakdown_by_actor untuk mendapatkan perincian batas iklan menurut actor_id tertentu:

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"

Tanggapan

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

Gunakan page_id untuk mendapatkan batas iklan bagi halaman tertentu:

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"

Tanggapan

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

Kolom yang Didukung

KolomDeskripsi

actor_id

Aktor yang dikenai pemberlakuan batas. Saat ini, kolom ini selalu berupa ID halaman.

ads_running_or_in_review_count

Jumlah iklan aktif atau sedang ditinjau untuk aktor tertentu.

current_account_ads_running_or_in_review_count

Jumlah iklan aktif atau sedang ditinjau dalam akun iklan saat ini untuk aktor tertentu.

actor_name

Aktor yang volume iklannya diagregasi. Saat ini, kolom ini hanya dapat berupa nama halaman.

ad_limit_scope_business

Digunakan dalam kasus jika akun iklan merupakan milik Pengelola Bisnis dan akun iklan tunduk pada batas iklan level Pengelola Bisnis.


Kolom ini memiliki bisnis yang menentukan batas iklan bagi akun iklan.

ad_limit_scope_business_manager_id

Digunakan dalam kasus jika akun iklan merupakan milik Pengelola Bisnis dan akun iklan tunduk pada batas iklan level Pengelola Bisnis.


Kolom ini memiliki ID Pengelola Bisnis untuk bisnis yang menentukan batas iklan bagi akun iklan.

ad_limit_set_by_page_admin

Batas iklan yang diatur oleh admin halaman untuk bisnis yang memiliki akun iklan.

ads_running_or_in_review_count_subject_to_limit_set_by_page

Jumlah iklan aktif atau sedang ditinjau untuk grup akun iklan. Dalam hal ini, grup dapat berisi akun iklan milik bisnis atau akun iklan individu.


Jika batas iklan tidak diatur oleh pemilik halaman, akan mengembalikan null.


Jika batas iklan diatur oleh pemilik halaman, akan mengembalikan jumlah iklan aktif atau sedang ditinjau untuk grup akun iklan.

future_limit_activation_date

Tanggal mulai batas iklan yang akan efektif di masa mendatang.

future_limit_on_ads_running_or_in_review

Batas iklan yang akan efektif di masa mendatang. Batas ini berkaitan dengan jumlah iklan yang aktif atau sedang ditinjau untuk aktor tertentu.

limit_on_ads_running_or_in_review

Batas iklan saat ini untuk ID aktor tertentu. Batas ini berkaitan dengan jumlah iklan yang aktif atau sedang ditinjau.

recommendations

Rekomendasi untuk membantu mengurangi volume iklan. Nilai yang didukung saat ini adalah:

  • zero_impression
  • learning_limited
  • top_campaigns_with_ads_under_cap
  • top_adsets_with_ads_under_cap

Informasi selengkapnya dapat ditemukan di Pusat Bantuan Bisnis.

Parameter

KolomDeskripsi

recommendation_type

Jenis rekomendasi untuk membantu mengurangi volume iklan. Nilai yang didukung saat ini adalah:

  • zero_impression
  • learning_limited
  • top_campaigns_with_ads_under_cap
  • top_adsets_with_ads_under_cap

Lihat informasi selengkapnya tentang pengelolaan volume iklan.