ข้อมูลจำเพาะในการดำเนินการ

execution_spec ของกฎจะกำหนดการดำเนินการที่ใช้กับอ็อบเจ็กต์ทั้งหมดที่ผ่านการประเมิน กฎที่อิงตามกำหนดเวลาและกฎที่อิงตามทริกเกอร์จะรองรับการดำเนินการที่แตกต่างกัน การดำเนินการต่างๆ ระบุอยู่ในหัวข้อ execution_type

ประเภทการดำเนินการ คำอธิบาย

NOTIFICATION

ส่งการแจ้งเตือนที่ประดับเพชรไปยังผู้สร้างกฎนี้ หรือรายชื่อผู้ใช้ที่ระบุใน user_ids หากมีตัวเลือกนี้ให้


ประเภทการประเมินที่รองรับ:SCHEDULE, TRIGGER

PAUSE

หยุดอ็อบเจ็กต์ชั่วคราว


ประเภทการประเมินที่รองรับ:SCHEDULE, TRIGGER

UNPAUSE

ยกเลิกการหยุดอ็อบเจ็กต์ชั่วคราว


ประเภทการประเมินที่รองรับ:SCHEDULE, TRIGGER

CHANGE_BUDGET

เปลี่ยนแปลงงบประมาณตาม change_spec ที่กำหนดไว้ ตัวเลือกนี้มีผลกับชุดโฆษณาเท่านั้น


ประเภทการประเมินที่รองรับ:SCHEDULE

CHANGE_CAMPAIGN_BUDGET

เปลี่ยนแปลงงบประมาณตาม change_spec ที่กำหนดไว้ ตัวเลือกนี้มีผลกับแคมเปญโฆษณาเท่านั้น


ประเภทการประเมินที่รองรับ:SCHEDULE

CHANGE_BID

เปลี่ยนแปลงราคาประมูลตาม change_spec ที่กำหนดไว้ ตัวเลือกนี้มีผลกับชุดโฆษณาเท่านั้น


ประเภทการประเมินที่รองรับ:SCHEDULE

ROTATE

หยุดโฆษณาที่ใช้งานอยู่ชั่วคราว และเปิดใช้งานโฆษณาถัดไปตาม ID ในชุดโฆษณา ต้องมีตัวกรอง id ของชุดโฆษณา และตัวกรอง entity_type ของโฆษณา


ประเภทการประเมินที่รองรับ:SCHEDULE

REBALANCE_BUDGET

หยุดอ็อบเจ็กต์ที่ตรงกับเกณฑ์การประเมินชั่วคราว และปรับงบประมาณให้สมดุลกับส่วนที่เหลือตาม rebalance_spec ที่กำหนดไว้ ตัวเลือกนี้มีผลกับชุดโฆษณาเท่านั้น


ประเภทการประเมินที่รองรับ:SCHEDULE

PING_ENDPOINT

ส่ง Ping ไปยังการสมัครสมาชิกของแอปพลิเคชันผ่าน Webhooks โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับการตั้งค่าได้ที่กฎที่อิงตามทริกเกอร์


ประเภทการประเมินที่รองรับ:TRIGGER

execution_options

คุณอาจต้องให้ข้อมูลเพิ่มเติม จึงดำเนินการบางอย่างเหล่านี้ได้ execution_spec จะให้อาร์เรย์ execution_options เสริม เพื่อระบุพารามิเตอร์เพิ่มเติมเหล่านี้ อาร์เรย์ประกอบด้วยรายการอ็อบเจ็กต์ execution_option ซึ่งเป็นพจนานุกรมที่มีคีย์ของ field, value และ operator เช่นเดียวกับอ็อบเจ็กต์ filter ของข้อมูลจำเพาะในการประเมิน

กฎที่อิงตามทริกเกอร์ไม่จำเป็นต้องใช้ตัวเลือกการดำเนินการ

