การสร้างกฎ

กฎ Britva คือฟังก์ชัน JavaScript ขนาดเล็กที่รับโฆษณาหนึ่งรายการเป็นอินพุตและตัดสินใจว่าจะทำอย่างไรกับมัน: หยุดชั่วคราว หรือในทางตรงกันข้าม เปิดใช้งาน บทความนี้เป็นคู่มือทีละขั้นตอนสำหรับการสร้างกฎใหม่ในตัวแก้ไข

ทุกกฎคือฟังก์ชัน checkAd(ad) ภายในนั้นคุณจะตรวจสอบเมตริกของโฆษณา (ผ่านฟิลด์ ad.*) และเมื่อเงื่อนไขเป็นจริง จึงเรียกการกระทำ — เช่น การหยุดชั่วคราว อ่านรายละเอียดเกี่ยวกับหลักการนี้เพิ่มเติมได้ในส่วน กฎอัตโนมัติทำงานอย่างไร

วิธีสร้างกฎ

1. เปิดส่วน Britva และที่แท็บ กฎ คลิก + สร้างกฎใหม่

   หน้าแยกสำหรับตัวแก้ไขกฎใหม่จะเปิดขึ้น (ไม่ใช่หน้าต่างป๊อปอัป)

2. กรอก ชื่อ ของกฎในฟิลด์ด้านบน — สั้นและชัดเจน เช่น "หยุดเมื่อไม่มีเดป"

3. เลือก ระดับ ของกฎในดรอปดาวน์ถัดจากชื่อ: global, team หรือ user ตัวเลือกที่ใช้ได้ขึ้นอยู่กับบทบาทของคุณ (ดู อ้างอิงฟิลด์)

4. เขียนโค้ดของกฎในตัวแก้ไขตรงกลาง โดยค่าเริ่มต้นจะมีเทมเพลตที่มีฟังก์ชัน checkAd(ad) และตัวอย่างที่ถูกคอมเมนต์ไว้อยู่แล้ว:

   JavaScript

   /** @param {Ad} ad */
   function checkAd(ad) {
     // Пример: пауза при 0 депов и большом расходе.
     // if (ad.deps_total === 0 && ad.spend_24h > 100) {
     //   pauseAd('24h', 'no deps');
     // }
   }

   ยกเลิกคอมเมนต์ตัวอย่าง หรือเขียนตรรกะของคุณเอง หากต้องการดูว่ามีเมตริกใดบ้างที่ใช้ได้ ให้เปิดแท็บ มาโคร ทางขวา — แท็บนี้มีอ้างอิงฉบับเต็มของฟิลด์ ad.* การคลิกที่ฟิลด์ใดก็ตามจะแทรกฟิลด์นั้นลงในโค้ด

5. (ไม่บังคับ) ไม่อยากเขียนโค้ดด้วยมือ — อธิบายงานเป็นคำพูดให้ AI Assistant ในคอลัมน์ซ้าย ("หยุดโฆษณาที่ไม่มีเงินฝากและมีค่าใช้จ่ายเกิน 100 ต่อวัน") ผู้ช่วยจะเสนอโค้ดที่พร้อมใช้ ซึ่งคุณสามารถแทรกลงในตัวแก้ไขได้ด้วยคลิกเดียว

   🎬 GIF: การส่งคำขอไปยัง AI Assistant และการแทรกโค้ดที่เสนอลงในตัวแก้ไข

6. ทดสอบกฎที่แท็บ ทดสอบ ทางขวา — มันจะรันกับโฆษณาจริงที่กำลังทำงานอยู่ และแสดงว่าโฆษณาใดบ้างจะได้รับผลกระทบ ขั้นตอนนี้ปลอดภัย: ไม่มีการหยุดสิ่งใดในระหว่างการทดสอบ อ่านรายละเอียดเพิ่มเติมได้ในส่วน การทดสอบกฎ

7. ตรวจสอบให้แน่ใจว่าสวิตช์ ใช้งาน เปิดอยู่ แล้วคลิก สร้าง

   หลังจากบันทึก กฎจะปรากฏในรายการที่แท็บ กฎ และเริ่มทำงานในรอบการตรวจสอบร่วม

เคล็ดลับ

สร้างกฎในสถานะปิดใช้งาน (ล้างเครื่องหมายถูก ใช้งาน ออก) รันที่แท็บ ทดสอบ แล้วจึงเปิดใช้งานเมื่อมั่นใจในผลลัพธ์แล้วเท่านั้น วิธีนี้กฎจะไม่ทำงานกับโฆษณาจริงในขณะที่คุณยังตั้งค่าอยู่

อ้างอิงฟิลด์

ฟิลด์ต่างๆ ถูกรวบรวมไว้ในส่วนหัวของตัวแก้ไขแบบกะทัดรัด จากซ้ายไปขวา

ชื่อ — ชื่อสั้นๆ ของกฎ ที่คุณจะใช้ค้นหาในรายการและในล็อก จำเป็นต้องระบุเพื่อบันทึก

ระดับ (global / team / user) — ใครเห็นกฎและกฎตรวจสอบโฆษณาใด:

• user — กฎส่วนตัวของคุณ ตรวจสอบเฉพาะโฆษณาของคุณเท่านั้น
• team — กฎของทีม (ใช้ได้สำหรับหัวหน้าทีมและผู้ดูแลระบบ)
• global — กฎร่วมสำหรับทุกคน (ใช้ได้สำหรับผู้ดูแลระบบเท่านั้น)

