API นี้ยังอยู่ในช่วงเบต้า หากต้องการใช้งาน โปรดติดต่อตัวแทน Meta ของคุณ
ผู้ลงโฆษณาที่แชร์เหตุการณ์บนเซิร์ฟเวอร์โดยใช้ API คอนเวอร์ชั่นจะดูคุณภาพการจับคู่เหตุการณ์ได้ในตัวจัดการเหตุการณ์ แต่วิธีนี้จะใช้ได้ทีละรายการเท่านั้น และขยายการใช้งานได้ยากในกรณีที่พาร์ทเนอร์ผู้ให้บริการเทคโนโลยี พาร์ทเนอร์เอเจนซี่ หรือผู้ลงโฆษณาจัดการพิกเซลของ Meta หลายร้อยหรือหลายพันรายการให้กับธุรกิจของตน API คุณภาพการผสานการทำงานช่วยแก้ปัญหานี้ได้ด้วยการรวมเกณฑ์ชี้วัดด้านคุณภาพการผสานการทำงานอย่างทั่วถึงโดยใช้โปรแกรม
คุณภาพการจับคู่เหตุการณ์ (EMQ) คือคะแนน (เต็ม 10) ซึ่งบ่งชี้ว่า ข้อมูลลูกค้าที่ส่งมาจากเซิร์ฟเวอร์ของคุณมีประสิทธิภาพเพียงใดในการจับคู่อินสแตนซ์เหตุการณ์เข้ากับบัญชี Facebook การจับคู่เหตุการณ์ที่มีคุณภาพสูงอาจช่วยยกระดับการระบุที่มาและประสิทธิภาพการทำงานของโฆษณาให้ดีขึ้นได้ โปรดทราบว่าเกณฑ์ชี้วัดนี้อยู่ระหว่างการพัฒนา
"คุณภาพการจับคู่เหตุการณ์" จะคำนวณโดยดูจากพารามิเตอร์ข้อมูลลูกค้าที่ได้รับจากเซิร์ฟเวอร์ของคุณผ่านการผสานการทำงาน API คอนเวอร์ชั่น คุณภาพของข้อมูลที่ได้รับ และเปอร์เซ็นต์ของอินสแตนซ์เหตุการณ์ที่ได้รับการจับคู่กับบัญชี Meta
"คุณภาพการจับคู่เหตุการณ์" ใช้ประเมินว่าคุณกำลังส่งข้อมูลลูกค้าที่เหมาะสมเพื่อจับคู่เหตุการณ์กับบัญชี Meta ผ่าน API คอนเวอร์ชั่นอยู่หรือไม่ และประเมินว่าคุณได้ตั้งค่าพารามิเตอร์ข้อมูลลูกค้าถูกต้องแล้วหรือไม่ พารามิเตอร์ข้อมูลลูกค้าจะช่วยจับคู่เหตุการณ์กับบัญชี Meta เพื่อให้คุณสามารถระบุได้ว่าคอนเวอร์ชั่นมีที่มาจากโฆษณาของคุณ และแสดงโฆษณาให้กับผู้ใช้ที่มีแนวโน้มสูงสุดที่จะเกิดคอนเวอร์ชั่น
ระบบจะคำนวณ "คุณภาพการจับคู่เหตุการณ์" แบบเรียลไทม์ โปรดเรียนรู้เพิ่มเติมเกี่ยวกับหลักปฏิบัติที่ดีที่สุดของ EMQ ที่นี่
EMQ ใช้ได้กับเหตุการณ์บนเว็บเท่านั้นในขณะนี้ ในส่วนของเหตุการณ์ประเภทอื่นๆ เช่น เหตุการณ์ออฟไลน์และเหตุการณ์ที่หน้าร้าน เหตุการณ์ในแอพ ข้อมูลลูกค้าที่สร้างคอนเวอร์ชั่น หรือการผสานการทำงานใดๆ ในช่วงอัลฟ่าหรือเบต้า โปรดติดต่อตัวแทน Meta เพื่อขอคำแนะนำในการเพิ่มคุณภาพการจับคู่
พาร์ทเนอร์และเอเจนซี่สามารถใช้ API คุณภาพการผสานการทำงานเพื่อแสดงแดชบอร์ดและข้อมูลเชิงลึกเกี่ยวกับคุณภาพ ในขณะเดียวกันก็ช่วยผู้ลงโฆษณาในการเพิ่มประสิทธิภาพและปรับการผสานการทำงานให้เหมาะสมไปด้วย พาร์ทเนอร์ยังใช้การผสานการทำงานนี้เพื่อตรวจสอบความเสถียรของการผสานการทำงาน API คอนเวอร์ชั่นได้ด้วย ผู้ลงโฆษณาสามารถใช้ตำแหน่งข้อมูลนี้ในการรวบรวมข้อมูลคุณภาพการผสานการทำงานเพื่อนำมาใช้ประกอบการตรวจสอบได้
คุณต้องขออนุญาตเพื่อส่งเหตุการณ์ในนามของลูกค้าของคุณก่อน โดยคุณมีตัวเลือกในการยืนยันตัวตนดังต่อไปนี้
การเข้าสู่ระบบด้วย Facebook สำหรับธุรกิจคือโซลูชั่นในการยืนยันตัวตนและการอนุญาตที่แนะนำสำหรับผู้ให้บริการเทคโนโลยีและผู้พัฒนาแอพทางธุรกิจที่ต้องการเข้าถึงสินทรัพย์ของลูกค้าธุรกิจ ซึ่งจะช่วยให้คุณสามารถระบุประเภทโทเค็นการเข้าถึง ประเภทสินทรัพย์ และสิทธิ์การอนุญาตที่แอพของคุณจำเป็นต้องใช้ และบันทึกเป็นกลุ่มย่อย (การกำหนดค่า) ได้ จากนั้นคุณสามารถนำเสนอกลุ่มย่อยดังกล่าวให้ลูกค้าธุรกิจของคุณนำไปดำเนินขั้นตอนให้เสร็จสมบูรณ์และมอบสิทธิ์การเข้าถึงสินทรัพย์ธุรกิจของตนให้แก่แอพของคุณได้
เมื่อใช้ตัวเลือกนี้ ส่วนขยาย Meta Business (MBE) จะส่งคืนข้อมูลทั้งหมดที่จำเป็นต่อการส่งเหตุการณ์ในนามของลูกค้า MBE จะให้ตำแหน่งข้อมูลเพื่อเรียกดูโทเค็นการเข้าถึงของผู้ใช้ระบบที่สร้างขึ้นมาในตัวจัดการธุรกิจของลูกค้า กระบวนการนี้มีการใช้สิทธิ์การอนุญาตในการส่งเหตุการณ์บนเซิร์ฟเวอร์และดำเนินการโดยอัตโนมัติอย่างปลอดภัย ขณะนี้ MBE อยู่ในช่วงเบต้า โปรดติดต่อตัวแทน Meta ของคุณเพื่อขอสิทธิ์ใช้งาน
ตำแหน่งข้อมูลดังกล่าวจะต้องใช้โทเค็นการเข้าถึงของผู้ใช้เป็นพารามิเตอร์อินพุต หากคุณเป็นผู้ใช้ MBE รายใหม่ ให้เรียกใช้ตำแหน่งข้อมูลนี้เพื่อดึงข้อมูลโทเค็นการเข้าถึงของผู้ใช้ระบบหลังจากตั้งค่า MBE เสร็จแล้ว ส่วนผู้ที่ใช้อยู่แล้วก็จะต้องขอยืนยันตัวตนใหม่ก่อนเรียกใช้ตำแหน่งข้อมูล API ใหม่นี้
เมื่อใช้ตัวเลือกนี้ ลูกค้าจะแชร์พิกเซลของ Meta ไปให้พาร์ทเนอร์ผ่านการตั้งค่าตัวจัดการธุรกิจหรือผ่าน API จากนั้น พาร์ทเนอร์จะสามารถกำหนดผู้ใช้ระบบของพาร์ทเนอร์ให้กับพิกเซลของลูกค้า และสร้างโทเค็นการเข้าถึงเพื่อส่งเหตุการณ์บนเซิร์ฟเวอร์ได้
คุณสามารถตรวจสอบคะแนน "คุณภาพการจับคู่เหตุการณ์" ต่อเหตุการณ์ร่วมกับคีย์จับคู่ที่ส่งได้ โดยใช้ตำแหน่งข้อมูล API, พารามิเตอร์ และช่องต่อไปนี้
https://graph.facebook.com/v21.0
/<pixel_id>/integration_quality
พารามิเตอร์ | คำอธิบาย |
---|---|
agent_name สตริง | ระบุหรือไม่ก็ได้ ตัวอย่างเช่น หาก partner_agent มีค่าเป็น
หากคุณเป็นผู้ลงโฆษณา โดยปกติแล้วคุณไม่ควรกังวลในเรื่องการระบุที่มาของ หากคุณไม่ได้ระบุ |
ช่อง | คำอธิบาย |
---|---|
event_name สตริง | |
event_match_quality AdsPixelCAPIEMQ | คุณภาพการจับคู่เหตุการณ์จะบ่งชี้ว่า ข้อมูลลูกค้าที่ส่งมาจากเซิร์ฟเวอร์ของคุณมีประสิทธิภาพเพียงใดในการจับคู่อินสแตนซ์เหตุการณ์เข้ากับบัญชี Facebook |
Graph API Explorer
GET/v21.0
/<PIXEL_ID>/integration_quality?fields=event_match_quality,event_name&agent_name=<AGENT_NAME>&access_token=<ACCESS_TOKEN>
cURL
curl -X GET -G \ -d 'fields="event_match_quality,event_name"' \ -d 'agent_name="<AGENT_NAME>"' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<LATEST_VERSION>/<PIXEL_ID>/integration_quality
การตอบกลับ API
{ "data": [ { "event_match_quality": { "composite_score": 5.1, "match_key_feedback": [ { "identifier": "email", "coverage": { "percentage": 100 } }, { "identifier": "user_agent", "coverage": { "percentage": 100 } }, { "identifier": "external_id", "coverage": { "percentage": 100 } } ] }, "event_name": "pLTVPurchase" }, { "event_match_quality": { "composite_score": 7.2, "match_key_feedback": [ { "identifier": "email", "coverage": { "percentage": 100 } }, { "identifier": "user_agent", "coverage": { "percentage": 100 } }, { "identifier": "phone", "coverage": { "percentage": 69.1 } }, { "identifier": "fbp", "coverage": { "percentage": 96.7 } }, { "identifier": "external_id", "coverage": { "percentage": 100 } }, { "identifier": "fbc", "coverage": { "percentage": 3.2 } } ] }, "event_name": "CompleteRegistration" } ] }
The access token is used when partners send signal events or access the Setup Quality API on behalf of advertisers. The client system user access token onboarding method is not compatible with the EMQ API at the moment.
The partner_agent
value in your API GET request should be a normalized lowercase format. This field is now optional.
เพิ่มประสิทธิภาพการทำงานด้วยการตั้งค่า API คอนเวอร์ชั่นที่ได้รับการปรับให้เหมาะสม
หลักปฏิบัติที่ดีที่สุดในการเริ่มต้นใช้งาน API คอนเวอร์ชั่นสำหรับพาร์ทเนอร์
คำแนะนำเกี่ยวกับคุณภาพการตั้งค่า API คอนเวอร์ชั่นจากศูนย์ช่วยเหลือทางธุรกิจของ Meta: