Volumen de anuncios

Consulta del volumen de anuncios de la 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 la administración del volumen de anuncios, consulta Información sobre la administración del volumen de anuncios.

Visualización del estado en circulación o en revisión

Para ver si un anuncio está en circulación o en revisión, se debe consultar effective_status y, a continuación, configured_status y el estado de la cuenta publicitaria:

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

También se determina si un anuncio está en circulación o en revisión según la programación del conjunto de anuncios:

• Si la hora de inicio es anterior a la hora actual y la hora actual es anterior a la hora de finalización, se considera 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 se considera que está en circulación o en revisión.

Por ejemplo, si el conjunto de anuncios está programado para ponerse en circulación en el futuro, los anuncios no están en circulación ni en revisión. No obstante, si el conjunto de anuncios está programado para ponerse en circulación desde ahora hasta dentro de tres meses, se considera que los anuncios están en circulación o en revisión.

Si utilizas funciones de programación de anuncios especiales, como la entrega según franjas del día, se considera que el anuncio está en circulación o en revisión todo el día, no solo durante la franja del día en que el anuncio se pone en circulación.

Desglose por actores

Utiliza el campo show_breakdown_by_actor para obtener un desglose de límites de anuncios por 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": [
      ]
    }
  ],
}

Utiliza el page_id para obtener los límites de anuncios para una página concreta:

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

Parámetros