Volumen de anuncios

Conoce el volumen de anuncios en circulación o en revisión de tus cuentas publicitarias. Estos anuncios se tienen en cuenta para el límite de anuncios por página que implementamos a principios de 2021. Consulta el número de anuncios en circulación o en revisión de una cuenta publicitaria específica.

Ver el volumen de anuncios de tu cuenta publicitaria

Para ver el volumen de anuncios de tu cuenta publicitaria:

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

Respuesta

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

Para obtener información sobre cómo administrar el volumen de anuncios, consulta Información sobre la administración del volumen de anuncios.

Ver si el anuncio está en circulación o en revisión

Para ver si un anuncio está en circulación o en revisión, revisamos effective_status y configured_status y, luego, el estado de la cuenta publicitaria:

  • Si un anuncio tiene effective_status con el valor 1 - active, consideramos que está en circulación o en revisión.
  • Si un anuncio tiene configured_status con el valor active y effective_status con el valor 9 - pending review o 17 - pending processing, consideramos que está en circulación o en revisión.
  • El anuncio puede estar en circulación o en revisión solo si el estado de la cuenta publicitaria es 1 - active, 8 - pending settlement o 9 - in grace period.

Además, tenemos en cuenta la programación del conjunto de anuncios para determinar si un anuncio está en circulación o en revisión:

  • Si la hora de inicio es anterior a la hora actual y la hora actual es anterior a la hora de finalización, consideramos que el anuncio está en circulación o en revisión.
  • Si la hora de inicio es anterior a la hora actual y el conjunto de anuncios no tiene hora de finalización, también consideramos que el anuncio está en circulación o en revisión.

Por ejemplo, si se programó la publicación del conjunto de anuncios en el futuro, los anuncios no se consideran en circulación ni en revisión. Sin embargo, si se programó la publicación del conjunto de anuncios desde ahora y hasta dentro de tres meses, los anuncios se consideran en circulación o en revisión.

Si usas funciones de programación de anuncios especiales (como las franjas del día), consideramos que el anuncio está en circulación o en revisión todo el día, no solo en el momento en que el anuncio se publica.

Desglose por actores

Usa el campo show_breakdown_by_actor para obtener un desglose de los límites de anuncios según un actor_id específico:

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"

Respuesta

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

Usa page_id para obtener los límites de anuncios de una página específica:

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"

Respuesta

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

Campos admitidos

CampoDescripción

actor_id

Actor que se tiene en cuenta para aplicar el límite. Por el momento, se trata siempre del identificador de la página.

ads_running_or_in_review_count

Número de anuncios en circulación o en revisión de un actor específico.

current_account_ads_running_or_in_review_count

Número de anuncios en circulación o en revisión de un actor específico dentro de la cuenta publicitaria actual.

actor_name

Actor sobre el que se acumula el volumen de anuncios. Por el momento, solo puede tratarse del nombre de una página.

ad_limit_scope_business

Se usa en los casos en que una cuenta publicitaria pertenece a un administrador comercial y esta cuenta está sujeta a los límites de anuncios de dicho administrador comercial.


Este campo contiene la empresa que define los límites de anuncios de una cuenta publicitaria.

ad_limit_scope_business_manager_id

Se usa en los casos en que una cuenta publicitaria pertenece a un administrador comercial y esta cuenta está sujeta a los límites de anuncios de dicho administrador comercial.


Este campo contiene el identificador del administrador comercial de una empresa que define los límites de anuncios de una cuenta publicitaria.

ad_limit_set_by_page_admin

Límite de anuncios que define el administrador de una página en relación con la empresa propietaria de la cuenta publicitaria.

ads_running_or_in_review_count_subject_to_limit_set_by_page

Número de anuncios en circulación o en revisión de un grupo de cuentas publicitarias. En este caso, el grupo puede contener cuentas publicitarias que pertenecen a una empresa o cuentas publicitarias de personas.


Si el propietario de la página no define un límite de anuncios, el valor que se devuelve es null.


Si el propietario de la página define el límite de anuncios, se devuelve el número de anuncios en circulación o en revisión del grupo de cuentas publicitarias.

future_limit_activation_date

Fecha de inicio del límite de anuncios que entrará en vigencia en el futuro.

future_limit_on_ads_running_or_in_review

Límite de anuncios que entrará en vigencia en el futuro. Este límite se relaciona con el número de anuncios en circulación o en revisión del actor en cuestión.

limit_on_ads_running_or_in_review

Límite de anuncios actual del identificador de un actor determinado. Este límite se relaciona con el número de anuncios en circulación o en revisión.

recommendations

Recomendaciones que ayudan a reducir el volumen de anuncios. Los valores que se admiten actualmente son los siguientes:

  • zero_impression
  • learning_limited
  • top_campaigns_with_ads_under_cap
  • top_adsets_with_ads_under_cap

Obtén más información en el servicio de ayuda para empresas.

Parámetros

CampoDescripción

recommendation_type

Tipo de recomendación para ayudar a reducir el volumen de anuncios. Los valores que se admiten actualmente son los siguientes:

  • zero_impression
  • learning_limited
  • top_campaigns_with_ads_under_cap
  • top_adsets_with_ads_under_cap

Obtén más información sobre cómo administrar el volumen de anuncios.