Create custom events: สร้างอีเวนท์ที่กำหนดเอง

Custom events ช่วยให้คุณสามารถกำหนดและติดตาม Events ที่เป็นเอกลักษณ์สำหรับธุรกิจของคุณ

วันที่เผยแพร่ 20 มกราคม 2568

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

มีวิธีสร้าง Custom events หลายวิธี:

• Send via API: ใช้ Custom event definition endpoint เพื่อสร้าง Event ของคุณ จากนั้นใช้ Event ID ของคุณกับ Send Custom event endpoint เพื่อส่งข้อมูลการทำ Event ไปยัง HubSpot

• Capture data จากเว็บไซต์ของคุณโดยไม่ใช้ API:

  • Code Javascript: ใช้ Custom Javascript คุณสามารถแทรกโค้ดที่กำหนดเองลงใน HubSpot tracking script โดยใช้ code editor

  • Use event visualizer (เฉพาะ Marketing Hub Enterprise เท่านั้น): ติดตาม Page views หรือ Element ที่ถูกคลิกโดยการเลือกบนเว็บไซต์ของคุณ เรียนรู้เพิ่มเติมเกี่ยวกับการสร้าง Custom events ด้วย Event visualizer

• Import spreadsheet: อัปโหลด Spreadsheet ของข้อมูล Event เพื่อเก็บกิจกรรมออฟไลน์ เติมข้อมูลย้อนหลัง หรือผสานรวมเครื่องมือใดๆ เข้ากับ HubSpot ด้วยตนเอง

• Setup webhooks: ปรับแต่งเงื่อนไขที่ทำให้ Webhook ทำงานและข้อมูลที่จะถูกส่ง

กระบวนการสร้าง Event มีสองส่วน:

1. กำหนด Event ใน HubSpot รวมถึง Custom event properties

2. สร้าง Javascript Code Snippet หรือกำหนด API call ที่จะทริกเกอร์ Event

Create event via API

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

คุณจะต้องมีข้อมูลบางอย่างสำหรับ API call ของคุณ ซึ่งคุณสามารถหาได้จากใน HubSpot:

• Event name: ชื่อภายในสำหรับ Event

• Property names: ชื่อภายในสำหรับ Properties ที่คุณจะส่งข้อมูลไป

ในการสร้าง Event เพื่อส่งข้อมูลผ่าน API:

• เลือก Send data to HubSpot และคัดลอก Tracking ID

• คลิก Create

เพื่อค้นหาชื่อภายในสำหรับ Event และ Property ที่มีอยู่:

• ในบัญชี HubSpot ของคุณ ไปที่ Data Management > Custom Events

• คลิก Custom events

• คลิกชื่อของ Event คุณจะถูกนำไปที่หน้ารายละเอียดของ Event

• ที่ด้านบน ให้ค้นหาชื่อ Event ภายใต้ Internal name
  

• เพื่อค้นหาชื่อภายในของ Properties ที่คุณจะอัปเดต คลิกชื่อ Property

• ในแผงด้านขวา คลิกไอคอนโค้ด จากนั้นดูชื่อภายใต้ Internal name
  

สร้าง Events ด้วย Javascript Code Snippet

• ในบัญชี HubSpot ของคุณ ไปที่ Data Management > Custom Events
• ที่มุมขวาบน คลิก Create an event เลือก Code Javascript
• คลิก Next
  

• ใส่ชื่อ Event และใส่คำอธิบายของ Event หากต้องการ
• เลือก Associated object เพื่อให้คุณสามารถเชื่อมโยงการทำ Event กับ Objects ต่างๆ ใน HubSpot เช่น Contacts, Companies, Deals และ Tickets
  
  

• คลิก Next

เพิ่ม Properties

เมื่อสร้าง Event แล้ว Properties เริ่มต้นจะถูกสร้างขึ้น คุณสามารถสร้าง Custom properties ของคุณเองได้ Properties ของ Event จะถูกจัดเก็บแยกต่างหากจาก CRM properties อื่นๆ และเป็นเอกลักษณ์เฉพาะสำหรับ Event (คุณไม่สามารถแก้ไข Properties เหล่านี้จากการตั้งค่าบัญชีได้)

การสร้าง Properties สำหรับ Event:

• เลือกประเภท Property โดยคลิกที่ Field type สำหรับ Property ของคุณ ตัวเลือกประกอบด้วย:

  • Custom string property: สร้าง Property ที่เป็นข้อความธรรมดา

  • Custom number property: สร้าง Property ที่เป็นค่าตัวเลข

  • Custom timestamp property: สร้าง Property ที่เป็นค่าของวันที่ คุณต้องส่งข้อมูลในรูปแบบ epoch milliseconds หรือ ISO8601

  • Custom enumeration property: สร้าง Property ที่มีค่าที่กำหนดไว้ล่วงหน้า

