Akcje
Akcja to to, co reguła robi z obiektem Facebook, gdy warunek zostaje spełniony. Wewnątrz funkcji checkAd(ad) ma Pan/Pani do dyspozycji gotowe funkcje: do wstrzymywania oraz do przywracania do pracy — na trzech poziomach: reklamy, zestawu reklam i kampanii. Jeśli żadna z nich nie zostanie wywołana, reguła niczego nie zmienia.
Jak napisać samą regułę — Tworzenie reguły. Pełna dokumentacja funkcji i pól — SDK reguł automatycznych.
Wstrzymanie
Reklama — pauseAd
Wstrzymuje bieżącą reklamę (tę, która jest właśnie sprawdzana).
pauseAd('24h', 'нет депов при расходе > 100');
- Pierwszy argument — czas trwania wstrzymania (
'6h','12h','24h','next_day_target_geo','next_day_ad_account','permanent','while_matches'). Więcej — Harmonogram i wstrzymania. - Drugi argument — powód (opcjonalnie). Tekst trafia do Logów (jest zapisywany razem z akcją w Facebook). Jeśli nie zostanie podany — wstawiana jest nazwa reguły.
Zestaw reklam — pauseAdset
Wstrzymuje zestaw reklam. Zestaw reklam nie ma „własnego” bieżącego obiektu, dlatego argumenty przekazuje się jako obiekt, a pole adsetId jest wymagane:
pauseAdset({ adsetId: ad.adset_id, duration: '24h', reason: 'весь адсет в минус' });
Kampania — pauseCampaign
Wstrzymuje kampanię. Argumenty to obiekt, pole campaignId jest wymagane:
pauseCampaign({ campaignId: ad.campaign_id, duration: 'permanent', reason: 'кампания убыточна' });
Wszystkie trzy poziomy — pauseAd, pauseAdset i pauseCampaign — są stosowane automatycznie w rzeczywistym cyklu sprawdzania, a także są sprawdzane na karcie Test.
Przywrócenie do pracy
W większości przypadków nie musi Pan/Pani przywracać reklamy ręcznie: Britva robi to sama — gdy upłynie termin wstrzymania lub gdy warunek reguły przestaje być spełniany (dla typu wstrzymania „dopóki warunek pasuje”).
Wstrzymanie można zdjąć ręcznie na karcie Wstrzymane — przyciskiem Wznów.
SDK ma również funkcje przywracania — activateAd oraz odpowiedniki dla zestawu reklam i kampanii — które zdejmują blokadę z poziomu kodu. Działają one w rzeczywistym cyklu sprawdzania. Jednak w większości przypadków nie są potrzebne: reklamy są przywracane automatycznie, gdy wstrzymanie wygaśnie lub gdy warunek przestaje się uruchamiać, więc do normalnej pracy wystarczą reguły ze wstrzymaniem.