创建规则
Britva 规则是一个小型 JavaScript 函数，它接收单个广告作为输入，并决定对其执行什么操作：暂停它，或者相反，启用它。本文是关于如何在编辑器中创建新规则的分步指南。
每条规则都是一个 checkAd(ad) 函数。在函数内部，您通过 ad.* 字段检查广告的指标，当条件满足时调用某个操作——例如暂停。关于该原理本身的更多内容，请参阅 自动化规则的工作原理 章节。
如何创建规则
-
打开 Britva 章节，在 规则 选项卡上点击 + 新建规则。
将打开一个用于新规则编辑器的独立页面（而非弹出窗口）。
-
在顶部的字段中输入规则的 名称——简短而清晰，例如"暂停无入金广告"。
-
在名称旁边的下拉菜单中选择规则的 scope：
global、team或user。可用选项取决于您的角色（参见 字段参考）。
-
在中间的编辑器中编写规则代码。默认情况下，它已包含一个带有
checkAd(ad)函数的模板和一个被注释掉的示例：JavaScript/** @param {Ad} ad */function checkAd(ad) {// Пример: пауза при 0 депов и большом расходе.// if (ad.deps_total === 0 && ad.spend_24h > 100) {// pauseAd('24h', 'no deps');// }}取消注释该示例，或编写您自己的逻辑。要回顾有哪些指标可用，请打开右侧的 宏 选项卡——它包含
ad.*字段的完整参考。点击任意字段即可将其插入代码中。
-
（可选）不想手动编写代码——可以用文字向左侧栏的 AI 助手 描述任务（"暂停每天无入金且花费超过 100 的广告"）。助手会建议现成的代码，您只需一键即可将其插入编辑器。
🎬 GIF: 向 AI 助手发出请求，并将建议的代码插入编辑器。
-
在右侧的 测试 选项卡上测试规则——它将在当前的实时广告上运行，并显示其中哪些会受到影响。这是安全的：测试期间不会暂停任何广告。更多内容请参阅 测试规则 章节。
-
确保 已启用 开关已开启，然后点击 创建。
保存后，规则会出现在 规则 选项卡的列表中，并开始在公共检查周期中运行。
以禁用状态创建规则（清除 已启用 复选框），在 测试 选项卡上运行它，只有在确信结果无误后才启用它。这样，当您还在配置规则时，它不会在实时广告上触发。
字段参考
这些字段汇集在一个紧凑的编辑器标头中，从左到右排列。
名称 — 规则的简短名称，您将通过它在列表和日志中找到该规则。保存时必填。
Scope（global / team / user）— 谁能看到该规则以及它检查哪些广告：
user— 您的个人规则，它们只检查您自己的广告；team— 团队规则（团队负责人和管理员可用）；global— 面向所有人的公共规则（仅管理员可用）。
选项列表取决于您的角色：普通买量人员只看到 user，团队负责人看到 team 和 user，管理员看到全部三个。作用域在创建时设定。
rank（优先级）— 一个决定规则顺序的数字：数字越小，优先级越高。默认值为 100。如果多条规则争夺同一个广告，rank 较小的规则会先运行。
Enabled / Disabled — 一个开关。只有处于活动状态的规则才参与检查。已禁用的规则会被保存但不会触发——在您仍在完善它时很方便。
desc — 一个箭头按钮，用于展开 描述 字段。自由文本：规则做什么以及为什么。可选，但有助于同事和将来的您自己。
JS code（function checkAd(ad)）— 中央编辑器中规则的主体。保存时必填。在函数内部您可以访问：
- 广告字段
ad.*（花费、入金、ROAS、地理位置等）——完整列表在 宏 选项卡上； - 操作——暂停和恢复（参见 操作）。
一个最简示例——如果在 24 小时内有花费但没有入金，则将广告暂停一天：
/** @param {Ad} ad */
function checkAd(ad) {
if (ad.deps_total === 0 && ad.spend_24h > 100) {
pauseAd('24h', 'нет депов при расходе > 100');
}
}
这里 pauseAd('24h', 'причина') 将广告本身暂停 24 小时。您还可以暂停广告组（pauseAdset(...)）和广告系列（pauseCampaign(...)）。完整的操作列表、调用格式和暂停类型，请参阅 操作 章节。
函数必须严格命名为 checkAd，并接受单个参数 ad。请勿删除函数上方的 /** @param {Ad} ad */ 行——它会在编辑器中直接为 ad.* 字段启用提示。
不确定字段名称？打开 宏 选项卡，使用按名称或描述的搜索功能。这些字段是分组的：广告、创意、报价、地理位置、network 以及上一周期的指标。
创建后会出现什么
已保存（已存在）的规则在编辑器下方有两个可用选项卡：
- 挂起 — 该规则当前正在暂停保留的广告。旁边是它们数量的计数器。
- 动作历史 — 该规则所有触发的日志：何时、针对哪个广告以及做了什么。
新建的、尚未保存的规则没有这些选项卡——它们在首次保存后出现。
删除（编辑器右上角 ⋮ 菜单中的项）不会抹除历史记录：规则会被移至禁用状态，其触发日志会被保留。但您无法一键将规则本身恢复为活动状态——请谨慎操作。