วิธีส่งอีเวนต์ไปยัง Pixel จากบอท

ในการถ่ายโอนอีเวนต์จากเวิร์กโฟลว์ของบอท คุณต้องมีบัญชีธุรกิจ คุณสามารถลงทะเบียน ที่นี่

วิธีสร้าง Pixel ใหม่

เลือก API Conversions

ข้อควรสนใจ! หากหน้าต่างต่อไปนี้เปิดขึ้นระหว่างการกำหนดค่า Conversion API ควรออกจากการตั้งค่าและเริ่มใหม่

หากหน้าต่างต่อไปนี้เปิดขึ้นระหว่างการกำหนดค่า Conversion API ควรออกจากการตั้งค่าและเริ่มใหม่

เลือก Pixel ที่คุณต้องการ

สร้าง access token และบันทึกไว้ในที่ปลอดภัย

วิธีถ่ายโอนอีเวนต์ไปยัง Facebook

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

ตอนนี้ จะมีตัวแปร _fbp ที่ถูกกรอกโดยอัตโนมัติในการ์ดของไคลเอนต์ที่มาจากมินิแลนดิง ตัวแปรนี้สามารถส่งไปยัง Pixel พร้อมกับอีเวนต์ได้

คุณต้องกำหนดค่าการตั้งค่าต่อไปนี้ในบล็อกที่คุณต้องการส่งอีเวนต์:

URL ของฟังก์ชัน:

https://store.mavibot.ai/function/fb_pixel

ตัวอย่างพารามิเตอร์:

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "Entered the bot",
  "event_source_url": "https://my_best_site.com",
  "action_source": "chat",
  "fbp": "#{_fbp}",
  "fbc": "#{_fbc}"
}

พารามิเตอร์ที่จำเป็น

pixel_id — ID ของ Pixel

access_token — โทเค็นสำหรับเข้าถึง API

event_name — ชื่อของอีเวนต์ คุณสามารถใช้ชื่อมาตรฐาน เช่น Lead, PageView, Purchase และอื่นๆ (ดูเพิ่มเติม ที่นี่) รวมถึงชื่อที่คุณกำหนดเอง เช่น Entered the bot

event_source_url — โดเมนที่ได้รับการอนุมัติบน Facebook

fbp — ID เบราว์เซอร์ของไคลเอนต์

พารามิเตอร์เพิ่มเติม (ไม่บังคับ)

action_source — (ค่าเริ่มต้นคือ other) ฟิลด์นี้ช่วยให้คุณระบุตำแหน่งที่เกิดการแปลงได้อย่างแม่นยำ ข้อมูลเกี่ยวกับตำแหน่งที่เกิดอีเวนต์ช่วยให้มั่นใจว่าโฆษณาของคุณแสดงต่อกลุ่มเป้าหมายที่เหมาะสม

คุณสามารถตั้งค่าต่อไปนี้ในฟิลด์ action_source:

ค่า คำอธิบาย
email การแปลงเกิดขึ้นผ่านอีเมล
website การแปลงเกิดขึ้นบนเว็บไซต์
phone_call การแปลงเกิดขึ้นผ่านโทรศัพท์
chat การแปลงเกิดขึ้นผ่านแอปส่งข้อความ SMS หรือแชทออนไลน์
physical_store การแปลงเกิดขึ้นในร้านค้าจริง
system_generated การแปลงเกิดขึ้นโดยอัตโนมัติ เช่น จากการต่ออายุสมาชิกรายเดือน
business_messaging การแปลงเกิดขึ้นในการสนทนาหลังจากลูกค้าคลิกโฆษณา Click-to-WhatsApp
other การแปลงเกิดขึ้นด้วยวิธีอื่น

วิธีทดสอบอีเวนต์

ในการทดสอบอีเวนต์ ให้เพิ่มพารามิเตอร์ test_event_code พร้อมกับข้อความที่เก็บอยู่ในแท็บ Testing messages ในเนื้อหาของคำขอ

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "Entered the bot",
  "event_source_url": "https://my_best_site.com",
  "fbp": "#{_fbp}",
  "fbc": "#{_fbc}",
  "test_event_code": "TEST11421"
}

ข้อควรสนใจ! อย่าลืมลบพารามิเตอร์ test_event_code ออกจากคำขอเมื่อเปิดใช้เวอร์ชันจริง

พารามิเตอร์เพิ่มเติมอื่นๆ (ไม่บังคับ)

fn — ชื่อจริง

ln — นามสกุล

email — อีเมลของไคลเอนต์

phone — หมายเลขโทรศัพท์ของไคลเอนต์

fbc — ID การคลิก

gender — เพศของไคลเอนต์ (f — หญิง, m — ชาย)

country — ประเทศ

state — รัฐ

city — เมือง

index — รหัสไปรษณีย์ของไคลเอนต์ (ZIP code)

external_id — ID ไคลเอนต์ที่ไม่ซ้ำกัน เช่น ID ผู้ใช้หรือ ID ของไฟล์คุกกี้ของบุคคลที่สาม

