API คอนเวอร์ชั่นสำหรับการส่งข้อความธุรกิจ

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

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

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

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

ชุดข้อมูล

เหตุการณ์การส่งข้อความธุรกิจที่ส่งผ่าน API คอนเวอร์ชั่นจะต้องเชื่อมโยงกับชุดข้อมูล

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

พิกเซลของ Meta (เหตุการณ์บนเว็บไซต์)
API เหตุการณ์ในแอพ (เหตุการณ์ในแอพ รวมถึง Facebook SDK สำหรับ iOS หรือ Android, พาร์ทเนอร์การวัดผลบนมือถือ (MMP))
API คอนเวอร์ชั่นแบบออฟไลน์ (API ดั้งเดิมของ Meta สำหรับเหตุการณ์แบบออฟไลน์)

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

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

สิทธิ์การอนุญาต

หากต้องการใช้การผสานการทำงานโดยตรงในฐานะผู้ลงโฆษณา โปรดปฏิบัติตามคำแนะนำที่นี่เพื่อดูข้อกำหนดเบื้องต้นและสิทธิ์การอนุญาต
หากต้องการใช้การผสานการทำงานแพลตฟอร์มของพาร์ทเนอร์ คุณต้องมีสิ่งต่อไปนี้
- สิทธิ์การเข้าถึงระดับสูงไปยังสิทธิ์การอนุญาต ads_read, ads_management, pages_messaging, whatsapp_business_messaging, pages_show_list และ instagram_manage_messages
- ฟีเจอร์สิทธิ์การเข้าถึงแบบมาตรฐานของการจัดการโฆษณา
- คุณต้องมีสิทธิ์การเข้าถึงระดับสูงไปยังสิทธิ์การอนุญาต page_events สำหรับเหตุการณ์บน Messenger หรือ WhatsApp events หรือ instagram_manage_events สำหรับ Instagram Direct โดยขึ้นอยู่กับประเภทของเหตุการณ์

การเริ่มต้นใช้งานของพาร์ทเนอร์

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

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

API ชุดข้อมูลสำหรับการส่งข้อความและ WhatsApp

API ชุดข้อมูลนี้ใช้เพื่อรับ dataset_id ที่แนบมากับเพจที่กำหนด dataset_id ��ี้จะใช้ในภายหลังใน API คอนเวอร์ชั่น เพื่อให้สามารถใช้ API ชุดข้อมูลได้ คุณจะต้องมีสิทธิ์การอนุญาต page_events สำหรับเหตุการณ์ใน Messenger หรือ WhatsApp ที่ไคลเอ็นต์มอบให้กับแอพของคุณผ่านการเข้าสู่ระบบด้วย Facebook สำหรับธุรกิจหรือส่วนขยาย Meta Business

หากต้องการรับ dataset_id คุณจะต้องเรียกใช้คำสั่ง GET ไปที่ API ชุดข้อมูลพร้อมด้วย page_id และ access_token โปรดดูตัวอย่างการเรียกใช้ด้านล่างนี้:

https://graph.facebook.com/v16.0/{PAGE_ID}/dataset?access_token={TOKEN}

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

API ชุดข้อมูลสำหรับ Instagram

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

หากต้องการรับ dataset_id คุณจะต้องเรียกใช้คำสั่ง GET ไปที่ API ชุดข้อมูลพร้อมด้วย ig_user_id และ access_token ด้านล่างนี้คือตัวอย่างการเรียกใช้:

https://graph.facebook.com/v16.0/{IG_USER_ID}/dataset?access_token={TOKEN}

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

การกำหนดค่า

ตั้งค่าพารามิเตอร์เหตุการณ์การส่งข้อความธุรกิจ

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

แพลตฟอร์ม	พารามิเตอร์	คำอธิบาย
Messenger	`page_id`	ต้องระบุสำหรับ Messenger ID เพจ Facebook ที่เชื่อมโยงกับธุรกิจ
Messenger	`page_scoped_user_id`	ต้องระบุสำหรับ Messenger ผู้ใช้ที่โต้ตอบกับเพจจะได้รับการระบุโดย ID ผู้ใช้ในเพจ (PSID) คุณสามารถรับ PSID ได้จาก Webhook นี้
WhatsApp	`page_id`	ต้องระบุสำหรับ WhatsApp ID เพจ Facebook ที่เชื่อมโยงกับ WhatsApp Business
WhatsApp	`ctwa_clid`	ต้องระบุสำหรับ WhatsApp `ctwa_clid` สามารถใช้งานได้จากอ็อบเจ็กต์การอ้างอิงภายใน Webhook ข้อความบน API ธุรกิจเวอร์ชั่น 2.45.1 ขึ้นไปเท่านั้น (On Premise) หรือ Cloud API
Instagram	`ig_account_id`	ต้องระบุสำหรับ Instagram ID ของบัญชี Instagram ที่เชื่อมโยงกับธุรกิจ
Instagram	`ig_sid`	ต้องระบุสำหรับ Instagram ผู้ใช้ที่โต้ตอบกับ Instagram จะได้รับการระบุโดย ID ผู้ใช้ใน Instagram (IGSID) คุณสามารถรับ IGSID ได้จาก Webhook นี้

