アクション
アクションとは、条件が満たされたときにルールが Facebook オブジェクトに対して行うことです。checkAd(ad) 関数の内部では、一時停止と再開のための既製の関数を、広告・広告セット・キャンペーンの 3 つのレベルで利用できます。どれも呼び出されなければ、ルールは何も変更しません。
ルール自体の書き方は ルールの作成 を参照してください。関数とフィールドの完全なリファレンスは 自動化ルール SDK にあります。
一時停止
広告 — pauseAd
現在の広告(まさに今チェックされているもの)を一時停止します。
pauseAd('24h', 'нет депов при расходе > 100');
- 第 1 引数 — 一時停止の期間(
'6h'、'12h'、'24h'、'next_day_target_geo'、'next_day_ad_account'、'permanent'、'while_matches')。詳しくは スケジューリングと一時停止。 - 第 2 引数 — 理由(任意)。テキストは ログ に記録されます(Facebook でのアクションとともに記録されます)。指定しない場合 — ルール名が代わりに使われます。
広告セット — pauseAdset
広告セットを一時停止します。広告セットには「自身の」現在のオブジェクトがないため、引数はオブジェクトとして渡され、adsetId フィールドが必須です:
pauseAdset({ adsetId: ad.adset_id, duration: '24h', reason: 'весь адсет в минус' });
キャンペーン — pauseCampaign
キャンペーンを一時停止します。引数はオブジェクトで、campaignId フィールドが必須です:
pauseCampaign({ campaignId: ad.campaign_id, duration: 'permanent', reason: 'кампания убыточна' });
3 つのレベルすべて — pauseAd、pauseAdset、pauseCampaign — は実際のチェックサイクルで自動的に適用され、テスト タブでも確認されます。
再開
ほとんどの場合、広告を手動で再開する必要はありません: Britva が自分で行います — 一時停止の期限が切れたとき、またはルールの条件が満たされなくなったとき(「条件が一致している間」の一時停止タイプの場合)。
停止中 タブの 一時停止を解除 ボタンで、手動で一時停止を解除できます。
SDK には再開用の関数もあります — activateAd と、広告セットおよびキャンペーン用の対応する関数 — これらはコードから保留を解除します。実際のチェックサイクルで動作します。ただしほとんどの場合は不要です: 広告は一時停止の期限が切れたとき、または条件が作動しなくなったときに自動的に再開されるため、通常の運用には一時停止を含むルールで十分です。