跳到主要内容

动作

动作是指当条件满足时,规则对 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: 'кампания убыточна' });

所有三个层级——pauseAdpauseAdsetpauseCampaign——都会在真实的检查周期中自动应用,并且也会在 测试 标签页上进行检查。

恢复运行

在大多数情况下,您无需手动恢复广告:Britva 会自行完成——当暂停期限到期时,或当规则条件不再满足时(针对"当条件匹配时"这种暂停类型)。

您可以在 已暂停 标签页上手动解除暂停——使用 取消暂停 按钮。

从代码中恢复

SDK 还提供了恢复函数——activateAd 以及针对广告组和广告系列的对应函数——可从代码中解除暂停。它们在真实的检查周期中生效。但在大多数情况下您并不需要它们:当暂停到期或条件不再触发时,广告会自动恢复,因此对于正常运行而言,带暂停的规则就已足够。

接下来