Scripts
Der Bereich Scripts sind Ihre eigenen Programme in JavaScript, die Qubix nach Zeitplan oder per Knopfdruck ausführt. Ein Skript erhält über einen eingebauten Befehlssatz (das QubixApp-SDK) Zugriff auf Anzeigendaten, kann Anzeigen pausieren, wieder einschalten, schreibgeschützte Abfragen gegen die Qubix-Datenbank ausführen (der Befehl sql), externe Dienste ansprechen und seinen eigenen Zustand zwischen den Ausführungen behalten.
Skripte passen gut, wenn die standardmäßigen Britva-Auto-Regeln nicht mehr ausreichen: Sie brauchen nicht-standardmäßige Logik, einen Aufruf einer externen API oder Berechnungen, die sich schwer als Bedingung ausdrücken lassen.
Wie sich Skripte von Britva unterscheiden
Sowohl Britva als auch Scripts automatisieren die Arbeit mit Anzeigen, aber sie lösen unterschiedliche Aufgaben.
| Britva (Auto-Regeln) | Scripts | |
|---|---|---|
| Wie die Logik beschrieben wird | Eine JavaScript-Bedingung über eine Anzeige (checkAd) → eine Aktion (Pause/Fortsetzung) | Frei formulierter JavaScript-Code |
| Für wen es passt | Auto-Pause/-Fortsetzung von Anzeigen nach einer Metrikbedingung | Nicht-standardmäßige Szenarien, eigene Logik |
| Datenbankabfragen | Ja, schreibgeschütztes SQL (der Befehl sql, wenn in den Systemeinstellungen aktiviert) | Ja, schreibgeschütztes SQL gegen die Qubix-Datenbank (der Befehl sql) |
| Externe Dienste | Nein | Ja, eine Anfrage an eine externe API |
| Speicher zwischen Ausführungen | Nein | Ja, eigener Zustand |
| Einstiegshürde | Niedriger: nur eine Bedingung (der KI-Assistent kann sie schreiben) | Höher: ein ganzes Programm (der KI-Assistent kann helfen) |
Lässt sich die Aufgabe als einfache Bedingung "wenn ROAS unter dem Schwellenwert liegt — pausiere sie" ausdrücken, beginnen Sie mit den Britva-Auto-Regeln — das ist schneller und übersichtlicher. Verwenden Sie Skripte dort, wo Sie Logik brauchen, die eine Regel nicht ausdrücken kann.
Liste der Skripte
Der Hauptbildschirm des Bereichs ist eine Tabelle aller Ihrer Skripte mit den Spalten:
- Name — der Skriptname (ist keiner gesetzt, wird ein kurzer Identifikator angezeigt).
- Zeitplan — wann das Skript automatisch läuft, als lesbarer Satz (zum Beispiel "Alle 5 Minuten"). Ein Bindestrich bedeutet, dass kein Zeitplan gesetzt ist, das Skript läuft nur manuell.
- Status — ein Häkchen, wenn das Skript aktiv ist; ein Bindestrich, wenn es aus ist.
- Letzte Ausführung — die Zeit und das Ergebnis der letzten Ausführung.
Der Button + Script erstellen in der oberen rechten Ecke öffnet den Editor für ein neues Skript. Ein Klick auf eine Tabellenzeile öffnet ein bestehendes Skript zur Bearbeitung.