Przejdź do głównej zawartości

Skrypty

Sekcja Skrypty to Pana/Pani własne programy w JavaScript, które Qubix uruchamia według harmonogramu lub przyciskiem. Skrypt uzyskuje dostęp do danych reklamowych poprzez wbudowany zestaw poleceń (SDK QubixApp), może wstrzymywać reklamy, ponownie je włączać, wykonywać zapytania tylko do odczytu do bazy danych Qubix (polecenie sql), sięgać do zewnętrznych usług i zachowywać własny stan między uruchomieniami.

Skrypty dobrze sprawdzają się, gdy standardowe reguły automatyczne Britva już nie wystarczają: potrzebuje Pan/Pani niestandardowej logiki, wywołania zewnętrznego API lub obliczeń, które trudno wyrazić jako warunek.

Czym skrypty różnią się od Britvy

Zarówno Britva, jak i Skrypty automatyzują pracę z reklamami, ale rozwiązują różne zadania.

Britva (reguły automatyczne)Skrypty
Jak opisuje się logikęWarunek w JavaScript dla jednej reklamy (checkAd) → akcja (wstrzymanie/przywrócenie)Dowolny kod w JavaScript
Komu odpowiadaAutomatyczne wstrzymywanie/przywracanie reklam według warunku metrykiNiestandardowe scenariusze, własna logika
Zapytania do bazy danychTak, SQL tylko do odczytu (polecenie sql, gdy włączone w ustawieniach systemu)Tak, SQL tylko do odczytu do bazy danych Qubix (polecenie sql)
Usługi zewnętrzneNieTak, żądanie do zewnętrznego API
Pamięć między uruchomieniamiNieTak, własny stan
Próg wejściaNiższy: tylko warunek (asystent AI może go napisać)Wyższy: cały program (asystent AI może pomóc)
Wskazówka

Jeśli zadanie da się wyrazić jako prosty warunek „jeśli ROAS jest poniżej progu — wstrzymaj”, proszę zacząć od reguł automatycznych Britva — jest to szybsze i bardziej przejrzyste. Skryptów proszę używać tam, gdzie potrzebna jest logika, której reguła nie potrafi wyrazić.

Lista skryptów

Główny ekran sekcji to tabela wszystkich Pana/Pani skryptów z kolumnami:

  • Nazwa — nazwa skryptu (jeśli nie jest ustawiona, wyświetlany jest krótki identyfikator).
  • Harmonogram — kiedy skrypt uruchamia się automatycznie, jako czytelne zdanie (na przykład „Co 5 minut”). Myślnik oznacza brak harmonogramu — skrypt uruchamia się tylko ręcznie.
  • Status — znacznik wyboru, jeśli skrypt jest aktywny; myślnik, jeśli jest wyłączony.
  • Ostatnie uruchomienie — czas i wynik ostatniego wykonania.

Przycisk + Utwórz script w prawym górnym rogu otwiera edytor nowego skryptu. Kliknięcie wiersza tabeli otwiera istniejący skrypt do edycji.

Co dalej