动作
动作是指当条件满足时,规则对 Facebook 对象所执行的操作。在 checkAd(ad) 函数内部,您可以使用现成的函数:用于暂停和恢复运行——分为三个层级:广告、广告组和广告系列。如果其中任何一个都未被调用,则该规则不会改变任何内容。
关于如何编写规则本身——请参阅 创建规则。函数和字段的完整参考——请参阅 自动化规则 SDK。
暂停
广告 — pauseAd
暂停当前广告(即正在被检查的那一条)。
JavaScript
pauseAd('24h', 'нет депов при расходе > 100');
- 第一个参数——暂停时长(
'6h'、'12h'、'24h'、'next_day_target_geo'、'next_day_ad_account'、'permanent'、'while_matches')。详细信息——请参阅 调度与暂停。 - 第二个参数——原因(可选)。该文本会写入 日志(它会随动作一起记录到 Facebook 中)。如果未指定——则会替换为规则名称。
广告组 — pauseAdset
暂停一个广告组。广告组没有"自己的"当前对象,因此参数以对象形式传递,并且 adsetId 字段是必填的:
JavaScript
pauseAdset({ adsetId: ad.adset_id, duration: '24h', reason: 'весь адсет в минус' });
广告系列 — pauseCampaign
暂停一个广告系列。参数为一个对象,campaignId 字段是必填的:
JavaScript
pauseCampaign({ campaignId: ad.campaign_id, duration: 'permanent', reason: 'кампания убыточна' });
所有三个层级——pauseAd、pauseAdset 和 pauseCampaign——都会在真实的检查周期中自动应用,并且也会在 测试 标签页上进行检查。
恢复运行
在大多数情况下,您无需手动恢复广告:Britva 会自行完成——当暂停期限到期时,或当规则条件不再满足时(针对"当条件匹配时"这种暂停类型)。
您可以在 已暂停 标签页上手动解除暂停——使用 取消暂停 按钮。
从代码中恢复
SDK 还提供了恢复函数——activateAd 以及针对广告组和广告系列的对应函数——可从代码中解除暂停。它们在真实的检查周期中生效。但在大多数情况下您并不需要它们:当暂停到期或条件不再触发时,广告会自动恢复,因此对于正常运行而言,带暂停的规则就已足够。