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

ข้อมูลจำเพาะของเพย์โหลด

การผสานการทำงาน CRM ของคุณเข้ากับ API คอนเวอร์ชั่นของ Meta และการใช้โฆษณาแบบกรอกฟอร์มที่มีเป้าหมายเพื่อการปรับข้อมูลลูกค้าในการคอนเวอร์ชั่นให้เหมาะสมอาจให้ผลลัพธ์ที่ดีกว่า ปัจจุบัน การปรับให้เหมาะสมนี้รองรับเฉพาะโฆษณาแบบกรอกฟอร์มแบบเนทีฟ (แบบฟอร์มข้อมูลลูกค้า) ที่สร้างบน Facebook หรือ Instagram เท่านั้น

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเริ่มต้นใช้งาน API และแหล่งข้อมูลที่มีประโยชน์อื่นๆ ที่เอกสารประกอบของ API คอนเวอร์ชั่น

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

พารามิเตอร์

ชื่อคำอธิบาย

lead_id

จำนวนเต็ม

จำเป็นต้องระบุ
ID ที่ Facebook สร้างขึ้นสำหรับข้อมูลลูกค้าทุกรายการ โดยจะเป็นตัวเลข 15 หรือ 16 หลักที่ได้มาจากช่อง leadgen_id ใน Webhook การรวบรวมข้อมูลลูกค้า และรวมอยู่ในพารามิเตอร์ user_data คุณสามารถดูข้อมูลเพิ่มเติมได้ที่ "ค้นหา ID ข้อมูลลูกค้า"
โดยจำเป็นต้องใช้ ID ข้อมูลลูกค้าแทนข้อมูลของลูกค้าในการจับคู่ ให้ใช้ตัวแปรเพื่อส่งผ่านค่า ID จาก CRM ของคุณ
หมายเหตุ: ห้ามแฮช

event_name

สตริง

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

  1. ข้อมูลลูกค้าเริ่มต้นจาก Facebook
  2. ข้อมูลลูกค้าที่ผ่านเกณฑ์การตลาด
  3. โอกาสทางการขาย
  4. เปลี่ยนเป็นลูกค้าแล้ว

ให้ใช้ตัวแปรเพื่อส่งผ่านระยะต่างๆ จาก CRM ของคุณ หรือคุณอาจสร้างการเรียก API สำหรับแต่ละระยะแยกต่างหากก็ได้

event_time

จำนวนเต็ม

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

action_source

สตริง

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

lead_event_source

สตริง

ต้องระบุ
ตั้งค่าพารามิเตอร์นี้เป็นชื่อของเครื่องมือที่เป็นแหล่งที่มาของข้อมูลลูกค้า (เช่น Hubspot, SAP, Oracle, Dynamics, In-house CRM เป็นต้น) ซึ่งรวมอยู่ในพารามิเตอร์ custom_data

event_source

สตริง

ต้องระบุ
ตั้งค่าพารามิเตอร์นี้เป็นค่า crm สำหรับเหตุการณ์ข้อมูลลูกค้าในการคอนเวอร์ชั่นทั้งหมด
สำหรับการผสานการทำงานข้อมูลลูกค้าในการคอนเวอร์ชั่น การดำเนินการนี้จะแหล่งที่มาของเหตุการณ์เป็น CRM ในพารามิเตอร์ custom_data

ตัวอย่าง

ตัวอย่างนี้แสดงให้เห็นถึงรูปแบบของเพย์โหลดของเหตุการณ์ที่ส่งในการเรียก API

{
    "event_name": "my lead stage",
    "event_time": 1617693833,
    "user_data": {
        "lead_id": 1234567890123456
    },
    "action_source": "system_generated",
    "custom_data": {
        "lead_event_source": "Salesforce",
        "event_source": "crm"
    }
}

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