• • เมื่อเลือก Property ของคุณแล้ว ให้กำหนดค่าของ Property ในแผงด้านขวา:

• • ใส่ชื่อสำหรับ Property และใส่คำอธิบายสำหรับ Property

  • สำหรับ Enumeration properties คลิก Next และใส่ Labels และ Values ของ Property คุณต้องตั้งค่า Values และ Labels ก่อนที่จะส่งข้อมูล หากขั้นตอนนี้ไม่เสร็จก่อนการส่งข้อมูลที่ไม่อยู่ในรายการ ข้อมูลนั้นจะไม่สามารถใช้งานได้ หากต้องการส่งค่าหลายค่าโดยใช้ API ให้แยกค่าด้วยเครื่องหมายอัฒภาค (semicolon)

• • คลิก Done
• คลิก Next
• หลังจากตั้งค่า Event และ Properties แล้ว คุณสามารถเพิ่ม Event นี้ลงใน Tracking Code ของเว็บไซต์ของคุณโดยเลือก Javascript code snippet

การสร้าง Events ด้วย Javascript code snippet ช่วยให้คุณเพิ่ม Javascript ลงใน HubSpot tracking code ได้โดยอัตโนมัติ ซึ่งสามารถใช้สำหรับการเก็บข้อมูล Event ที่ซับซ้อนกว่าที่ Tracking code ไม่สามารถเก็บได้โดยเริ่มต้น

• เลือก Javascript code snippet ใช้ Snippet ในแผงด้านขวาเพื่อติดตาม Event ใน HubSpot Properties ใดๆ ที่ถูกสร้างขึ้นจะถูกกำหนดไว้ล่วงหน้าใน Code snippet
• ปรับเปลี่ยน Snippet ตามความจำเป็นโดยใส่ข้อความในแผงด้านขวา Code ที่คุณเพิ่มจะถูกรวมเข้ากับ HubSpot tracking code โดยอัตโนมัติ
• เมื่อเสร็จสิ้น คลิก Create เพื่อสร้าง Event และเริ่มติดตามโดยอัตโนมัติ
  
  

นำเข้าข้อมูล Event

อัปโหลดข้อมูลการเข้าร่วมจากกิจกรรมที่จัดขึ้นแบบออฟไลน์ ข้อมูลที่มีการบันทึกเวลา (timestamped data) จากแอปพลิเคชันที่ไม่ได้เชื่อมต่อกับ HubSpot ข้อมูล Lead หรือแคมเปญที่ได้รับจากผู้ให้บริการ หรือข้อมูล Event อื่นๆ ในรูปแบบสเปรดชีต Events ช่วยให้คุณสามารถเก็บพฤติกรรมและนำพฤติกรรมเหล่านั้นไปใช้ใน HubSpot ได้

การนำเข้าจะสามารถสร้างและอัปเดต Contact records ได้ การนำเข้า Event จะใช้ได้เฉพาะสำหรับ Events ที่เกิดขึ้นแล้วเท่านั้น ไฟล์การนำเข้า Event แบบ Custom ต้องมีข้อมูลต่อไปนี้:

• Contact email address

• Occurred at timestamp เรียนรู้เพิ่มเติมเกี่ยวกับการจัดรูปแบบวันที่ในไฟล์การนำเข้า

ตัวอย่างไฟล์

การนำเข้า Custom Events:

• ในบัญชี HubSpot ของคุณ ไปที่ Data Management > Custom Events
• ที่มุมขวาบน คลิก Create an event
• เลือก Import spreadsheet
  
  

• คลิก Next ใส่ชื่อ Event
• ใส่คำอธิบาย Event หากต้องการ
• เลือก Associated object ปัจจุบัน Events ที่สร้างผ่านการนำเข้าสามารถเชื่อมโยงได้เฉพาะกับ Contacts เท่านั้น

• อัปโหลดไฟล์ เลือกวิธีการนำเข้า Objects และภาษาของไฟล์ จากนั้นคลิก Next
• จับคู่คอลัมน์กับ Properties ของ Event และ Contact จากนั้นคลิก Next
• ยืนยันชื่อไฟล์การนำเข้าของคุณ
• คลิกที่ช่องทำเครื่องหมายเพื่อยืนยันว่า Contacts ในไฟล์ของคุณยินดีที่จะรับการติดต่อ และไฟล์การนำเข้าไม่มีรายชื่อที่ซื้อมา
• เลือกวันที่สำหรับ Property Occurred at
• คลิก Finish import

ตั้งค่า Webhooks

กำหนดเงื่อนไขที่ทำให้ Webhook ทำงาน

