Condiciones y métricas
Una condición es una comprobación de las métricas de un anuncio dentro de una regla. Cada regla recibe como entrada un único anuncio en forma del objeto ad, y accedes a sus campos a través de un punto: ad.spend_24h, ad.deps_total, ad.roas_24h, etc. Cuando la comprobación necesaria se cumple — llamas a una acción (una pausa). Más información sobre la estructura de una regla — Crear una regla.
/** @param {Ad} ad */
function checkAd(ad) {
if (ad.deps_total === 0 && ad.spend_24h > 100) {
pauseAd('24h', 'нет депов при расходе > 100');
}
}
Dónde ver la lista de campos
Todos los campos disponibles están reunidos en el editor de reglas, en la pestaña Macros a la derecha. Es una referencia completa con búsqueda por nombre y descripción. Al pulsar un campo se añade (ad.<campo>) al final del código. Los campos están agrupados:
- Anuncio — métricas del propio anuncio (gasto, depósitos, clics, registros, ROAS, CPD, etc.).
- Creativo — datos del creativo.
- Oferta — datos de la oferta.
- Geo — geo y las métricas medias del país del anuncio.
- Red — datos de la red.
- Periodo anterior — las mismas métricas para el periodo anterior (para una comparación "empeoró / mejoró").
Ventanas temporales
La mayoría de las métricas están disponibles en varias ventanas temporales — un sufijo al final del nombre del campo fija el periodo:
_1h,_3h,_6h,_12h,_24h,_48h,_72h,_168h— para la última hora, 3 horas, … 7 días;_today— desde el inicio del día actual;_total— de todo el tiempo.
Por ejemplo, ad.spend_24h — gasto de las últimas 24 horas, ad.deps_total — depósitos de todo el tiempo.
¿No recuerdas el nombre exacto de un campo? Abre la pestaña Macros y usa la búsqueda — busca tanto en el nombre como en la descripción de un campo.
Anuncios vecinos
Una regla puede mirar no solo el anuncio actual sino también sus "vecinos" — otros anuncios del mismo conjunto de anuncios o campaña (por ejemplo, para fijar una pausa solo si todo el conjunto de anuncios está en números rojos). Estas funciones se describen en el SDK de reglas automatizadas.