Conditions et métriques
Une condition est une vérification des métriques d'une annonce à l'intérieur d'une règle. Chaque règle reçoit en entrée une seule annonce sous la forme de l'objet ad, et vous accédez à ses champs via un point : ad.spend_24h, ad.deps_total, ad.roas_24h, etc. Dès que la vérification requise est satisfaite, vous appelez une action (une mise en pause). Pour en savoir plus sur la structure d'une règle — Création d'une règle.
/** @param {Ad} ad */
function checkAd(ad) {
if (ad.deps_total === 0 && ad.spend_24h > 100) {
pauseAd('24h', 'нет депов при расходе > 100');
}
}
Où voir la liste des champs
Tous les champs disponibles sont regroupés dans l'éditeur de règles, sur l'onglet Macros à droite. Il s'agit d'une référence complète avec recherche par nom et par description. Un clic sur un champ l'ajoute (ad.<champ>) à la fin du code. Les champs sont regroupés :
- Annonce — métriques de l'annonce elle-même (dépenses, dépôts, clics, inscriptions, ROAS, CPD, etc.).
- Créa — données du créatif.
- Offre — données de l'offre.
- Geo — geo et métriques moyennes pour le pays de l'annonce.
- Réseau — données du réseau.
- Période précédente — les mêmes métriques pour la période précédente (pour une comparaison « pire / mieux »).
Fenêtres temporelles
La plupart des métriques sont disponibles dans plusieurs fenêtres temporelles — un suffixe à la fin du nom du champ définit la période :
_1h,_3h,_6h,_12h,_24h,_48h,_72h,_168h— pour la dernière heure, les 3 dernières heures, … les 7 derniers jours ;_today— depuis le début de la journée en cours ;_total— pour toute la période.
Par exemple, ad.spend_24h — les dépenses des dernières 24 heures, ad.deps_total — les dépôts pour toute la période.
Vous ne vous souvenez pas du nom exact du champ ? Ouvrez l'onglet Macros et utilisez la recherche — elle recherche à la fois dans le nom et dans la description d'un champ.
Annonces voisines
Une règle peut examiner non seulement l'annonce courante mais aussi ses « voisines » — d'autres annonces du même adset ou de la même campagne (par exemple, pour ne mettre en pause que si tout l'adset est dans le rouge). Ces fonctions sont décrites dans le SDK des règles automatisées.