API คุณภาพการผสานการทำงาน

API นี้ยังอยู่ในช่วงเบต้า หากต้องการใช้งาน โปรดติดต่อตัวแทน Meta ของคุณ

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

เกี่ยวกับคุณภาพการจับคู่เหตุการณ์

คุณภาพการจับคู่เหตุการณ์

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

วิธีคำนวณ

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

วิธีนำไปใช้

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

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

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

กรณีการใช้งานทั่วไป

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

การยืนยันตัวตน

การยืนยันตัวตนของผู้ลงโฆษณาผ่านตัวจัดการธุรกิจ

  1. ในตัวจัดการธุรกิจ ให้ไปที่ส่วน "ผู้ใช้" และเลือกแท็บผู้ใช้ระบบ ให้คลิกผู้ใช้ระบบที่คุณต้องการใช้กับ API คอนเวอร์ชั่น
  2. ไปที่กล่องโต้ตอบ "กำหนดองค์ประกอบ" แล้วเลือกพิกเซล จากนั้น ให้เลือกว่าคุณต้องการส่งเหตุการณ์ในนามของพิกเซลใด
  3. สำหรับพิกเซลแต่ละรายการ ให้เลือกสิทธิ์การอนุญาต "จัดการพิกเซล" แล้วคลิกบันทึกการเปลี่ยนแปลง
  4. กลับไปยังหน้ารายละเอียดผู้ใช้ระบบของคุณ ตรวจสอบยืนยันว่าพิกเซลที่เลือกแสดงอยู่ในหน้านั้น
  5. หากต้องการสร้างโทเค็นการเข้าถึง ให้ทำตามคำแนะนำที่นี่

การยืนยันตัวตนบนแพลตฟอร์มของพาร์ทเนอร์

คุณต้องขออนุญาตเพื่อส่งเหตุการณ์ในนามของลูกค้าของคุณก่อน โดยคุณมีตัวเลือกในการยืนยันตัวตนดังต่อไปนี้

การเข้าสู่ระบบด้วย Facebook สำหรับธุรกิจ (แนะนำ)

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

ส่วนขยาย Meta Business (แนะนำ)

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

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

ลูกค้าแชร์พิกเซลของ Meta ไปยังตัวจัดการธุรกิจของพาร์ทเนอร์

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

การเรียกดูข้อมูลคุณภาพการผสานการทำงานพิกเซล

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

ตำแหน่งข้อมูล

https://graph.facebook.com/v21.0/<pixel_id>/integration_quality

พารามิเตอร์

พารามิเตอร์คำอธิบาย
agent_name
สตริง

ระบุหรือไม่ก็ได้
ระบบจะใช้ค่าที่เป็นมาตรฐานของช่อง partner_agent เพื่อกรองเฉพาะเหตุการณ์ที่ส่งด้วยพารามิเตอร์ partner_agent ในคำขอ POST /{pixel_id}/events (โปรดดูหลักปฏิบัติที่ดีที่สุดในการระบุที่มาของเหตุการณ์ของคุณที่นี่และที่นี่)

ตัวอย่างเช่น หาก partner_agent มีค่าเป็น [partner_name]_[majorversion]_[minorVersion] ค่าสตริงตัวแทนที่เป็นมาตรฐานของคุณก็จะเป็น partner_name โดยใช้อักษรตัวพิมพ์เล็ก

agent_name จะช่วยให้คุณสามารถตั้งค่าตัวระบุแพลตฟอร์มของคุณเองเมื่อส่งเหตุการณ์ในนามของลูกค้าได้ หากคุณเป็นเอเจนซี่/พาร์ทเนอร์ภายใต้สัญญา ให้ทำงานร่วมกับตัวแทน Meta เพื่อยอมรับการใช้ตัวระบุสำหรับแพลตฟอร์มของคุณ

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

หากคุณไม่ได้ระบุ agent_name ระบบจะนำเหตุการณ์ทั้งหมด (ไม่ว่าจะส่งโดยตัวแทนหรือไม่) มาใช้ในการคำนวณ EMQ

ช่อง

ช่องคำอธิบาย
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="&lt;AGENT_NAME&gt;"' \
  -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.

เรียนรู้เพิ่มเติม

  1. หลักปฏิบัติที่ดีที่สุดเกี่ยวกับ API คอนเวอร์ชั่น

  2. เพิ่มประสิทธิภาพการทำงานด้วยการตั้งค่า API คอนเวอร์ชั่นที่ได้รับการปรับให้เหมาะสม

  3. หลักปฏิบัติที่ดีที่สุดในการเริ่มต้นใช้งาน API คอนเวอร์ชั่นสำหรับพาร์ทเนอร์

  4. คำแนะนำเกี่ยวกับคุณภาพการตั้งค่า API คอนเวอร์ชั่นจากศูนย์ช่วยเหลือทางธุรกิจของ Meta:

  • ดูรายละเอียดของเหตุการณ์บนเซิร์ฟเวอร์ในตัวจัดการเหตุการณ์ของ Meta หลังจากตั้งค่า API คอนเวอร์ชั่นแล้ว ธุรกิจก็จะสามารถใช้บทความนี้ในการเรียนรู้วิธีตรวจสอบเหตุการณ์และพารามิเตอร์ต่างๆ ได้ เพื่อให้การตั้งค่าทำงานได้อย่างมีประสิทธิภาพและพบโอกาสในการปรับปรุงให้ดียิ่งขึ้น ธุรกิจยังใช้บทความนี้เพื่อเรียนรู้วิธีใช้รายละเอียดของเหตุการณ์บนเซิร์ฟเวอร์ (การจับคู่เหตุการณ์ [คุณภาพการจับคู่เหตุการณ์/EMQ], ความใหม่ของข้อมูล, ภาพรวมของเหตุการณ์ และการลบเหตุการณ์ที่ซ้ำกัน) ในตัวจัดการเหตุการณ์เพื่อปรับปรุงการตั้งค่า API คอนเวอร์ชั่นได้ด้วย