Volume de anúncios

Ver volume da sua conta de anúncios

Para ver o volume de anúncios da sua conta:

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

Resposta

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

Consulte Sobre o gerenciamento do volume de anúncios para mais informações.

Verificar status em veiculação ou em análise

Para ver se um anúncio está em veiculação ou em análise, verifique effective_status, configured_status e o status da conta de anúncios:

• Se o effective_status de um anúncio for 1 - active, isso significa que o estado dele é em veiculação ou em análise.
• Se o configured_status de um anúncio for active e o effective_status for 9 - pending review ou 17 - pending processing, isso significa que o anúncio está em veiculação ou em análise.
• O anúncio só poderá estar em veiculação ou em análise se o status da conta de anúncio for 1 - active, 8 - pending settlement ou 9 - in grace period.

Também determinamos se um anúncio está em veiculação ou em análise com base na programação do conjunto de anúncios:

• Se a hora de início for anterior à atual e a hora atual for anterior à hora de término, isso significa que o anúncio está em veiculação ou em análise.
• Se a hora de início for anterior à atual e o conjunto de anúncios não tiver uma hora de término, isso também significa que o anúncio está em veiculação ou em análise.

Por exemplo, se a veiculação do conjunto de anúncios estiver programada para o futuro, isso significa que os anúncios não estão em veiculação ou em análise. No entanto, se a veiculação do conjunto de anúncios estiver programada entre agora e 3 meses no futuro, isso significa que os anúncios estão em veiculação ou em análise.

Se você estiver usando recursos especiais de programação de anúncios (como divisão do dia), consideraremos o anúncio como em veiculação ou em análise durante o dia todo, não só na parte do dia em que o anúncio começou a ser veiculado.

Detalhamento por atores

Use o campo show_breakdown_by_actor para obter um detalhamento dos limites de anúncios por um 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"

Resposta

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

Use page_id para obter os limites de anúncios de uma 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"

Resposta

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

Campos compatíveis

Parâmetros