รายการตัวเลือกขึ้นอยู่กับบทบาทของคุณ: บายเออร์ทั่วไปจะเห็นเฉพาะ user หัวหน้าทีม — team และ user ผู้ดูแลระบบ — ทั้งสามแบบ ระดับจะถูกกำหนดตอนสร้าง

rank (ลำดับความสำคัญ) — ตัวเลขที่กำหนดลำดับของกฎ: ยิ่งตัวเลขน้อย ลำดับความสำคัญยิ่งสูง ค่าเริ่มต้นคือ 100 หากมีกฎหลายข้ออ้างสิทธิ์ในโฆษณาเดียวกัน กฎที่มี rank น้อยกว่าจะทำงานก่อน

ใช้งาน / ปิดใช้งาน — สวิตช์ มีเพียงกฎที่ใช้งานอยู่เท่านั้นที่เข้าร่วมในการตรวจสอบ กฎที่ปิดใช้งานจะถูกบันทึกไว้แต่จะไม่ทำงาน — สะดวกในขณะที่คุณยังปรับแต่งอยู่

desc — ปุ่มลูกศรที่ขยายฟิลด์ คำอธิบาย ข้อความอิสระ: กฎทำอะไรและทำไม ไม่บังคับ แต่ช่วยเพื่อนร่วมงานและตัวคุณเองในอนาคต

โค้ด JS (function checkAd(ad)) — เนื้อหาของกฎในตัวแก้ไขตรงกลาง จำเป็นต้องระบุเพื่อบันทึก ภายในฟังก์ชันคุณสามารถเข้าถึง:

• ฟิลด์ของโฆษณา ad.* (ค่าใช้จ่าย เงินฝาก ROAS geo ฯลฯ) — รายการฉบับเต็มอยู่ที่แท็บ มาโคร
• การกระทำ — หยุดและกลับมาทำงาน (ดู การกระทำ)

ตัวอย่างขั้นต่ำ — หยุดโฆษณาเป็นเวลาหนึ่งวันหากในช่วง 24 ชั่วโมงมีค่าใช้จ่ายแต่ไม่มีเงินฝาก:

JavaScript

/** @param {Ad} ad */
function checkAd(ad) {
  if (ad.deps_total === 0 && ad.spend_24h > 100) {
    pauseAd('24h', 'нет депов при расходе > 100');
  }
}

ในที่นี้ pauseAd('24h', 'причина') จะหยุดตัวโฆษณาเองเป็นเวลา 24 ชั่วโมง คุณยังสามารถหยุด adset (pauseAdset(...)) และแคมเปญ (pauseCampaign(...)) ได้ด้วย รายการการกระทำฉบับเต็ม รูปแบบการเรียก และประเภทการหยุด — อยู่ในส่วน การกระทำ

โปรดทราบ

ฟังก์ชันต้องมีชื่อว่า checkAd พอดี และรับพารามิเตอร์เดียวคือ ad อย่าลบบรรทัด /** @param {Ad} ad */ เหนือฟังก์ชัน — บรรทัดนี้เปิดใช้งานคำแนะนำสำหรับฟิลด์ ad.* ได้ทันทีในตัวแก้ไข

เคล็ดลับ

ไม่แน่ใจในชื่อฟิลด์? เปิดแท็บ มาโคร แล้วใช้การค้นหาตามชื่อหรือคำอธิบาย ฟิลด์ถูกจัดกลุ่มไว้: ad, creative, offer, geo, network และเมตริกของช่วงเวลาก่อนหน้า

สิ่งที่ปรากฏหลังการสร้าง

กฎที่บันทึกแล้ว (มีอยู่แล้ว) จะมีสองแท็บที่ใช้ได้ด้านล่างตัวแก้ไข:

• ค้างไว้ — โฆษณาที่กฎนี้กำลังหยุดชั่วคราวอยู่ในขณะนี้ ถัดจากนั้น — ตัวนับจำนวนของโฆษณาเหล่านั้น
• ประวัติการกระทำ — ล็อกการทำงานทั้งหมดของกฎ: เมื่อใด สำหรับโฆษณาใด และทำอะไรไป

กฎใหม่ที่ยังไม่ได้บันทึกจะไม่มีแท็บเหล่านี้ — แท็บจะปรากฏหลังจากการบันทึกครั้งแรก

การลบกฎ

ลบ (รายการในเมนู ⋮ ที่มุมขวาบนของตัวแก้ไข) จะไม่ลบประวัติทิ้ง: กฎจะถูกย้ายไปยังสถานะปิดใช้งาน และล็อกการทำงานของกฎจะถูกเก็บไว้ แต่คุณไม่สามารถกู้คืนตัวกฎเองกลับมาให้ใช้งานได้ด้วยคลิกเดียว — โปรดดำเนินการอย่างรอบคอบ

ขั้นตอนถัดไป

การกระทำ

กฎสามารถทำอะไรได้บ้างกับโฆษณา adset และแคมเปญ

เงื่อนไขและเมตริก

ฟิลด์ `ad.*` และเมตริกใดบ้างที่ใช้ได้ในกฎ

การทดสอบกฎ

วิธีทดสอบกฎกับข้อมูลจริงโดยไม่นำไปใช้งานจริง

การจัดตารางเวลาและการหยุด

ประเภทของการหยุดและระยะเวลาที่คงอยู่