API คอนเวอร์ชั่นแบบออฟไลน์

ใช้ API คอนเวอร์ชั่นแบบออฟไลน์เพื่อส่งเหตุการณ์คอนเวอร์ชั่นแบบออฟไลน์และดูจำนวนลูกค้าที่รับชมหรือคลิกโฆษณาบน Meta ก่อนที่จะทำให้เกิดคอนเวอร์ชั่น

ก่อนเริ่มต้น

หากต้องการใช้ API นี้ คุณต้องมีสิ่งต่อไปนี้

1. ตัวจัดการธุรกิจของ Meta

หากยังไม่มี โปรดสร้างขึ้นใหม่

2. ID แอพ Meta

สำหรับเข้าถึง API การตลาด ในการสร้างแอพ Meta ให้ดำเนินการดังนี้

• ไปที่ตัวจัดการธุรกิจ > การตั้งค่าธุรกิจ
• เลือกแอพ
• คลิก "เพิ่มแอพใหม่" และปฏิบัติตามคำแนะนำ

3. การตรวจสอบแอพและสิทธิ์การอนุญาต

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

4. ผู้ใช้ระบบตัวจัดการธุรกิจและโทเค็น

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

• ไปที่ตัวจัดการธุรกิจ > การตั้งค่าธุรกิจ
• เลือกผู้ใช้ระบบ
• คลิก "เพิ่มผู้ใช้ระบบรายใหม่"
• เลือก "ผู้ใช้ระบบที่เป็นผู้ดูแล" เป็นบทบาทให้กับผู้ใช้ระบบรายนั้น

โทเค็นการเข้าถึงจะให้สิทธิ์การเข้าถึงข้อมูล Meta วิธีสร้างโทเค็นการเข้าถึงผู้ใช้ระบบ:

• ไปที่ตัวจัดการธุรกิจ > การตั้งค่าธุรกิจ
• เลือกผู้ใช้ระบบ
• เลือกผู้ใช้ระบบและคลิก "สร้างโทเค็นใหม่"
• เลือกแอพของคุณ > ในส่วน scope ให้เลือก ads_management

5. บัญชีโฆษณา

คุณจะต้องมีบัญชีโฆษณาเพื่อแสดงแคมเปญโฆษณาบน Meta หากต้องการสร้างบัญชีโฆษณา ให้ดู API การตลาดหรือศูนย์ช่วยเหลือทางธุรกิจ: เกี่ยวกับการตั้งค่าธุรกิจของคุณในตัวจัดการธุรกิจของ Meta

6. อนุญาตสิทธิ์การเข้าถึงผู้ใช้ระบบให้กับบัญชีผู้ใช้โฆษณา

อนุญาตสิทธิ์การเข้าถึงผู้ใช้ระบบของคุณให้กับบัญชีโฆษณา

• ไปที่ตัวจัดการธุรกิจ > การตั้งค่าธุรกิจ
• เลือกผู้ใช้ระบบ
• เลือกผู้ใช้ระบบและคลิก "กำหนดองค์ประกอบ"
• เลือกบัญชีโฆษณาของคุณ

7. ชุดเหตุการณ์แบบออฟไลน์

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

การใช้งานแบบเดิมทำให้คุณสามารถดำเนินการ CRUD (สร้าง อ่าน อัพเดต และลบ) กับชุดเหตุการณ์แบบออฟไลน์ได้ในระดับตัวจัดการธุรกิจ เพื่อแชร์ชุดเหตุการณ์กับอ็อบเจ็กต์และเอนทิตี้อื่นๆ

อัพโหลดข้อมูลเหตุการณ์

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

• ผู้ดูแลตัวจัดการธุรกิจ
• ผู้ใช้ระบบที่เป็นผู้ดูแล ซึ่งเป็นผู้สร้างชุดเหตุการณ์แบบออฟไลน์
• ผู้ดูแลใน ad_account ที่เชื่อมต่อกับชุดเหตุการณ์แบบออฟไลน์

ดูชุดเหตุการณ์คอนเวอร์ชั่นแบบออฟไลน์, ข้อมูลอ้างอิง

