ข้อมูลจำเพาะสำหรับการประเมิน

วัตถุประสงค์หลักของ evaluation_spec ของกฎคือเพื่อกำหนดอ็อบเจ็กต์ที่กฎควรดำเนินการ โดย evaluation_type จะกำหนดประเภทของวิธีการประเมินและมีตัวเลือกดังต่อไปนี้

evaluation_spec จะมีอาร์เรย์ filters ซึ่งช่วยให้คุณสามารถจำกัดรายการอ็อบเจ็กต์ที่ตรงกันให้แคบลงได้รวมอยู่ด้วย ตัวอย่างเช่น คุณสามารถสร้างตัวกรองเมตาดาต้าโฆษณา ชุดโฆษณา และแคมเปญโฆษณา รวมถึงเกณฑ์ชี้วัดข้อมูลเชิงลึกได้ ตัวกรองทั้งหมดจะได้รับการประเมินร่วมกันโดยใช้ตัวดำเนินการ AND

อาร์เรย์ filters จะมีรายการอ็อบเจ็กต์ตัวกรองรวมอยู่ด้วย อ็อบเจ็กต์เหล่านี้คือพจนานุกรมที่มีคีย์ field, value และ operator ดังนี้

แต่ละตัวกรองจะมีรายการตัวดำเนินการเชิงตรรกะที่รองรับ ตัวดำเนินการเชิงตรรกะที่กฎ SCHEDULE และ TRIGGER รองรับมีดังต่อไปนี้

evaluation_spec จำเป็นต้องมี trigger สำหรับการประเมินประเภท TRIGGER โดยทริกเกอร์นี้จะมีประเภทและข้อมูลจำเพาะสำหรับตัวกรองเป็นพื้นฐานรวมอยู่ด้วย ซึ่งข้อมูลจำเพาะสำหรับตัวกรองอาจเป็น field, value และ operator

ทริกเกอร์จะช่วยพิจารณาว่าเราควรประเมินกฎหรือไม่ และคุณสามารถมีทริกเกอร์ได้เพียง 1 ทริกเกอร์เท่านั้น ดูรายละเอียดเพิ่มเติมได้ที่กฎที่อิงตามทริกเกอร์

เราจะอธิบายเกี่ยวกับตัวกรองพิเศษและกลุ่มตัวกรองทั่วไปบางส่วนที่คุณสามารถใช้ได้ในส่วนด้านล่างนี้

ตัวกรองพิเศษ

time_preset

ตัวกรอง time_preset จะกำหนดระยะเวลาที่เราจะรวมเกณฑ์ชี้วัดข้อมูลเชิงลึก ปัจจุบันเราอนุญาตให้มี time_preset ได้รายการเดียวเท่านั้น โดยจะใช้กับตัวกรองสถิติทั้งหมดในกฎ รวมถึงตัวกรองที่ใช้สำหรับทริกเกอร์ (หากมี)

ตัวดำเนินการเดียวที่ time_preset รองรับคือ EQUAL และจำเป็นต้องระบุตัวดำเนินการนี้ตราบใดที่มีตัวกรองหรือทริกเกอร์ข้อมูลเชิงลึกอยู่ กฎที่อิงตามทริกเกอร์รองรับเฉพาะการตั้งค่าเวลาล่วงหน้าที่รวม TODAY ด้วยเท่านั้น เนื่องจากกฎนี้จะทำการประเมินแบบเรียลไทม์

การตั้งค่าเวลาล่วงหน้าสำหรับกฎอาจทำงานแตกต่างจากอินเทอร์เฟซอื่นๆ โดยการตั้งค่าเวลาล่วงหน้าบางส่วนในที่นี้จะรวมข้อมูลของวันนี้ด้วย ที่เป็นเช่นนี้เนื่องจากข้อมูลของวันนี้มีความสำคัญอย่างยิ่งสำหรับกฎที่ทำงานมากกว่าวันละครั้ง สำหรับอินเทอร์เฟซอื่นๆ โดยทั่วไปแล้วค่า LAST_N_DAYS ที่กำหนดไว้ล่วงหน้าจะไม่รวมข้อมูลของวันนี้ ดูรายละเอียดเพิ่มเติมได้ที่คำอธิบายด้านล่าง

{
  "field": "time_preset",
  "value": "TODAY",
  "operator": "EQUAL"
}

attribution_window

ตัวกรอง attribution_window จะกำหนดช่วงเวลาเก็บข้อมูลย้อนหลังที่จะรวมเกณฑ์ชี้วัดข้อมูลเชิงลึก ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับข้อมูลเชิงลึกในส่วนช่วงการระบุที่มา

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

value เดียวที่อนุญาตให้ใช้กับ attribution_window คือ ACCOUNT_DEFAULT ไม่ว่าคุณจะระบุค่านี้หรือไม่ก็ตาม

{
  "field": "attribution_window",
  "value": "ACCOUNT_DEFAULT",
  "operator": "EQUAL"
}

ตัวกรองเมตาดาต้า

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

ตัวอย่างเช่น หากคุณต้องการกฎที่ใช้กับชุดโฆษณาของแคมเปญโฆษณาที่มีวัตถุประสงค์เป็น WEBSITE_CLICKS คุณสามารถใส่ตัวกรองได้ 2 ตัวกรอง ดังนี้

 "filters" : [
  {
    "field": "entity_type",
    "value": "ADSET",
    "operator": "EQUAL",
  },
  {
    "field": "campaign.objective",
    "value": "WEBSITE_CLICKS",
    "operator": "EQUAL"
  }
]

