Volume de publicités

Consulter le volume de publicités de votre compte publicitaire

Pour consulter le volume de publicités de votre compte publicitaire :

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

Réponse

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

Pour en savoir plus sur la gestion du volume de publicités, consultez À propos de la gestion du volume de publicités.

Afficher le statut des publicités

Pour savoir si une publicité est en cours de diffusion ou d’examen, nous vérifions effective_status, puis configured_status et le statut du compte publicitaire :

• Si la valeur de effective_status est 1 - active, nous considérons que le statut de la publicité est en cours de diffusion ou d’examen.
• Si la valeur de configured_status est active et si la valeur de effective_status est 9 - pending review ou 17 - pending processing, nous considérons que le statut de la publicité est en cours de diffusion ou en cours dʼexamen.
• La publicité peut être en cours de diffusion ou en cours d’examen uniquement si le statut du compte publicitaire est 1 - active, 8 - pending settlement ou 9 - in grace period.

Nous basons également notre évaluation du statut dʼune publicité sur le calendrier de lʼensemble de publicités :

• Si lʼheure de début est antérieure à lʼheure actuelle, elle-même antérieure à lʼheure de fin, nous considérons que la publicité est en cours de diffusion ou dʼexamen.
• Si lʼheure de début est antérieure à lʼheure actuelle et si aucune heure de fin nʼest définie pour lʼensemble de publicités, nous considérons également que la publicité est en cours de diffusion ou dʼexamen.

Si, par exemple, la diffusion de lʼensemble de publicités est programmée pour plus tard, les publicités ne sont pas en cours de diffusion ou dʼexamen. Toutefois, si lʼensemble de publicités doit être diffusé à partir dʼaujourdʼhui et pendant trois mois, nous considérons que les publicités sont en cours de diffusion ou dʼexamen.

Si vous utilisez des fonctionnalités spéciales de planification des publicités, comme la répartition journalière, nous considérons que les publicités sont en cours de diffusion ou dʼexamen pour la journée entière, pas uniquement pour la durée de diffusion de la publicité au cours de la journée.

Répartition par acteurs

Utilisez le champ show_breakdown_by_actor pour obtenir la répartition des limites de publicités par actor_id spécifique :

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"

Réponse

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

Utilisez page_id pour obtenir les limites de publicités pour une page spécifique :

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"

Réponse

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

Champs pris en charge

Paramètres