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.