Scripts
A seção Scripts são seus próprios programas em JavaScript que o Qubix executa por agendamento ou com um botão. Um script obtém acesso aos dados de anúncios através de um conjunto integrado de comandos (o SDK QubixApp), pode pausar anúncios, reativá-los, executar consultas somente leitura no banco de dados do Qubix (o comando sql), acessar serviços externos e manter seu próprio estado entre as execuções.
Os scripts são uma boa escolha quando as auto-regras padrão da Britva já não são suficientes: você precisa de uma lógica não padronizada, de uma chamada a uma API externa ou de cálculos difíceis de expressar como uma condição.
Em que os scripts se diferenciam da Britva
Tanto a Britva quanto os Scripts automatizam o trabalho com anúncios, mas resolvem tarefas diferentes.
| Britva (auto-regras) | Scripts | |
|---|---|---|
| Como a lógica é descrita | Uma condição JavaScript sobre um anúncio (checkAd) → uma ação (pausar/reativar) | Código JavaScript livre |
| A quem serve | Pausar/reativar anúncios automaticamente por uma condição de métrica | Cenários não padronizados, sua própria lógica |
| Consultas ao banco de dados | Sim, SQL somente leitura (o comando sql, quando habilitado nas configurações do sistema) | Sim, SQL somente leitura no banco de dados do Qubix (o comando sql) |
| Serviços externos | Não | Sim, uma requisição a uma API externa |
| Memória entre execuções | Não | Sim, seu próprio estado |
| Barreira de entrada | Mais baixa: apenas uma condição (o assistente de IA pode escrevê-la) | Mais alta: um programa inteiro (o assistente de IA pode ajudar) |
Se a tarefa puder ser expressa como uma condição simples "se o ROAS estiver abaixo do limite — pausar", comece pelas auto-regras da Britva — é mais rápido e mais claro. Use scripts onde você precisa de uma lógica que uma regra não consegue expressar.
Lista de scripts
A tela principal da seção é uma tabela de todos os seus scripts com as colunas:
- Nome — o nome do script (se não estiver definido, é exibido um identificador curto).
- Agendamento — quando o script é executado automaticamente, como uma frase legível (por exemplo, "A cada 5 minutos"). Um traço significa que nenhum agendamento foi definido, o script só é executado manualmente.
- Status — uma marca de seleção se o script estiver ativo; um traço se estiver desligado.
- Última execução — o horário e o resultado da última execução.
O botão + Criar script no canto superior direito abre o editor para um novo script. Clicar em uma linha da tabela abre um script existente para edição.