スクリプト
スクリプト セクションは、Qubix がスケジュールまたはボタンで実行する、あなた自身の JavaScript プログラムです。スクリプトは、組み込みのコマンドセット（QubixApp SDK）を通じて広告データにアクセスし、広告を一時停止したり、再びオンにしたり、Qubix のデータベースに対して読み取り専用クエリ（sql コマンド）を実行したり、外部サービスに接続したり、実行間で独自の状態を保持したりできます。
スクリプトは、標準の Britva 自動ルールでは足りなくなったとき — 非標準のロジック、外部 API の呼び出し、条件として表現しにくい計算が必要なときに適しています。
スクリプトと Britva の違い
Britva と スクリプト はどちらも広告の操作を自動化しますが、異なるタスクを解決します。
| Britva（自動ルール） | スクリプト | |
|---|---|---|
| ロジックの記述方法 | 1 件の広告に対する JavaScript 条件（checkAd）→ アクション（一時停止／復帰） | 自由形式の JavaScript コード |
| 適した用途 | メトリクス条件による広告の自動一時停止／復帰 | 非標準のシナリオ、独自のロジック |
| データベースクエリ | 可、読み取り専用 SQL（sql コマンド、システム設定で有効化されている場合） | 可、Qubix データベースに対する読み取り専用 SQL（sql コマンド） |
| 外部サービス | 不可 | 可、外部 API へのリクエスト |
| 実行間のメモリ | 不可 | 可、独自の状態 |
| 参入障壁 | 低い：条件だけ（AI アシスタントが書ける） | 高い：プログラム全体（AI アシスタントが手伝える） |
ヒント
タスクが「ROAS がしきい値を下回ったら一時停止」という単純な条件で表現できるなら、Britva 自動ルール から始めてください — その方が速く分かりやすいです。ルールでは表現できないロジックが必要なところでスクリプトを使ってください。
スクリプトの一覧
このセクションのメイン画面は、すべてのスクリプトのテーブルで、次の列があります：
- 名前 — スクリプト名（未設定の場合は短い識別子が表示されます）。
- スケジュール — スクリプトが自動的に実行されるタイミングを、読みやすいフレーズで（たとえば「5 分ごと」）。ダッシュはスケジュールが設定されておらず、スクリプトが手動でのみ実行されることを意味します。
- ステータス — スクリプトがアクティブならチェックマーク；オフならダッシュ。
- 最終実行 — 最後の実行の時刻と結果。
右上の + Script を作成 ボタンは、新しいスクリプトのエディターを開きます。テーブルの行をクリックすると、既存のスクリプトが編集用に開きます。