โปรดดูตัวเลือกการดำเนินการที่รองรับ ค่า execution_type ที่รองรับ และวิธีการจัดโครงสร้างได้ที่ด้านล่าง ในตอนนี้ ตัวดำเนินการเดียวที่รองรับสำหรับตัวเลือกทั้งหมดคือ EQUAL

ช่องตัวเลือกการดำเนินการ คำอธิบาย

user_ids*

ผู้รับการแจ้งเตือนที่ประดับเพชรสำหรับ NOTIFICATION หรือผู้รับอีเมลสรุปกฎที่อิงตามกำหนดการสำหรับ execution_type แต่ละรายการ


ประเภทการดำเนินการที่รองรับ:execution_type ทั้งหมดที่รองรับโดยกฎที่อิงตามกำหนดการ


ค่า (ตัวอย่าง):array ([123, 456])

change_spec

ระบุ amount, limit, unit และ target_field จำเป็นต้องใช้เป็นพจนานุกรมสำหรับประเภทที่รองรับ หากมี target_field อยู่ ระดับราคาประมูลหรืองบประมาณจะขึ้นอยู่กับค่าต่างระหว่างมูลค่าปัจจุบันของช่องเป้าหมายกับค่าเป้าหมายที่ระบุไว้ใน amounttarget_field ต้องเป็นตัวกรองข้อมูลเชิงลึกที่ถูกต้อง


ประเภทการดำเนินการที่รองรับ:CHANGE_BUDGET, CHANGE_BID


ค่า (ตัวอย่าง):ตัวอย่างการเปลี่ยนแปลงข้อมูลจำเพาะของกฎโฆษณา

rebalance_spec

รองรับตัวเลือกต่างๆ ที่กำหนดวิธีการปรับสมดุลของงบประมาณ โปรดดูรายละเอียดเพิ่มเติมที่ตัวอย่าง


ประเภทการดำเนินการที่รองรับ:REBALANCE_BUDGET


ค่า (ตัวอย่าง):ปรับสมดุลกฎโฆษณาตามงบประมาณ

execution_count_limit

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


ประเภทการดำเนินการที่รองรับ:CHANGE_BUDGET, CHANGE_BID


ค่า (ตัวอย่าง): จำนวนเต็ม (123)

action_frequency

ระบุจำนวนนาทีขั้นต่ำจนกว่ากฎจะสามารถดำเนินการเดียวกันนั้นกับอ็อบเจ็กต์ได้ ตัวอย่างเช่น หากค่าเป็น 10080 สำหรับกฎ CHANGE_BUDGET และงบประมาณเพิ่มขึ้นตามกฎนั้นสำหรับอ็อบเจ็กต์ A กฎนั้นจะไม่เพิ่มงบประมาณสำหรับอ็อบเจ็กต์ A เป็นเวลาอย่างน้อยหนึ่งสัปดาห์ แม้ว่าอ็อบเจ็กต์ A จะผ่านการประเมินกฎในช่วงสัปดาห์นั้นก็ตาม


ประเภทการดำเนินการที่รองรับ:CHANGE_BUDGET, CHANGE_BID


ค่า (ตัวอย่าง): จำนวนเต็ม (123)

user_ids

หากระบุ user_ids สำหรับกฎที่อิงตามกำหนดการ:

  • เราจะสร้างอีเมลรายวันเพื่อสรุปการดำเนินการที่ได้ทำไปตามกฎของคุณภายใน 24 ชั่วโมงที่ผ่านมา
  • เราส่งข้อมูลไปยังรายชื่อผู้ใช้ที่ระบุไว้ในหัวข้อ user_ids
  • เราจะส่งอีเมลในเวลา 00.30 น. โดยใช้โซนเวลาของบัญชีโฆษณา

อีเมลสรุปนี้จะรวบรวมการแจ้งเตือนสำหรับกฎทั้งหมดที่ผู้ใช้แต่ละรายสมัครไว้ หากไม่มีการดำเนินการใดๆ ตามกฎที่สมัครไว้ ผู้ใช้จะไม่ได้รับอีเมลสำหรับวันนั้น