광고 볼륨

광고 계정에서 게재 중이거나 검토 중인 광고 볼륨을 확인하세요. 이러한 광고는 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}]}

광고 볼륨 관리에 대한 자세한 내용은 광고 볼륨 관리 정보를 참조하세요.

게재 중 또는 검토 중 상태

광고가 게재 중이거나 검토 중인지 확인하기 위해 Facebook에서는 effective_statusconfigured_status 광고 계정 상태를 차례로 확인합니다.

  • 광고의 effective_status1 - active인 경우 해당 광고가 게재 중 또는 검토 중인 것으로 간주합니다.
  • 광고의 configured_statusactive이고 effective_status9 - 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": [
      ]
    }
  ],
}

지원되는 필드

필드설명

actor_id

제한이 적용되는 배우를 적용합니다. 현재는 언제나 페이지 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

광고 계정이 비즈니스 관리자에 속하고 광고 계정이 비즈니스 관리자 수준 광고 제한이 적용되는 경우에 사용합니다.


이 필드에는 광고 계정에 광고 제한을 정의하는 비즈니스의 비즈니스 관리자 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

특정 배우 ID에 대한 현재의 광고 제한. 이 제한은 게재 중이거나 검토 중인 광고 수와 관련이 있습니다.

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

자세한 내용은 광고 볼륨 관리를 참조하세요.