แอ็กชัน
แอ็กชันคือสิ่งที่กฎกระทำต่อออบเจกต์ Facebook เมื่อเงื่อนไขเป็นจริง ภายในฟังก์ชัน checkAd(ad) คุณมีฟังก์ชันสำเร็จรูปให้ใช้งาน: สำหรับหยุดชั่วคราวและนำกลับมาทำงาน — ในสามระดับ ได้แก่ โฆษณา, adset และแคมเปญ หากไม่มีการเรียกฟังก์ชันใดเลย กฎจะไม่เปลี่ยนแปลงอะไร
สำหรับวิธีเขียนตัวกฎเอง — การสร้างกฎ เอกสารอ้างอิงฉบับเต็มของฟังก์ชันและฟิลด์ — SDK ของกฎอัตโนมัติ
หยุดชั่วคราว
โฆษณา — pauseAd
หยุดชั่วคราวโฆษณาปัจจุบัน (ตัวที่กำลังถูกตรวจสอบอยู่ในขณะนี้)
pauseAd('24h', 'нет депов при расходе > 100');
- อาร์กิวเมนต์แรก — ระยะเวลาหยุดชั่วคราว (
'6h','12h','24h','next_day_target_geo','next_day_ad_account','permanent','while_matches') อ่านเพิ่มเติม — การกำหนดตารางเวลาและการหยุดชั่วคราว - อาร์กิวเมนต์ที่สอง — เหตุผล (ไม่บังคับ) ข้อความจะถูกบันทึกลงใน ล็อก (มันจะถูกบันทึกพร้อมกับแอ็กชันใน Facebook) หากไม่ได้ระบุ — ระบบจะใส่ชื่อกฎแทน
Adset — pauseAdset
หยุดชั่วคราว adset โดย adset ไม่มีออบเจกต์ปัจจุบันที่ "เป็นของตัวเอง" ดังนั้นจึงต้องส่งอาร์กิวเมนต์เป็นออบเจกต์ และต้องมีฟิลด์ adsetId:
pauseAdset({ adsetId: ad.adset_id, duration: '24h', reason: 'весь адсет в минус' });
แคมเปญ — pauseCampaign
หยุดชั่วคราวแคมเปญ อาร์กิวเมนต์เป็นออบเจกต์ และต้องมีฟิลด์ campaignId:
pauseCampaign({ campaignId: ad.campaign_id, duration: 'permanent', reason: 'кампания убыточна' });
ทั้งสามระดับ — pauseAd, pauseAdset และ pauseCampaign — จะถูกนำไปใช้โดยอัตโนมัติในรอบการตรวจสอบจริง และยังถูกตรวจสอบบนแท็บ ทดสอบ ด้วย
นำกลับมาทำงาน
ในกรณีส่วนใหญ่ คุณไม่จำเป็นต้องนำโฆษณากลับมาด้วยตนเอง: Britva ทำเองโดยอัตโนมัติ — เมื่อระยะเวลาหยุดชั่วคราวหมดลง หรือเมื่อเงื่อนไขของกฎไม่เป็นจริงอีกต่อไป (สำหรับการหยุดชั่วคราวแบบ "ตราบใดที่ตรงเงื่อนไข")
คุณสามารถยกเลิกการหยุดชั่วคราวด้วยตนเองได้บนแท็บ หยุดชั่วคราว — ปุ่ม เปิดอีกครั้ง
SDK ยังมีฟังก์ชันสำหรับนำกลับมา — activateAd และฟังก์ชันคู่กันสำหรับ adset และแคมเปญ — ที่ยกเลิกการระงับจากโค้ด ฟังก์ชันเหล่านี้ทำงานในรอบการตรวจสอบจริง แต่ในกรณีส่วนใหญ่คุณไม่จำเป็นต้องใช้: โฆษณาจะถูกนำกลับมาโดยอัตโนมัติเมื่อการหยุดชั่วคราวหมดอายุหรือเมื่อเงื่อนไขหยุดทำงาน ดังนั้นกฎที่มีการหยุดชั่วคราวก็เพียงพอสำหรับการทำงานปกติแล้ว