Ações
Uma ação é o que uma regra faz com um objeto do Facebook quando a condição é atendida. Dentro da função checkAd(ad) você tem à disposição funções prontas: para pausar e para retornar ao trabalho — em três níveis: anúncio, adset e campanha. Se nenhuma delas for chamada, a regra não altera nada.
Para saber como escrever a própria regra — Criando uma regra. A referência completa de funções e campos — SDK de regras automáticas.
Pausar
Anúncio — pauseAd
Pausa o anúncio atual (aquele que está sendo verificado neste momento).
pauseAd('24h', 'нет депов при расходе > 100');
- O primeiro argumento — a duração da pausa (
'6h','12h','24h','next_day_target_geo','next_day_ad_account','permanent','while_matches'). Leia mais — Agendamento e pausas. - O segundo argumento — o motivo (opcional). O texto vai para os Logs (é registrado junto com a ação no Facebook). Se não for especificado — o nome da regra é substituído.
Adset — pauseAdset
Pausa um adset. Um adset não tem um objeto "próprio" atual, então os argumentos são passados como um objeto, e o campo adsetId é obrigatório:
pauseAdset({ adsetId: ad.adset_id, duration: '24h', reason: 'весь адсет в минус' });
Campanha — pauseCampaign
Pausa uma campanha. Os argumentos são um objeto, o campo campaignId é obrigatório:
pauseCampaign({ campaignId: ad.campaign_id, duration: 'permanent', reason: 'кампания убыточна' });
Os três níveis — pauseAd, pauseAdset e pauseCampaign — são aplicados automaticamente no ciclo real de verificação, e também são verificados na aba Teste.
Retornar ao trabalho
Na maioria dos casos você não precisa retornar um anúncio manualmente: a Britva faz isso sozinha — quando o prazo da pausa expira ou quando a condição da regra deixa de ser atendida (para o tipo de pausa "enquanto a condição bater").
Você pode remover uma pausa manualmente na aba Pausado — o botão Despausar.
O SDK também tem funções de retorno — activateAd e equivalentes para o adset e a campanha — que removem uma retenção pelo código. Elas funcionam no ciclo real de verificação. Mas na maioria dos casos você não precisa delas: os anúncios são retornados automaticamente quando a pausa expira ou quando a condição deixa de disparar, então regras com uma pausa são suficientes para a operação normal.