API คอนเวอร์ชั่น

ตั้งค่า API คอนเวอร์ชั่นแบบเป็นแพลตฟอร์ม

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

ความแตกต่างระหว่างเหตุการณ์ในเซิร์ฟเวอร์กับเหตุการณ์ในเบราว์เซอร์

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

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

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

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

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

ข้อกำหนดเบื้องต้น

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

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

เริ่มต้นใช้งาน

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

ขั้นตอนที่ 1: สร้างธุรกิจ

ขั้นตอนที่ 2: สร้างแอพของ Meta ในธุรกิจที่คุณเพิ่งสร้างใหม่

ขั้นตอนที่ 3: สร้างพิกเซลของ Meta ใน ธุรกิจที่คุณเพิ่งสร้างใหม่ โดยดำเนินการดังนี้

ขั้นตอนที่ 4: สร้างโทเค็นการเข้าถึงของผู้ใช้ระบบ

ขั้นตอนที่ 5: ส่งเหตุการณ์ในเซิร์ฟเวอร์ไปยังพิกเซล Meta ของคุณ

ส่งเหตุการณ์ในนามของลูกค้า

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

สำหรับพิกเซลของ Meta ที่มีเจ้าของเป็นหรือจัดการโดยตัวจัดการธุรกิจของพาร์ทเนอร์

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

สำหรับพิกเซลของ Facebook ที่ไม่ได้จัดการโดยพาร์ทเนอร์

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

ส่วนเสริมสำหรับ Facebook Business (แนะนำ)

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

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

โทเค็นการเข้าถึงผู้ใช้ระบบของลูกค้า

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

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

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

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

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

ระบุที่มาของเหตุการณ์เป็นแพลตฟอร์มของคุณโดยใช้ฟิลด์ partner_agent

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

ตัวอย่างเพย์โหลดของเหตุการณ์

หากคุณใช้ datapartner เป็นตัวระบุของแพลตฟอร์ม นี่คือตัวอย่างเพย์โหลดเหตุการณ์การซื้อที่ส่งในนามของลูกค้า

    
{
  "data": [
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "event_name": "PageView",
      "event_time": 1579645238
    },
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "custom_data": {
        "currency": "USD",
        "value": "50"
      },
      "event_name": "Purchase",
      "event_time": 1579645238
    }
  ],
  "partner_agent": "datapartner"
}

คำถามที่พบบ่อย

Sending events sent via the Conversions API is just like sending events via Facebook Pixel. The only difference is that the event is sent via the server, instead of the browser. So, why make an effort to integrate with the Conversions API? Here are some important use cases:

Capture offline and down-funnel events

If someone uses an advertisers’ website to sign up for a credit card, they can send events such as ViewContent, Application Start, and Application Submit via the browser to the Facebook Pixel. However, the end user still needs to be approved for this credit card. The Approval event happens offline and cannot be sent via browser. To register this final step, the advertiser can send the Approval via the Conversions API.

Signal resiliency

Browser side events can be lost for many reasons:

  • The user might navigate away before the page has finished loading.
  • Ad blockers could prevent the event from firing.
  • The changing internet landscape might change the way inter-domain messages are sent.

These examples can all be mitigated by sending events via the Conversions API.

Sensitive data

Many advertisers have expressed concerns about sharing data via the browser when that data could be seen or inspected. This can be mitigated by sending data via the Conversions API.

For example, advertisers may want to send data like profit margin or lifetime value (LTV) along with a purchase event. This way, ads can be optimized towards a specific type of customer.

ลิงก์ถาวร

Since browser events are always vulnerable to obstacles, we recommend that you only send events collected from the Conversions API sources. For example, if:

  • One of the ways your customer ingests data into your platform is via a browser JavaScript tag, or
  • You send that data to Facebook via the Conversions API

the data is open to the browser-side risks.

To take full advantage of the Conversions API, no part of the data flow should be reliant on the browser.

ลิงก์ถาวร

We recommend that you provide advertisers with a way to test this connection on your own platform.

  1. Send a test event via the Conversions API to the advertiser’s pixel. Look for a 200 return code.
  2. Update the status of the connection appropriately.
ลิงก์ถาวร

Facebook tries to deduplicate identical events sent through the Facebook Pixel and the Conversions API. We determine if events are identical based on their event_id and event_name. For more information, see Handling Duplicate Pixel and Conversions API Events.

ลิงก์ถาวร

The external_id parameter is a string that represents a user on an advertiser's system. These IDs help improve ads attribution and create audiences.

You can send external_ids via browser or the Conversions API, but you must be consistent across channels. For example, if you send a browser pixel event with external_id set to 123, your server event for that same user should also have external_id set to 123.

ลิงก์ถาวร