Condições e métricas
Uma condição é uma verificação das métricas de um anúncio dentro de uma regra. Cada regra recebe como entrada um único anúncio na forma do objeto ad, e você acessa os seus campos por meio de um ponto: ad.spend_24h, ad.deps_total, ad.roas_24h, etc. Assim que a verificação necessária é aprovada — você chama uma ação (uma pausa). Saiba mais sobre a estrutura de uma regra — Criando uma regra.
/** @param {Ad} ad */
function checkAd(ad) {
if (ad.deps_total === 0 && ad.spend_24h > 100) {
pauseAd('24h', 'нет депов при расходе > 100');
}
}
Onde ver a lista de campos
Todos os campos disponíveis estão reunidos no editor de regras, na aba Macros à direita. É uma referência completa com busca por nome e descrição. Ao clicar em um campo, ele o anexa (ad.<field>) ao final do código. Os campos estão agrupados:
- Anúncio — métricas do próprio anúncio (gasto, depósitos, cliques, registros, ROAS, CPD, etc.).
- Criativo — dados do criativo.
- Oferta — dados da oferta.
- Geo — geo e as métricas médias do país do anúncio.
- Rede — dados da rede.
- Período anterior — as mesmas métricas para o período anterior (para uma comparação "piorou / melhorou").
Janelas de tempo
A maioria das métricas está disponível em várias janelas de tempo — um sufixo no final do nome do campo define o período:
_1h,_3h,_6h,_12h,_24h,_48h,_72h,_168h— para a última hora, 3 horas, … 7 dias;_today— desde o início do dia atual;_total— para todo o período.
Por exemplo, ad.spend_24h — gasto nas últimas 24 horas, ad.deps_total — depósitos de todo o período.
Não lembra o nome exato do campo? Abra a aba Macros e use a busca — ela pesquisa tanto o nome quanto a descrição de um campo.
Anúncios vizinhos
Uma regra pode olhar não apenas para o anúncio atual, mas também para os seus "vizinhos" — outros anúncios do mesmo adset ou campanha (por exemplo, para definir uma pausa apenas se todo o adset estiver no vermelho). Essas funções estão descritas no SDK de regras automáticas.