client_ip_address — ที่อยู่ IP ของไคลเอนต์

client_user_agent — user agent ของเบราว์เซอร์ไคลเอนต์

คุณยังสามารถส่งพารามิเตอร์ของคุณเองไปยัง Pixel ได้ โดยเพิ่มพารามิเตอร์ my_params ที่ไม่บังคับและระบุฟิลด์ของคุณเองในนั้น

ตัวอย่าง:

{
  "my_params": {
    "value1": "Hello",
    "val2": "Hi"
  }
}

ตัวอย่างเต็มรูปแบบ

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "Entered the bot",
  "event_source_url": "https://my_best_site.com",
  "email": "[email protected]",
  "phone": "1234567890",
  "currency": "USD",
  "value": "142.52",
  "test_event_code": "TEST11421",
  "external_id": "#{client_id}",
  "fn": "#{name}",
  "gender": "m",
  "post_index": "12345",
  "my_params": {
    "value1": "Hello",
    "val2": "Hi"
  }
}

ข้อควรสนใจ! อย่าลืมลบพารามิเตอร์ test_event_code ออกจากคำขอเมื่อเปิดใช้เวอร์ชันจริง

วิธีเพิ่มบัญชีโฆษณา

ก่อนอื่น คุณต้องเปิดการเข้าถึงบัญชีของคุณ

บันทึกและไปที่แท็บ Related Objects → Add Objects

จากนั้นเพิ่มบัญชีโฆษณาของคุณ

การแปลงคลิกเป็นโฆษณา Click-to-WhatsApp

ส่วนเพิ่มเติมของเอกสารสำหรับฟังก์ชัน fb_pixel_event()

Meta* ทำเครื่องหมายทุกการคลิกจากโฆษณา Click-to-WhatsApp ด้วยตัวระบุการคลิก ctwa_clid ซึ่งจะได้รับพร้อมกับข้อความ WhatsApp แรกของลูกค้า และใช้เพื่อระบุแหล่งที่มาของการแปลงจากการสนทนาไปยังโฆษณาเฉพาะ — คล้ายกับวิธีที่อีเวนต์ของ Pixel ถูกระบุแหล่งที่มาจากการคลิกเว็บไซต์

ลายเซ็น

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data,
    ctwa_clid,
    messaging_channel
)

พารามิเตอร์ใหม่

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

ค่า action_source ใหม่

ค่าต่อไปนี้พร้อมใช้งานสำหรับ action_source:

ค่า คำอธิบาย
business_messaging การแปลงเกิดขึ้นในการสนทนาหลังจากลูกค้าคลิกโฆษณา Click-to-WhatsApp

อีเวนต์จะถูกส่งเป็นการแปลงผ่านข้อความหากตรงตามเงื่อนไขอย่างน้อยหนึ่งข้อต่อไปนี้:

  • มีการระบุ action_source="business_messaging";
  • มีการระบุ ctwa_clid;
  • มีการระบุ messaging_channel

ในกรณีนี้ Meta* จะได้รับชุดค่าผสม action_source + messaging_channel + ctwa_clid หากไม่มีชุดค่าผสมนี้ การคลิกโฆษณาจะไม่ถูกระบุแหล่งที่มาของการแปลง

ค่า website ต้องไม่ใช้สำหรับการแปลงผ่านข้อความ: อีเวนต์จะไปถึง Pixel แต่จะไม่ถูกระบุแหล่งที่มาของโฆษณา

ตัวแปรไคลเอนต์

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

ตัวแปร คำอธิบาย
ctwa_clid ตัวระบุการคลิก ถูกเพิ่มลงในอีเวนต์โดยอัตโนมัติ
ctwa_clid_time เวลาที่ได้รับตัวระบุ ในรูปแบบเวลา Unix ใช้เพื่อกำหนดระยะเวลาที่ผ่านไปตั้งแต่การคลิก
wa_ads_data ข้อมูลโฆษณาในรูปแบบ JSON: URL โฆษณา, ID โฆษณา (source_id), ชื่อเรื่อง, คำอธิบาย, ประเภทครีเอทีฟ และ URL ครีเอทีฟ

ตัวระบุการคลิกถูกนำมาจากตัวแปรไคลเอนต์โดยอัตโนมัติ ดังนั้นคุณไม่จำเป็นต้องส่งไปยังฟังก์ชันอย่างชัดเจน

หมายเลขโทรศัพท์ของลูกค้าจะถูกเพิ่มลงในอีเวนต์โดยอัตโนมัติหากไม่ได้ระบุใน data

พารามิเตอร์ event_source_url ไม่ถูกใช้สำหรับการแปลงผ่านข้อความ

ข้อจำกัด

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

Meta ให้ ctwa_clid สำหรับการคลิกจากแอป Facebook และ Instagram บน Android และ iOS

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

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

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

No ctwa_clid variable in client variables