Scripts
La section Scripts regroupe vos propres programmes en JavaScript que Qubix exécute selon une planification ou via un bouton. Un script accède aux données publicitaires grâce à un jeu de commandes intégré (le SDK QubixApp), peut mettre des annonces en pause, les remettre en service, exécuter des requêtes en lecture seule sur la base de données Qubix (la commande sql), faire appel à des services externes et conserver son propre état entre les exécutions.
Les scripts sont indiqués lorsque les règles automatisées Britva standard ne suffisent plus : vous avez besoin d'une logique non standard, d'un appel à une API externe ou de calculs difficiles à exprimer sous forme de condition.
En quoi les scripts diffèrent de Britva
Britva et les Scripts automatisent tous deux le travail avec les annonces, mais ils répondent à des tâches différentes.
| Britva (règles automatisées) | Scripts | |
|---|---|---|
| Comment la logique est décrite | Une condition JavaScript sur une annonce (checkAd) → une action (pause/remise en service) | Code JavaScript libre |
| À qui cela convient | Mise en pause/remise en service automatique des annonces selon une condition sur une métrique | Scénarios non standard, votre propre logique |
| Requêtes sur la base de données | Oui, SQL en lecture seule (la commande sql, lorsqu'elle est activée dans les paramètres système) | Oui, SQL en lecture seule sur la base de données Qubix (la commande sql) |
| Services externes | Non | Oui, une requête vers une API externe |
| Mémoire entre les exécutions | Non | Oui, son propre état |
| Barrière d'entrée | Plus basse : seulement une condition (l'assistant IA peut l'écrire) | Plus élevée : un programme entier (l'assistant IA peut aider) |
Si la tâche peut s'exprimer sous forme de condition simple « si le ROAS est sous le seuil — mettre en pause », commencez par les règles automatisées Britva — c'est plus rapide et plus clair. Utilisez les scripts là où vous avez besoin d'une logique qu'une règle ne peut pas exprimer.
Liste des scripts
L'écran principal de la section est un tableau de tous vos scripts avec les colonnes :
- Nom — le nom du script (s'il n'est pas défini, un identifiant court est affiché).
- Planification — quand le script s'exécute automatiquement, sous forme de phrase lisible (par exemple, « Toutes les 5 minutes »). Un tiret signifie qu'aucune planification n'est définie, le script ne s'exécute que manuellement.
- Statut — une coche si le script est actif ; un tiret s'il est désactivé.
- Dernière exécution — l'heure et le résultat de la dernière exécution.
Le bouton + Créer un script dans le coin supérieur droit ouvre l'éditeur d'un nouveau script. Cliquer sur une ligne du tableau ouvre un script existant pour le modifier.