Actions
Une action, c'est ce qu'une règle fait à un objet Facebook lorsque la condition est remplie. À l'intérieur de la fonction checkAd(ad), vous disposez de fonctions prêtes à l'emploi : pour mettre en pause et pour remettre en service — à trois niveaux : annonce, adset et campagne. Si aucune d'entre elles n'est appelée, la règle ne change rien.
Pour savoir comment écrire la règle elle-même — Créer une règle. La référence complète des fonctions et des champs — SDK des règles automatisées.
Mise en pause
Annonce — pauseAd
Met en pause l'annonce courante (celle qui est en cours de vérification).
pauseAd('24h', 'нет депов при расходе > 100');
- Le premier argument — la durée de la pause (
'6h','12h','24h','next_day_target_geo','next_day_ad_account','permanent','while_matches'). En savoir plus — Planification et pauses. - Le second argument — la raison (facultatif). Le texte est inscrit dans les Journaux (il est enregistré avec l'action dans Facebook). S'il n'est pas précisé — le nom de la règle est utilisé.
Adset — pauseAdset
Met en pause un adset. Un adset n'a pas d'objet courant « propre », donc les arguments sont passés sous forme d'objet, et le champ adsetId est obligatoire :
pauseAdset({ adsetId: ad.adset_id, duration: '24h', reason: 'весь адсет в минус' });
Campagne — pauseCampaign
Met en pause une campagne. Les arguments sont un objet, le champ campaignId est obligatoire :
pauseCampaign({ campaignId: ad.campaign_id, duration: 'permanent', reason: 'кампания убыточна' });
Les trois niveaux — pauseAd, pauseAdset et pauseCampaign — sont appliqués automatiquement dans le cycle de vérification réel, et sont également vérifiés dans l'onglet Test.
Remise en service
Dans la plupart des cas, vous n'avez pas besoin de remettre une annonce en service manuellement : Britva le fait elle-même — lorsque le délai de pause expire ou lorsque la condition de la règle cesse d'être remplie (pour le type de pause « tant que la condition correspond »).
Vous pouvez lever une pause à la main dans l'onglet En pause — le bouton Réactiver.
Le SDK propose aussi des fonctions de remise en service — activateAd et leurs équivalents pour l'adset et la campagne — qui lèvent une suspension depuis le code. Elles fonctionnent dans le cycle de vérification réel. Mais dans la plupart des cas, vous n'en avez pas besoin : les annonces sont remises en service automatiquement à l'expiration de la pause ou lorsque la condition cesse de se déclencher, donc les règles avec une pause suffisent pour un fonctionnement normal.