1. สร้างชุดเหตุการณ์แบบออฟไลน์

curl 
  -F 'access_token=<SYSTEM_USER_ACCESS_TOKEN>' 
  -F 'name=offline_event_set',
  -F 'description=conversion data used for superbowl campaign',
  https://graph.facebook.com/<API_VERSION>/<BUSINESS_MANAGER_ID>/offline_conversion_data_sets

สร้าง HTTP POST:

POST /<BUSINESS_MANAGER_ID>/offline_conversion_data_sets HTTP/1.1
Host: graph.facebook.com

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<BUSINESS_MANAGER_ID>/offline_conversion_data_sets

การตอบกลับจะมี id ของชุดเหตุการณ์รวมอยู่ด้วย:

{
  "id": <OFFLINE_EVENT_SET_ID>
}

พารามิเตอร์

2. กำหนดสิทธิ์การอนุญาตในบัญชีผู้ใช้โฆษณา

วิธีกำหนดการติดตามและสิทธิ์ในการอ่านให้บัญชีโฆษณา:

POST /<OFFLINE_EVENT_SET_ID>/adaccounts HTTP/1.1
Host: graph.facebook.com

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<OFFLINE_EVENT_SET_ID>/adaccounts

พารามิเตอร์

3. กำหนดการติดตามโฆษณา

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

curl \
  -F 'tracking_spec=[{action.type:"offline_conversion", dataset:["123"]}]' \
  -F 'access_token=<SYSTEM_USER_ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<AD_ID>

วิธีอัพเดตข้อมูลจำเพาะการติดตามของโฆษณาของคุณ:

POST /<AD_ID>/?tracking_specs=[{"action.type":"offline_conversion","dataset": <OFFLINE_EVENT_SET_ID>}] HTTP/1.1
Host: graph.facebook.com

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<AD_ID>/?tracking_specs=[{"action.type":"offline_conversion","dataset": <OFFLINE_EVENT_SET_ID>}]

พารามิเตอร์

4. อัพโหลดเหตุการณ์แบบออฟไลน์

คุณควรอัพโหลดธุรกรรมภายใน 62 วัน นับตั้งแต่วันที่เกิดคอนเวอร์ชั่นดังกล่าว อัพโหลดข้อมูลคอนเวอร์ชั่น:

curl \
  -F 'access_token=SYSTEM_USER_ACCESS_TOKEN' \
  -F 'upload_tag=store_data' \
  -F 'data=[ \
    { 
      match_keys: {"phone": ["HASH1","HASH2"], "email": ["HASH3","HASH4"]}, 
      currency: "USD", 
      value: 16,
      event_name: "Purchase",
      event_time: 1456870902,
      contents: [
        {id: "A", quantity: 1},
        {id: "B", quantity: 2},
        {id: "C", quantity: 1}
      ]
      custom_data: {             
      },
    }, 
    { 
      match_keys: {"lead_id": "12345"}, 
      event_name: "Lead",
      event_time: 1446336000,
      contents: [
        {id: "A", quantity: 1},
        {id: "B", quantity: 2},
        {id: "C", quantity: 1}
      ]
      custom_data: {
        event_source: "email",
        action_type: "sent_open_click",
        email_type: "email_type_code", 
        email_provider: "gmail_yahoo_hotmail",
      }
    }, 
  ]'
  https://graph.facebook.com/VERSION/OFFLINE_EVENT_SET_ID/events

หากต้องการส่งคอนเวอร์ชั่น ให้สร้าง HTTP POST:

POST /<OFFLINE_EVENT_SET_ID>/events HTTP/1.1
Host: graph.facebook.com

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<OFFLINE_EVENT_SET_ID>/events

พารามิเตอร์

ใช้ upload_tag เดียวกันสำหรับการเรียกใช้ API การอัพโหลดเหตุการณ์ทั้งหมดในแบตช์เดียวกันเพื่อทำการจัดกลุ่ม การดำเนินการนี้จะช่วยให้คุณสามารถแก้ไขจุดบกพร่องในการอัพโหลดเหตุการณ์ได้ และคุณควรนำมาใช้กับการอัพโหลดเหตุการณ์ใดๆ ก็ตามที่ดำเนินการในการเรียกใช้ API มากกว่า 1 ครั้ง