• ในบัญชี HubSpot ของคุณ ไปที่ Data Management > Custom Events
• ที่มุมขวาบน คลิก Create an event
• เลือก Setup webhooks
• คลิก Next
• ใส่ชื่อ Event และเลือก Associated object
  
  

• คลิก Next
• ตั้งค่า Test Event:

  • คัดลอก Webhook URL

  • ไปที่หน้าการตั้งค่า Webhook ในแอปพลิเคชันขอ Third-Part ที่คุณต้องการเชื่อมต่อ

  • วาง URL ที่คัดลอกมา

  • คลิก Send a test event

• คลิก Next
• ตรวจสอบ Properties สำหรับ Webhook ของคุณ คลิกที่เมนูแบบเลื่อนลง Property type เพื่อเลือกประเภท Property
  
  

• คลิก Next
• เลือก Property จาก Webhook ของ Third-Party ที่ตรงกับ Property ของ HubSpot อย่างสมบูรณ์
  
  

ใช้ข้อมูล Custom Event

ข้อมูล Custom Event สามารถดูและใช้งานได้ในเครื่องมือของ HubSpot ด้านล่างนี้เป็นวิธีดูการทำ Event completions และวิธีการนำข้อมูลนั้นไปใช้กับเครื่องมืออื่นๆ

คุณสามารถเปิด Event ที่เลือกโดยตรงในเครื่องมือ HubSpot ที่เลือกได้ผ่านทาง Actions dropdown ในรายการ Event ของคุณ มุมมอง Event เดี่ยว หรือมุมขวาบนของแผนภูมิในแท็บ Analyze

รายงานเกี่ยวกับ Custom Event

การทำ Event completions ของ Custom Event สามารถวิเคราะห์ได้จากเครื่องมือ Custom Events และข้อมูล Event จะสามารถใช้ใน Custom Report Builder และ Attribution Reports

ดูการทำ Event completions บน Timeline ของ Contact

การทำ Event completions จะแสดงใน Timeline ของ Contact record พร้อมกับ Properties ใดๆ ที่ถูกเติมข้อมูล

เพื่อดูรายละเอียด Event บน Timeline ของ Contact:

• ไปที่ Contact record ที่มีการทำ Custom Event เสร็จสมบูรณ์

• เพื่อกรอง Timeline ของ Contact ตาม Event ที่เสร็จสมบูรณ์ ให้คลิก Filter activity จากนั้นเลือก Custom event

• ใน Timeline ของ Contact คลิกเพื่อขยาย Event เพื่อแสดงรายละเอียด Event

ใช้ Custom Events ใน Workflows

ใน Workflow คุณสามารถตั้งค่าการหน่วงเวลาตามการทำ Custom Event completions โดยใช้การกระทำ Delay until event happens หรือการสมัคร Workflow trigger ที่เป็น Event

• ใน HubSpot account ของคุณ ไปที่ Automations > Workflows

• คลิกชื่อ Workflow หรือเรียนรู้วิธีสร้าง Workflow ใหม่

• เพื่อเพิ่ม Trigger:

  • ใน Workflow editor คลิก Set up triggers

  • ในแผงด้านซ้ายเลือก When an event occurs ตั้งค่า Trigger จากนั้นคลิก Apply filter

  • เพื่อปรับแต่ง Trigger เพิ่มเติม ให้คลิก Add refinement filters คุณสามารถเลือก Properties เพิ่มเติมเพื่อปรับแต่ง Object ที่คุณต้องการสมัคร Workflow

  • โดยค่าเริ่มต้น Record จะสมัคร Workflow ได้เฉพาะครั้งแรกที่ตรงกับ Trigger การสมัคร เพื่อเปิดใช้งานการสมัครซ้ำ ภายใต้ส่วน Should [object] be re-enrolled in this workflow? ให้เลือก Yes, re-enroll every time the trigger occurs

• เพื่อเพิ่ม Delay:

  • ใน Workflow editor คลิกไอคอน + plus เพื่อเพิ่มการกระทำใน Workflow

  • ในแผงด้านขวาเลือก Delay until event happens

  • ตั้งค่าการหน่วงเวลา:

    • คลิกเมนู Event dropdown จากนั้นเลือก Custom Event

    • เลือก Event property ที่คุณต้องการตั้งค่าการหน่วงเวลา

    • เลือกตัวกรองสำหรับ Event property

    • คลิก Apply filter

    • เลือกเวลารอสูงสุด หรือเลือกช่องทำเครื่องหมาย Delay as long as possible

• คลิก Save
  
  

Workflow จะหน่วงเวลาสำหรับ Records ที่สมัครไว้จนกว่าจะตรงกับเงื่อนไข Custom Event ที่กำหนดหรือจะ Trigger เมื่อ Event เกิดขึ้น

ที่มา: https://knowledge.hubspot.com/reports/create-custom-behavioral-events-with-the-code-wizard