Volumen de anuncios

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

Parámetros