พารามิเตอร์ใน data ประกอบด้วย:

ตัวอย่างเช่น คุณสามารถอัพโหลดข้อมูลด้วยช่อง data ได้:

{
  match_keys: MATCH_KEYS,
  event_time: EVENT_TIME,
  event_name: "Purchase",
  value: 400,
  currency: "USD",
  contents: [
    {
        id: "A",
        quantity: 1,
        brand: "brand_of_A",
        category: "Apparel & Accessories | Clothing",
        price: 100,
    },
    {
        id: "B",
        quantity: 2,
        brand: "brand_of_B",
        category: "Apparel & Accessories | Shoes",
        price: 50,
    },
    {
        id: "C",
        quantity: 1,
        brand: "brand_of_C",
        category: "Apparel & Accessories | Jewelry | Watches",
        price: 200,
    }
  ],
}

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

คีย์การจับคู่

match_keys เป็นชุดตัวระบุเพื่อจับคู่ผู้คนสำหรับการระบุที่มา ดูกลุ่มเป้าหมายที่กำหนดเองจากข้อมูล CRM เพื่อทำข้อมูลให้เป็นมาตรฐานและแฮชข้อมูลของคุณ ระบบรองรับเฉพาะ SHA256 และเราไม่รับข้อมูลที่ไม่ได้ผ่านการแฮช

การตอบกลับ:

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

ดูสถิติการอัพโหลด

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

วิธีการดูสถิติเกี่ยวกับชุดเหตุการณ์แบบออฟไลน์ เช่น รายการที่ถูกต้องและรายการที่ตรงกัน:

GET /<OFFLINE_EVENT_SET_ID>/uploads HTTP/1.1
Host: graph.facebook.com

curl -X GET -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<OFFLINE_EVENT_SET_ID>/uploads

ดูข้อมูลแยกย่อยแบบรายวันของเหตุการณ์แบบออฟไลน์ใน Offline Events Manager ในตัวจัดการธุรกิจ สำหรับข้อมูลแยกย่อยที่แม่นยำยิ่งขึ้น โปรดเรียก:

GET /<OFFLINE_EVENT_SET_ID>/stats HTTP/1.1
Host: graph.facebook.com

curl -X GET -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<OFFLINE_EVENT_SET_ID>/stats

พารามิเตอร์

สร้างคอนเวอร์ชั่นที่กำหนดเองแบบออฟไลน์

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

หากต้องการสร้างคอนเวอร์ชั่นแบบกำหนดเองโดยใช้เหตุการณ์แบบออฟไลน์ของคุณ ให้สร้าง POST:

POST /act_<ACCOUNT_ID>/customconversions HTTP/1.1
Host: graph.facebook.com

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/act_<ACCOUNT_ID>/customconversions

พารามิเตอร์:

การตอบกลับเมื่อสำเร็จ:

{
  "id": <CUSTOM_CONVERSION_ID>
}

วัดผลด้วยข้อมูลที่กำหนดเอง

คุณสามารถใช้ช่อง custom_data เพื่อสร้างกฎที่กำหนดว่าจะนับคอนเวอร์ชั่นแต่ละรายการหรือไม่ในภายหลังได้ ซึ่งจะคล้ายกับกลุ่มเป้าหมายที่กำหนดเองแบบออฟไลน์คุณสามารถมีคอนเวอร์ชั่นแบบกำหนดเองได้สูงสุด 40 รายการต่อหนึ่งบัญชีโฆษณา

ตัวอย่างเช่น ใส่หมวดหมู่สินค้าให้กับรายการที่อัพโหลดโดยใช้ custom_data:

data=[
  {
    match_keys: {"phone": ["<HASH>","<HASH>"], "email": ["<HASH>","<HASH>"]}, 
    currency: "USD", 
    value: 16,
    event_name: "Purchase",
    event_time: 1456870902,
    custom_data: {
      product_category: "ICECREAM",
    },
  },
]

จากนั้นใช้ custom_data.{YOUR_CUSTOM_PARAM} เพื่อสร้างกฎคอนเวอร์ชั่นแบบกำหนดเอง:

