Действия
Действие — это то, что правило делает с объектом Facebook при выполнении условия. Внутри функции checkAd(ad) вам доступны готовые функции: поставить на паузу и вернуть в работу — на трёх уровнях: объявление, адсет и кампания. Если ни одна из них не вызвана, правило ничего не меняет.
Как написать само правило — Создание правила. Полный справочник функций и полей — SDK правил автопаузы.
Пауза
Объявление — pauseAd
Ставит на паузу текущее объявление (то, которое проверяется прямо сейчас).
pauseAd('24h', 'нет депов при расходе > 100');
- Первый аргумент — длительность паузы (
'6h','12h','24h','next_day_target_geo','next_day_ad_account','permanent','while_matches'). Подробнее — Расписание и паузы. - Второй аргумент — причина (опционально). Текст попадает в Логи (он записывается вместе с действием в Facebook). Если не указан — подставляется имя правила.
Адсет — pauseAdset
Ставит на паузу адсет. У адсета нет «своего» текущего объекта, поэтому аргументы передаются объектом, и поле adsetId обязательно:
pauseAdset({ adsetId: ad.adset_id, duration: '24h', reason: 'весь адсет в минус' });
Кампания — pauseCampaign
Ставит на паузу кампанию. Аргументы — объект, поле campaignId обязательно:
pauseCampaign({ campaignId: ad.campaign_id, duration: 'permanent', reason: 'кампания убыточна' });
Все три уровня — pauseAd, pauseAdset и pauseCampaign — применяются автоматически в реальном цикле проверки, а также проверяются на вкладке Тест.
Возврат в работу
В большинстве случаев возвращать объявление вручную не нужно: Britva делает это сама — когда срок паузы истекает или когда условие правила перестаёт выполняться (для типа паузы «пока условие совпадает»).
Снять паузу вручную можно на вкладке На паузе — кнопкой Включить.
В SDK также есть функции возврата — activateAd и аналоги для адсета и кампании — которые снимают удержание из кода. Они работают в реальном цикле проверки. Но в большинстве случаев они не нужны: объявления возвращаются автоматически, когда пауза истекает или когда условие перестаёт срабатывать, так что для нормальной работы достаточно правил с паузой.