API Marketing

Modifica delle specifiche delle regole pubblicitarie

Questa pagina parla più dettagliatamente del change_spec, in particolare di come costruire l'opzione di esecuzione e come utilizzare le funzioni più avanzate.

change_spec è usato per tipi di esecuzione come CHANGE_BUDGET e CHANGE_BID e contiene i seguenti parametri: amount, limit, unit, target_field.

Campo Descrizione

amount

Obbligatorio.

Determina l'importo per modificare il budget o l'offerta. I valori di altri parametri in change_spec determinano esattamente come viene utilizzato questo importo.


Valori supportati: un valore numerico, come 3000 o -50

limit

Facoltativo.

Specifica il budget massimo o minimo o l'importo dell'offerta. Ad esempio, se il budget o l'offerta vengono aumentati, questo numero funge da limite superiore. Se è presente target_field, questo specifica un intervallo dal limite inferiore al limite superiore dei valori.


Valori supportati: valuta, come 5000 per indicare 50 $ USD, o per target_field, un intervallo di valute come [4000, 6000] per indicare 40 $-60 $ USD.

unit

Obbligatorio, a meno che target_field non sia presente.

Specifica l'unità del valore amount. Ad esempio, se l'unità è PERCENTAGE, un amount di -50 significa -50%.


Valori supportati:ACCOUNT_CURRENCY o PERCENTAGE

target_field

Facoltativo.

Specifica se adeguare budget o offerte in base a un valore target. Se è presente, amount è il valore target del campo target. Il budget o l'offerta vengono aumentati o diminuiti proporzionalmente, a seconda che il valore attuale del gruppo di inserzioni per il campo target sia inferiore o superiore a valore di amount.


Valori supportati: un campo Insight, come cost_per_mobile_app_install o mobile_app_purchase_roas

Esempi

Ecco un esempio di una regola CHANGE_BUDGET che riduce i budget del 30% per tutti i gruppi di inserzioni con prestazioni inferiori al previsto, definiti come quei gruppi con una frequency totale stabilmente elevata. Questa regola viene eseguita solo a mezzanotte il martedì e il venerdì.

curl \
-F 'name=Test Change Budget Rule' \
-F 'schedule_spec={
     "schedule_type": "CUSTOM",
     "schedule": [
       {
          "start_minute": 0,
         "days": [2, 5]
       }
     ]
   }' \
-F 'evaluation_spec={
     "evaluation_type": "SCHEDULE",
     "filters": [
       {
         "field": "entity_type",
         "value": "ADSET",
         "operator": "EQUAL"
       },
       {
         "field": "time_preset",
         "value": "LIFETIME",
         "operator": "EQUAL"
       },
       {
         "field": "impressions",
         "value": 8000,
         "operator": "GREATER_THAN"
       },
       {
         "field": "frequency",
         "value": 5.0,
         "operator": "GREATER_THAN"
       }
     ]
   }' \
-F 'execution_spec={
     "execution_type": "CHANGE_BUDGET",
     "execution_options": [
       {
         "field": "change_spec",
         "value": {
           "amount": -30,
           "unit": "PERCENTAGE"
         },
         "operator": "EQUAL"
       },
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Ecco un altro esempio, in cui l'offerta viene adeguata quotidianamente in base a un valore target cost_per_mobile_app_install per il gruppo di inserzioni 123.

Aggiungiamo anche un filtro intervallo per cost_per_mobile_app_install per introdurre una finestra di tolleranza del 10%. In questo modo, non vengono apportate modifiche minori proporzionali, se il valore corrente è abbastanza vicino al valore target.

curl \
-F 'name=Test Change Bid Rule' \
-F 'schedule_spec={
     "schedule_type": "DAILY"
   }' \
-F 'evaluation_spec={
     "evaluation_type": "SCHEDULE",
     "filters": [
       {
         "field": "id",
         "value": [123],
         "operator": "IN"
       },
       {
         "field": "time_preset",
         "value": "LIFETIME",
         "operator": "EQUAL"
       },
       {
         "field": "mobile_app_install",
         "value": 100,
         "operator": "GREATER_THAN"
       },
       {
         "field": "cost_per_mobile_app_install",
         "value": [4.5, 5.5],
         "operator": "NOT_IN_RANGE"
       }
     ]
   }' \
-F 'execution_spec={
     "execution_type": "CHANGE_BID",
     "execution_options": [
       {
         "field": "change_spec",
         "value": {
           "amount": 5.0,
           "limit": [2.0, 10.0],
           "target_field": "cost_per_mobile_app_install"
         },
         "operator": "EQUAL"
       },
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Ad esempio, se il valore corrente è 4.0, l'offerta è aumentata del 25%, poiché questa è la differenza proporzionale tra il valore target di 5.0 e il valore corrente.

Il limite impedisce che l'offerta aumenti oltre 10.0 e scenda sotto 2.0.