curl \
  -F 'name=Ice Cream Purchasers' \
  -F 'custom_event_type=Purchase' \
  -F 'event_source_id=<OFFLINE_EVENT_SET_ID>' \
  -F 'rule={"and": [{"event_name":{"eq":"Purchase"}},{"custom_data.product_category":{"i_contains":"ICECREAM"}}]}' \
  -F 'access_token=<ACCESS_TOKEN>' \

"https://graph.facebook.com/<API_VERSION>/act_<ACCOUNT_ID>/customconversions"

คอนเวอร์ชั่นแบบออฟไลน์สำหรับพาร์ทเนอร์

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

1. พาร์ทเนอร์ - สร้างชุดเหตุการณ์แบบออฟไลน์
2. พาร์ทเนอร์ - แบ่งปันชุดเหตุการณ์กับตัวจัดการธุรกิจของลูกค้า
3. ลูกค้า - กำหนดสิทธิ์การอนุญาตการติดตามบัญชีผู้ใช้โฆษณาแบบออฟไลน์
4. ลูกค้า - ตั้งค่าการติดตามแบบออฟไลน์บนโฆษณา
5. พาร์ทเนอร์ - อัพโหลดเหตุการณ์แบบออฟไลน์ ดูสถิติ
6. พาร์ทเนอร์ - แสดงข้อมูลเชิงลึกของโฆษณาสำหรับลูกค้า

ขั้นตอนต่อไปนี้ขึ้นอยู่กับวิธีการตั้งค่าสิทธิ์การอนุญาตพาร์ทเนอร์หรือเอเจนซี่ด้วยบัญชีผู้ใช้โฆษณาของลูกค้า:

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

หากต้องการตั้งค่าสิทธิ์การอนุญาตเหล่านี้ โปรดดูองค์ประกอบของตัวจัดการธุรกิจ

พาร์ทเนอร์ - แชร์ชุดเหตุการณ์

แบ่งปันชุดเหตุการณ์กับตัวจัดการธุรกิจของลูกค้าของคุณ ลูกค้าของคุณจะสามารถใช้ชุดเหตุการณ์สำหรับการติดตามโฆษณาได้

GET /<OFFLINE_EVENT_SET_ID>/agencies HTTP/1.1
Host: graph.facebook.com

curl -X GET -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<OFFLINE_EVENT_SET_ID>/agencies

พารามิเตอร์

ลูกค้า - กำหนดสิทธิ์การอนุญาตการติดตามบัญชีผู้ใช้โฆษณาแบบออฟไลน์

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

คุณสามารถกำหนดสิทธิ์การอนุญาตการติดตามและการดูเหตุการณ์แบบออฟไลน์ให้กับบัญชีโฆษณาได้ด้วยการเรียกนี้:

POST /<OFFLINE_EVENT_SET_ID>/adaccounts HTTP/1.1
Host: graph.facebook.com

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<OFFLINE_EVENT_SET_ID>/adaccounts

พารามิเตอร์

ระบุ ID ภายนอก

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

พาร์ทเนอร์ด้านข้อมูลที่ได้ดำเนินกระบวนการจับคู่มาแล้วจะสามารถใช้ ID พาร์ทเนอร์เป็น ID เนมสเปซและ extern_id เป็น tpid ของคุณได้

ระบุเฉพาะ match_keys เท่านั้น

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

ระบุทั้ง match_keys และ extern_id

เราใช้ match_keys เพื่อพยายามค้นหาผู้คนบน Meta และส่งต่อการจับคู่จาก {dataset_id, extern_id} ไปยัง {facebook_user_id} หากคุณระบุ match_keys และ extern_id คุณจะไม่สามารถระบุ namespace_id ไปด้วยได้

ระบุเฉพาะ extern_id เท่านั้น

หากคุณส่งข้อมูลที่มี match_keys และ extern_id แล้ว Meta จะใช้ {dataset_id, extern_id} เพื่อเรียกดู {facebook_user_id}

ระบุ namespace_id

