Chiamate API

Consulta gli esempi di chiamate API per l'utilizzo del motore delle regole dell'inserzione.

Leggere tutte le regole per un account

curl -G   \
-d 'fields=name,evaluation_spec,execution_spec,status'   \
-d 'access_token=<ACCESS_TOKEN>'   \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Leggere una regola

curl -G   \
-d 'fields=name,evaluation_spec,execution_spec,status'   \
-d 'access_token=<ACCESS_TOKEN>'   \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>

Aggiornare una regola

Per poter aggiornare una specifica, fornisci tutti i campi, inclusi quelli che sono rimasti invariati. Il seguente è un esempio di aggiornamento delle regole per ogni 1000 impression. Per aggiornare lo stato di una regola non è necessario modificare le specifiche.

curl \
-F 'evaluation_spec={
      "evaluation_type": ...,
      "trigger" : {
        "type": "STATS_MILESTONE",
        "field": "impressions",
        "value": 1000,
        "operator": "EQUAL"
      },
      "filters": ...
     ]
   }' \
-F 'access_token=<ACCESS_TOKEN>'   \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>

Ecco un esempio di aggiornamento dei filtri per selezionare tutte le inserzioni che hanno più di 200 clic. Altri filtri come entity_type e time_preset devono ancora essere inclusi in questo aggiornamento.

curl \
-F 'evaluation_spec={
      "evaluation_type": ...,
      "filters" : [
       {
         "field": "clicks",
         "value": 200,
         "operator": "GREATER_THAN",
       },
       {
       ...
     ]
   }' \
-F 'access_token=<ACCESS_TOKEN>'   \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>

Eliminare una regola

curl -X DELETE \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>

Accedere alla cronologia delle esecuzioni di una regola

È disponibile un endpoint per accedere ai dati storici per le esecuzioni di ciascuna regola. Per impostazione predefinita, questo endpoint fornisce dati pertinenti, come risultati e azioni. Puoi anche controllare lo stato della regola a ogni esecuzione per tracciare le modifiche.

curl -G   \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>/history

Inoltre, questo endpoint supporta tre meccanismi di applicazione di filtri sui dati: object_id, action e hide_no_changes. Puoi filtrare i risultati con un object_id o un action per vedere i risultati solo per il tipo object_id o action.

Puoi anche filtrare i risultati usando il flag hide_no_changes per escludere tutte le esecuzioni per le quali non ci sono modifiche. Puoi combinare questi filtri per restringere ulteriormente i risultati.

curl -G   \
-d 'object_id=123' \
-d 'action=CHANGED_BID' \
-d 'hide_no_changes=true' \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>/history

Accedere alla cronologia delle esecuzioni di un account

È disponibile un endpoint per accedere ai dati della cronologia aggregata per tutte le regole del proprio account. Per impostazione predefinita, questo endpoint fornisce gli stessi dati rilevanti della cronologia di esecuzione di una regola, ma include anche l'ID delle regole per ogni voce.

Le voci in questo endpoint sono ordinate dalla più recente alla meno recente. Questo endpoint supporta inoltre gli stessi meccanismi di applicazione di filtri riportati in alto: object_id, action e hide_no_changes.

curl -G   \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_history

Visualizzare una regola in anteprima

È disponibile un endpoint per visualizzare in anteprima la valutazione di una regola basata sulla programmazione. Quando viene inviata una richiesta POST, questo endpoint restituisce una lista di oggetti che soddisfano tutti i filtri specificati della regola in quel momento.

curl \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>/preview

Eseguire manualmente una regola

È disponibile un endpoint per l'esecuzione manuale di una regola basata sulla programmazione. Quando una richiesta POST viene inviata a questo endpoint, la regola è immediatamente programmata per l'esecuzione.

curl \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>/execute

I risultati possono essere recuperati dalla cronologia delle esecuzioni al completamento dell'esecuzione della regola.

Leggere le regole che governano un oggetto

Sono disponibili endpoint per la lettura di tutte le regole per ogni inserzione, gruppo di inserzioni e campagna pubblicitaria. Per impostazione predefinita, una regola si applica a un oggetto se vi fa riferimento staticamente con il filtro id o dinamicamente con il filtro entity_type.

Questo endpoint supporta anche un parametro pass_evaluation opzionale, che consente di limitare ulteriormente la lista di regole a seconda che l'oggetto ne passi o meno i filtri in quel momento. Se pass_evaluation è true, restituiamo tutte le regole che, quando visualizzate in anteprima, restituiscono l'oggetto. Se è false, restituiamo tutte le regole che non restituiscono l'oggetto.

curl \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_OBJECT_ID>/adrules_governed