การส่งเหตุการณ์

เมื่อต้องการส่งเหตุการณ์ใหม่ ให้ส่งคำขอ POST ไปที่ API คอนเวอร์ชั่นจากพาธนี้

https://graph.facebook.com/{API_VERSION}/{DATASET_ID}/events?access_token={TOKEN}

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

นี่คือภาพรวมที่แสดงให้เห็นว่าพารามิเตอร์มีการปรับให้เข้า��ับสกีมาโดยรวมในเพย์โหลดอย่างไร:

สำหรับเหตุการณ์ใน Messenger

{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1675999999,
      "action_source": "business_messaging",
      "messaging_channel": "messenger",
      "user_data": {
        "page_id": <PAGE_ID>,
        "page_scoped_user_id": <PSID>
      },
      "custom_data": {
        "currency": "USD",
        "value": 123
      }
    }
  ],
  "partner_agent": "<PARTNER_NAME>"
}

สำหรับเหตุการณ์ใน WhatsApp

{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1675999999,
      "action_source": "business_messaging",
      "messaging_channel": "whatsapp",
      "user_data": {
        "page_id": <PAGE_ID>,
        "ctwa_clid": "ARAkLkA8rmlFeiCktEJQ-QTwRiyYHAFDLMNDBH0CD3qpjd0HR4irJ6LEkR7JwFF4XvnO2E4Nx0-eM-GABDLOPaOdRMv-_zfUQ2a", // <CLICK_TO_WHATSAPP_CLICK_ID>
      },
      "custom_data": {
        "currency": "USD",
        "value": 123
      }
    }
  ],
  "partner_agent": "<PARTNER_NAME>"
}

สำหรับเหตุการณ์ใน Instagram

ตัวอย่างคำขอ CTD CAPI

POST /{dataset_id}/events

{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1675999999,
      "action_source": "business_messaging",
      "messaging_channel": "instagram",
      "user_data": {
        "ig_account_id": <IG_ACCOUNT_ID>,
        "ig_sid": <IGSID>
      },
      "custom_data": {
        "currency": "USD",
        "value": 123
      }
    }
  ],
  "partner_agent": "<PARTNER_NAME>"
}

การแก้ไขปัญหา

ใช้เครื่องมือทดสอบเหตุการณ์ในตัวจัดการเหตุการณ์เพื่อทดสอบ โดยมีวิธีดังนี้

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

วิดีโอแนะนำวิธีการ

ดูคำอธิบายแบบทีละขั้นตอนเกี่ยวกับวิธีนำการผสานการทำงานไปใช้ได้ที่วิดีโอนี้

เกิดข้อผิดพลาดขึ้น

เรากำลังประสบปัญหาในการเล่นวิดีโอนี้

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

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

API คอนเวอร์ชั่นสำหรับการส่งข้อความธุรกิจรองรับเหตุการณ์การส่งข้อความประเภทใด

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

มีคำแนะนำจาก Meta ให้ใช้แอพเดิมหรือใช้แอพอื่นๆ สำหรับการผสานการทำงาน API คอนเวอร์ชั่นที่แตกต่างกันหรือไม่

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

หากคอนเวอร์ชั่นเกิดขึ้นนอกเธรดข้อความ (เช่น บนเว็บไซต์หรือแอพ) เราจะส่งเหตุการณ์ไปยัง Meta ได้อย่างไร

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

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

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

ฉันสามารถนำชุดข้อมูลที่มีอยู่แล้วมาใช้ซ้ำสำหรับ API คอนเวอร์ชั่นสำหรับการส่งข้อความธุรกิจได้หรือไม่

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

หากฉันใช้ API คอนเวอร์ชั่นสำหรับเว็บไซต์อยู่ในตอนนี้ การเพิ่มการส่งข้อความธุรกิจในการผสานการทำงานเดียวกันจะรบกวนการผสานการทำงานที่มีอยู่หรือไม่

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

เราสามารถลิงก์ชุดข้อมูลกับเพจได้กี่ชุด

คำตอบ: คุณสามารถลิงก์ชุดข้อมูลกับเพจได้เพียงชุดเดียวเท่านั้น

ฉันจำเป็นต้องลบเหตุการณ์ที่ซ้ำกันก่อนที่จะส่ง API คอนเวอร์ชั่นสำหรับการส่งข้อความธุรกิจหรือไม่

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

ดูเพิ่มเติม

ภาพรวม API คอนเวอร์ชั่น
การใช้ API คอนเวอร์ชั่น
พารามิเตอร์ API คอนเวอร์ชั่น
หลักปฏิบัติที่ดีที่สุด
แพลตฟอร์ม WhatsApp Business (On Premise หรือ Cloud API) ที่มี API ธุรกิจเวอร์ชั่น 2.45.1 ขึ้นไป
API การส่งข้อความบน Instagram