Volume di inserzioni

Visualizza il volume di inserzioni per il tuo account pubblicitario

Per visualizzare il volume di inserzioni per il tuo account pubblicitario:

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

Risposta

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

Per informazioni sulla gestione del volume di inserzioni, consulta Informazioni sulla gestione del volume di inserzioni.

Visualizza lo stato in corso o in fase di analisi

Per vedere se un'inserzione è in corso o in fase di analisi, controlliamo effective_status, quindi configured_status e infine lo stato dell'account pubblicitario:

• Se un'inserzione ha come effective_status1 - active, la consideriamo in corso o in fase di analisi.
• Se un'inserzione ha come configured_statusactive e come effective_status9 - pending review o 17 - pending processing, la consideriamo in corso o in fase di analisi.
• L'inserzione può essere in corso o in fase di analisi solo se lo stato dell'account pubblicitario è 1 - active, 8 - pending settlement o 9 - in grace period.

Determiniamo se un'inserzione è in corso o in fase di analisi anche sulla base della programmazione del gruppo di inserzioni:

• Se l'ora di inizio è precedente all'ora corrente e questa è precedente all'ora di fine, consideriamo l'inserzione in corso o in fase di analisi.
• Se l'ora di inizio è precedente all'ora corrente e il gruppo di inserzioni non ha un'ora di fine, anche in questo caso consideriamo l'inserzione in corso o in fase di analisi.

Ad esempio, se il gruppo di inserzioni è programmato per un'esecuzione futura, le inserzioni non sono in corso né in fase di analisi. Tuttavia, se il gruppo di inserzioni è programmato per l'esecuzione dal momento corrente ai successivi 3 mesi, consideriamo le inserzioni in corso o in fase di analisi.

Se utilizzi funzioni speciali di programmazione delle inserzioni, come la suddivisione giornaliera, consideriamo l'inserzione in corso o in fase di analisi per l'intero giorno, non a partire dal momento di inizio dell'esecuzione dell'inserzione.

Dettagli in base agli attori

Utilizza il campo show_breakdown_by_actor per ottenere i dettagli relativi ai limiti delle inserzioni in base a uno specifico actor_id:

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"

Risposta

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

Utilizza page_id per richiedere i limiti delle inserzioni per una pagina specifica:

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"

Risposta

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

Campi supportati

Parametri