Especificación de cambios de las reglas de anuncios

En esta página se aborda la especificación change_spec en más detalle, concretamente en lo relacionado con la creación de la opción de ejecución y el uso de las funciones más avanzadas.

change_spec se usa para tipos de ejecución como CHANGE_BUDGET y CHANGE_BID e incluye los siguientes parámetros: amount, limit, unit y target_field.

Campo	Descripción
`amount`	Obligatorio. Determina el importe para cambiar el presupuesto o la puja. Los valores de otros parámetros de `change_spec` determinan la forma exacta en que se usa este importe. Valores admitidos: un valor numérico, como `3000` o `-50`.
`limit`	Opcional. Especifica el importe máximo o mínimo del presupuesto o la puja. Por ejemplo, si el presupuesto o la puja se van a aumentar, este número actúa como un límite máximo. Si `target_field` está presente, especifica un intervalo entre el límite inferior y el límite superior de los valores. Valores admitidos: divisa, como `5000` para representar 50 USD; en el caso de `target_field`, un intervalo de divisas, como `[4000, 6000]` para representar entre 40 y 60 USD.
`unit`	Obligatorio, a menos que `target_field` esté presente. Especifica la unidad del valor de `amount`. Por ejemplo, si la unidad es `PERCENTAGE`, el valor `-50` en `amount` significa `-50%`. Valores admitidos:`ACCOUNT_CURRENCY` o `PERCENTAGE`.
`target_field`	Opcional. Especifica si aumentar o no los presupuestos o las pujas según un valor objetivo. Si está presente, `amount` es el valor objetivo del campo de destino. El presupuesto o la puja se aumentan o disminuyen proporcionalmente, en función de si el valor actual del conjunto de anuncios para el campo de destino es menor o mayor que `amount`. Valores admitidos: un campo de insights, como `cost_per_mobile_app_install` o `mobile_app_purchase_roas`.

Ejemplos

A continuación, se incluye un ejemplo de una regla CHANGE_BUDGET que reduce los presupuestos en un 30 % para todos los conjuntos de anuncios con un rendimiento bajo; en dicha regla, definimos el rendimiento bajo como tener de forma estable un valor elevado de frequency de tiempo de vida. Esta regla solo se ejecuta los martes y los viernes a medianoche.

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

A continuación, se incluye otro ejemplo en el que la puja se aumenta todos los días en función de un valor objetivo de cost_per_mobile_app_install para el conjunto de anuncios 123.

También añadimos un filtro de intervalo para cost_per_mobile_app_install a fin de introducir un intervalo de tolerancia del 10 %. De esta forma, los cambios proporcionales secundarios no se llevan a cabo si el valor actual está lo suficientemente cerca del valor objetivo.

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

Por ejemplo, si el valor actual es 4.0, la puja se aumenta en un 25%, ya que esta es la diferencia proporcional entre el valor objetivo de 5.0 y el valor actual.

El límite impide que la puja aumente por encima de 10.0 y disminuya por debajo de 2.0.