พารามิเตอร์ namespace_id จะใช้กับการเรียกใช้ API ทั้งหมด คุณสามารถใช้พารามิเตอร์นี้เพื่ออ้างอิงถึงชุดเหตุการณ์แบบออฟไลน์อื่นที่ธุรกิจหรือ ID โปรไฟล์พาร์ทเนอร์สามารถเข้าถึงได้หรือเป็นเจ้าของ หากคุณส่งข้อมูลที่มี match_keys และ extern_id แล้ว Meta จะใช้ {namespace_id, extern_id} เพื่อเรียกดู {facebook_user_id} คุณควรระบุ extern_id เพียง 1 รายการต่อแถวข้อมูล 1 แถวเท่านั้น

ข้อมูลเชิงลึกและการระบุที่มา

ดูเหตุการณ์แบบออฟไลน์ที่ระบุที่มาไปยังโฆษณาที่มีผู้ดูหรือคลิก เราจะระบุที่มาให้กับคอนเวอร์ชั่นแบบออฟไลน์หลังผ่านไปมากกว่า 1 วัน ซึ่งหมายความว่าคุณจะต้องตั้งค่าช่วงการระบุที่มาเป็น 28d_view หรือ action_attribution_windows=['28d_view']' มิฉะนั้นคุณจะไม่เห็นคอนเวอร์ชั่นใดๆ ในรายงาน ดู API ข้อมูลเชิงลึกและคู่มือเกี่ยวกับข้อมูลเชิงลึก

GET /act_<ADACCOUNT_ID>/insights HTTP/1.1
Host: graph.facebook.com

curl -X GET -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/act_<ADACCOUNT_ID>/insights

พารามิเตอร์

ผลลัพธ์จะมีลักษณะดังนี้:

{
  "data": [
    {
      "date_start": "2015-12-01",
      "date_stop": "2015-12-01",
      "actions": [
        {
          "action_type": "offline_conversion.purchase",
          "value": 1
        },
        {
          "action_type": "offsite_conversion.lead",
          "value": 3
        },
      ],
      ...
    }
  ]
}

ตัวอย่างเช่น วิธีดูการระบุที่มา:

curl -G \
  -d 'access_token=<SYSTEM_USER_ACCESS_TOKEN>' \
  -d 'fields=unique_actions,action_values' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/insights

ผลลัพธ์จะมีลักษณะดังนี้

{
  "data": [
    {
      "unique_actions": [
        {
          "action_type": "link_click",
          "value": 94
        },
        {
          "action_type": "offline_conversion",
          "value": 1
        },
        {
          "action_type": "offline_conversion.purchase",
          "value": 1
        },
        {
....
          "value": 1
        }
      ],
      "action_values": [
        {
          "action_type": "offline_conversion.purchase",
          "value": 27.5
        },
        {
          "action_type": "offline_conversion",
          "value": 27.5
        }
      ],
      "date_start": "2016-06-06",
      "date_stop": "2016-06-07"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MAZDZD"
    }
  }
}

ตัวเลือกการประมวลผลข้อมูลสำหรับผู้ใช้ในสหรัฐฯ

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": <EVENT_TIME>,
            "user_data": {
                "em": "<EMAIL>"
            },
            "custom_data": {
                "currency": "<CURRENCY>",
                "value": "<VALUE>"
            },
            "data_processing_options": []
        }
    ]
}

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": <EVENT_TIME>,
            "user_data": {
                "em": "<EMAIL>",
                "client_ip_address": "256.256.256.256"
            },
            "custom_data": {
                "currency": "<CURRENCY>",
                "value": "<VALUE>"
            },
            "data_processing_options": ["LDU"],
            "data_processing_options_country": 0,
            "data_processing_options_state": 0
        }
    ]
}

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": <EVENT_TIME>,
            "user_data": {
                "em": "<EMAIL>"
            },
            "custom_data": {
                "currency": "<CURRENCY>",
                "value": "<VALUE>"
            },
            "data_processing_options": ["LDU"],
            "data_processing_options_country": 1,
            "data_processing_options_state": 1000
        }
    ]
}

เรียนรู้เพิ่มเติมเกี่ยวกับตัวเลือกการประมวลผลข้อมูล