ตัวกรองเมตาดาต้าที่กฎที่อิงตามทริกเกอร์และกฎที่อิงตามกำหนดเวลารองรับ

ตัวกรองเมตาดาต้าที่สามารถใช้กับกฎที่อิงตามกำหนดเวลาเท่านั้น

entity_type และ id

คุณต้องระบุตัวกรอง entity_type หรือ id สำหรับกฎการประเมินประเภท SCHEDULE หรือ TRIGGER ทั้งหมด

เมื่อคุณระบุตัวกรอง entity_type จะเป็นการกำหนดระดับอ็อบเจ็กต์ไดนามิกที่จะใช้กฎ ตัวอย่างเช่น หาก entity_type เป็น AD กฎดังกล่าวจะประเมินโฆษณาใหม่ทั้งหมดที่เพิ่มไปยังบัญชีโฆษณาโดยอัตโนมัติ ซึ่งจะเป็นเช่นนี้เสมอ ไม่ว่าคุณจะสร้างกฎเมื่อใดก็ตาม เมื่อระบุตัวกรอง id กฎดังกล่าวจะใช้กับรายการอ็อบเจ็กต์แบบคงที่เท่านั้น

เมื่อคุณระบุตัวกรอง idโดยไม่มีคำนำหน้า เราจะคำนวณระดับอ็อบเจ็กต์ที่จะใช้กฎโดยอัตโนมัติ ตัวอย่างเช่น หากคุณต้องการนำกฎไปใช้กับโฆษณา [123, 456] คุณเพียงแค่ต้องระบุหนึ่งตัวกรองที่มีช่อง id ค่า [123, 456] และตัวดำเนินการ IN ในกรณีนี้ไม่จำเป็นต้องระบุ entity_type เนื่องจากคุณได้ระบุรายการอ็อบเจ็กต์แบบคงที่ในเบื้องต้นแล้ว และเราสามารถคำนวณระดับอ็อบเจ็กต์จากอ็อบเจ็กต์เหล่านั้นได้

คุณสามารถใช้ entity_type และ id ร่วมกับการกรองหลายระดับได้ ตัวอย่างเช่น หากคุณต้องการกฎที่ใช้กับโฆษณาทั้งหมดในชุดโฆษณาที่ระบุบางชุด คุณสามารถใช้ตัวกรอง entity_type ที่ตั้งค่าเป็น AD และตัวกรอง adset.id กับชุดโฆษณาที่ระบุได้

โดยค่าเริ่มต้นแล้ว หากคุณไม่ได้ระบุตัวกรอง effective_status เราจะเพิ่มตัวกรอง effective_status ให้เองเมื่อประเมินกฎ

สำหรับการดำเนินการทุกประเภทที่ดำเนินการกับอ็อบเจ็กต์ที่ใช้งานอยู่ ตัวกรองเริ่มต้นนี้จะมีตัวดำเนินการเป็น IN และมีค่าเป็น ['ACTIVE', 'PENDING_REVIEW'] ซึ่งหมายความว่ากฎจะประเมินเฉพาะอ็อบเจ็กต์ที่มีหรือจะมีการแสดงโฆษณาที่ใช้งานอยู่เท่านั้น สำหรับประเภทการดำเนินการที่ไม่ได้ดำเนินการกับอ็อบเจ็กต์ที่ใช้งานอยู่ (UNPAUSE) เราจะเพิ่มตัวกรองนี้ที่มีตัวดำเนินการเป็น NOT_IN และมีค่าเป็น ['DELETED', 'ARCHIVED'] ตัวกรองเริ่มต้นนี้เป็นการปรับการทำงานภายในให้เหมาะสมกับประเภทการดำเนินการของเรา

ตัวกรองข้อมูลเชิงลึก

เราจะประเมินตัวกรองข้อมูลเชิงลึกสำหรับ time_preset ที่ระบุ โดยเทียบกับค่าปัจจุบันที่ส่งคืนจาก API ข้อมูลเชิงลึก ตัวกรองเหล่านี้ใช้กับรายการหรือระดับของอ็อบเจ็กต์โดยตรง และไม่รองรับการกรองหลายระดับ ตัวกรองข้อมูลเชิงลึกทั้งหมดรองรับตัวดำเนินการต่อไปนี้ ได้แก่ GREATER_THAN, LESS_THAN, EQUAL, IN_RANGE, NOT_IN_RANGE

ดูคำอธิบายของแต่ละช่องด้านล่างได้ที่เอกสารประกอบเกี่ยวกับ API ข้อมูลเชิงลึก ทั้งนี้ กฎที่อิงตามกำหนดเวลารองรับตัวกรองเหล่านี้ทั้งหมด

ด้านล่างนี้คือรายการตัวกรองข้อมูลเชิงลึกและข้อมูลที่แสดงว่ากฎที่อิงตามทริกเกอร์รองรับตัวกรองเหล่านี้หรือไม่

ตัวกรองขั้นสูง

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

ตัวกรองขั้นสูงรองรับตัวดำเนินการต่อไปนี้ ได้แก่ GREATER_THAN, LESS_THAN, EQUAL, IN_RANGE, NOT_IN_RANGEซึ่งมีเพียงกฎที่อิงตามกำหนดเวลาเท่านั้นที่รองรับตัวดำเนินการเหล่านี้

สำหรับตัวกรองขั้นสูงบางตัวที่ใช้กันอย่างแพร่หลาย เรารองรับการใช้ชื่อเรียกตัวกรองแบบย่อ ดังนี้