การเรียกใช้ API

ดูตัวอย่างการเรียกใช้ API เพื่อใช้เอนจิ้นกฎโฆษณา

อ่านกฎทั้งหมดของบัญชี

curl -G   \
-d 'fields=name,evaluation_spec,execution_spec,status'   \
-d 'access_token=<ACCESS_TOKEN>'   \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

อ่านกฎ

curl -G   \
-d 'fields=name,evaluation_spec,execution_spec,status'   \
-d 'access_token=<ACCESS_TOKEN>'   \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>

อัพเดตกฎ

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

curl \
-F 'evaluation_spec={
      "evaluation_type": ...,
      "trigger" : {
        "type": "STATS_MILESTONE",
        "field": "impressions",
        "value": 1000,
        "operator": "EQUAL"
      },
      "filters": ...
     ]
   }' \
-F 'access_token=<ACCESS_TOKEN>'   \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>

นี่คือตัวอย่างการอัพเดตตัวกรองเพื่อเลือกโฆษณาทั้งหมดที่มีการคลิกมากกว่า 200 ครั้ง ตัวกรองอื่นๆ เช่น entity_type และ time_preset ต้องยังคงอยู่ในการอัพเดตนี้

curl \
-F 'evaluation_spec={
      "evaluation_type": ...,
      "filters" : [
       {
         "field": "clicks",
         "value": 200,
         "operator": "GREATER_THAN",
       },
       {
       ...
     ]
   }' \
-F 'access_token=<ACCESS_TOKEN>'   \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>

ลบกฎ

curl -X DELETE \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>

เข้าถึงประวัติการดำเนินการของกฎ

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

curl -G   \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>/history

นอกจากนี้ ตำแหน่งข้อมูลนี้ยังรองรับกลไกการกรองข้อมูล 3 แบบ: object_id, action และ hide_no_changes คุณสามารถกรองผลลัพธ์ตาม object_id หรือ action เพื่อดูผลลัพธ์เฉพาะประเภทที่เป็น object_id หรือ action เท่านั้น

คุณยังสามารถกรองผลลัพธ์โดยใช้แฟล็ก hide_no_changes เพื่อไม่รวมการดำเนินการใดก็ตามที่ไม่มีการเปลี่ยนแปลงเลย คุณสามารถรวมตัวกรองเหล่านี้เข้าด้วยกันเพื่อแสดงผลลัพธ์ให้แคบลงได้

curl -G   \
-d 'object_id=123' \
-d 'action=CHANGED_BID' \
-d 'hide_no_changes=true' \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>/history

เข้าถึงประวัติการดำเนินการของบัญชี

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

รายการในตำแหน่งข้อมูลนี้จะเรียงลำดับจากใหม่ที่สุดไปเก่าที่สุด นอกจากนี้ ตำแหน่งข้อมูลนี้ยังรองรับกลไกการกรองข้อมูลแบบเดียวกับข้างต้น: object_id, action และ hide_no_changes

curl -G   \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_history

ดูตัวอย่างกฎ

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

curl \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>/preview

ดำเนินการกฎด้วยตนเอง

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

curl \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>/execute

คุณสามารถดึงผลลัพธ์ได้จากประวัติการดำเนินการเมื่อการดำเนินการกฎเสร็จสมบูรณ์แล้ว

อ่านกฎที่ควบคุมสำหรับอ็อบเจ็กต์

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

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

curl \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_OBJECT_ID>/adrules_governed