อีเวนต์เริ่มต้น

อีเวนต์เริ่มต้นคืออะไร

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

Default Events พร้อมใช้งานทันทีสำหรับ SDK เวอร์ชันล่าสุด ไม่จำเป็นต้องตั้งค่าเพิ่มเติม ยกเว้น PW_InAppPurchase (ดูรายละเอียดด้านล่าง)

หากต้องการค้นหาและเปิดใช้งาน Default Events ที่มีอยู่ใน Pushwoosh ให้ทำตามขั้นตอนเหล่านี้:

ไปที่แท็บ Events ภายในส่วน Audience
คลิก Create Event
เลือก Default Event จากเมนูแบบเลื่อนลง
ในหน้าต่างป๊อปอัป เลือกอีเวนต์ที่ต้องการแล้วคลิก Activate

เมนูแบบเลื่อนลงของ Default Events ที่แสดงอีเวนต์ที่สามารถเปิดใช้งานได้

เมื่อเปิดใช้งานแล้ว Default Events สามารถใช้ในการส่งข้อความตามพฤติกรรมได้ ตัวอย่างเช่น ใช้เป็น Trigger-based Entry ใน Customer Journey หรือเป็นทริกเกอร์สำหรับข้อความ In-App

หากต้องการดูว่าคุณสามารถใช้ Default Events เพื่อสร้างแคมเปญการตลาดใน Pushwoosh และเปลี่ยนผู้ใช้ฟรีให้เป็นลูกค้าที่ชำระเงินโดยอัตโนมัติได้อย่างไร โปรดดูวิดีโอสอนนี้:

การใช้งานอุปกรณ์และแอป

PW_DeviceRegistered

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

แอตทริบิวต์ของอีเวนต์

platform (string): ชื่อแพลตฟอร์มของอุปกรณ์ที่ลงทะเบียน
platform_id (integer): รหัสแพลตฟอร์ม ค่าเดียวกับ device_type ใน registerDevice

กรณีการใช้งาน

เปิดตัวแคมเปญการเริ่มต้นใช้งานสำหรับผู้ใช้ที่ลงทะเบียนใหม่ เพิ่ม Trigger-based Entry โดยใช้อีเวนต์ PW_DeviceRegistered ไปยัง Customer Journey การเริ่มต้นใช้งาน
ระบุกิจกรรมการได้มาซึ่งลูกค้าที่นำผู้ใช้ใหม่มาให้คุณมากขึ้นด้วยสถิติของอีเวนต์
ดึงดูดผู้ใช้ตั้งแต่การเข้าชมครั้งแรก ต้อนรับพวกเขาด้วย In-Apps ที่ถูกกระตุ้นโดยอีเวนต์ DeviceRegistered

ข้อความในแอปที่ถูกกระตุ้นโดยอีเวนต์ DeviceRegistered สำหรับการเริ่มต้นใช้งานผู้ใช้ใหม่

PW_DeviceUnregistered

อีเวนต์นี้จะทำงานเมื่อแอปถูกถอนการติดตั้ง หรือผู้ใช้เลือกไม่รับอีเมลหรือ push notifications

แอตทริบิวต์ของอีเวนต์

message_id (string)
message_code (string)
campaign_id (string)
platform (string)
platform_id (integer)

กรณีการใช้งาน

รักษาผู้ใช้ไว้เมื่อพวกเขาตัดสินใจหยุดใช้แอปของคุณ ตัวอย่างเช่น คุณสามารถส่ง อีเมล พร้อมข้อเสนอพิเศษให้กับผู้ใช้ทุกคนที่ถอนการติดตั้งแอป
รักษาการสื่อสารกับผู้ใช้ที่ยกเลิกการสมัครรับข้อมูลจากช่องทางใดช่องทางหนึ่งของคุณ ตัวอย่างเช่น หากผู้ใช้ไม่ต้องการรับ push notifications อีกต่อไป คุณสามารถส่ง อีเมล หรือแสดง in-app เพื่อกระตุ้นให้พวกเขาใช้แอปบ่อยขึ้น

PW_ApplicationOpen

สำหรับแอปมือถือเท่านั้น

อีเวนต์ ApplicationOpen จะถูกกระตุ้น ทุกครั้งที่ผู้ใช้เปิดแอปมือถือของคุณ บนอุปกรณ์ของพวกเขา

แอตทริบิวต์ของอีเวนต์

device_type (integer): รหัสประเภทอุปกรณ์ โปรดดูรายละเอียดที่ registerDevice
application_version (string): เวอร์ชันของแอป

กรณีการใช้งาน

รวบรวมสถิติการรักษาผู้ใช้โดยอิงจากสถิติของอีเวนต์ ApplicationOpen
ดำเนินแคมเปญการส่งข้อความในแอปสำหรับผู้ใช้ที่ใช้งานอยู่ในแอป

PW_ScreenOpen

สำหรับแอปมือถือเท่านั้น

อีเวนต์นี้จะทำงานทุกครั้งที่ผู้ใช้ดู หน้าจอเฉพาะในแอปมือถือของคุณ

แอตทริบิวต์ของอีเวนต์

application_version (string): เวอร์ชันของแอป
device_type (integer): รหัสประเภทอุปกรณ์ โปรดดูรายละเอียดที่ registerDevice
screen_name (string): ชื่อหน้าจอทางเทคนิคที่ได้รับจากแอปของคุณ

กรณีการใช้งาน

ส่งข้อความที่เกี่ยวข้องอย่างสมบูรณ์แบบไปยังผู้ใช้ที่แสดงความสนใจในส่วนเฉพาะของแอปโดยเริ่ม Customer Journeys ด้วยอีเวนต์ PW_ScreenOpen
ประเมินและปรับปรุงประสิทธิภาพของโปรโมชันของคุณ A/B/n test ข้อเสนอของคุณสองเวอร์ชันหรือหลายเวอร์ชัน รอให้อีเวนต์ ScreenOpen เกิดขึ้น แล้วดูว่าเนื้อหาใดมีประสิทธิภาพดีที่สุด
ทำความรู้จักว่าหน้าจอใดในแอปที่มีผู้เข้าชมมากที่สุด กรองสถิติของอีเวนต์ตามชื่อหน้าจอ

PW_ApplicationMinimized

สำหรับแอปมือถือเท่านั้น

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

แอตทริบิวต์ของอีเวนต์

device_type (integer): รหัสประเภทอุปกรณ์ โปรดดูรายละเอียดที่ registerDevice
application_version (string): เวอร์ชันของแอป

กรณีการใช้งาน

ติดตามเวลานั่งเฉลี่ยระหว่างอีเวนต์ ApplicationOpen และ ApplicationMinimized
ส่ง push notifications ในขณะที่แอปทำงานในพื้นหลังเพื่อดึงดูดความสนใจของผู้ใช้และนำพวกเขากลับมาที่แอป

PW_UserIdle

สำหรับแอปมือถือเท่านั้น

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

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

iOS: เพิ่มคีย์ Pushwoosh_IDLE_TIMEOUT_SECONDS (ตัวเลข, ขั้นต่ำ 30) ไปยัง Info.plist ของแอปของคุณ
Android: เพิ่ม meta-data com.pushwoosh.idle_timeout_seconds (จำนวนเต็ม, ขั้นต่ำ 30) ไปยัง AndroidManifest.xml ของคุณ

แอตทริบิวต์ของอีเวนต์

screen_name (string): หน้าจอที่ผู้ใช้ไม่ได้ใช้งาน บน Android จะจัดรูปแบบเป็น ActivityName/FragmentName เมื่อหน้าจอปัจจุบันซ้อนกัน มิฉะนั้นจะเป็นชื่อ activity บน iOS จะจัดรูปแบบเป็น ParentVC/ChildVC เมื่อซ้อนกัน มิฉะนั้นจะเป็นชื่อ view controller
idle_seconds (integer): เวลาที่กำหนดไว้สำหรับการไม่ได้ใช้งานที่ผ่านไป
session_duration (integer): วินาทีนับตั้งแต่แอปถูกนำมาไว้เบื้องหน้าครั้งล่าสุด
device_type (integer): รหัสประเภทอุปกรณ์ โปรดดูรายละเอียดที่ registerDevice
application_version (string): เวอร์ชันของแอป

พฤติกรรม

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

กรณีการใช้งาน

กระตุ้นข้อเสนอ In-App หรือผู้ช่วยในบริบทเมื่อผู้ใช้ค้างอยู่ที่หน้าจอที่มีความตั้งใจสูง (ตะกร้าสินค้า, ราคา, การชำระเงิน) โดยไม่ดำเนินการใดๆ
แสดงคำใบ้หรือบทช่วยสอนเมื่อผู้ใช้หยุดชะงักในขั้นตอนการเริ่มต้นใช้งาน
ระบุตำแหน่งที่ผู้ใช้สูญเสียแรงผลักดันโดยการกรองสถิติของอีเวนต์ที่ไม่ได้ใช้งานตาม screen_name

PW_ApplicationExit

สำหรับแอปมือถือเท่านั้น

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

การตรวจจับเจตนาการออกจะถูกปิดใช้งานโดยค่าเริ่มต้น หากต้องการเปิดใช้งาน ให้ตั้งค่า timeout (10–30 วินาที ค่าที่อยู่นอกช่วงนี้จะถูกจำกัดโดยอัตโนมัติ) ในการกำหนดค่าแพลตฟอร์มของแอปของคุณ:

Android: เพิ่ม meta-data com.pushwoosh.exit_intent_timeout_seconds (จำนวนเต็ม, 10–30) ไปยัง AndroidManifest.xml ของคุณ
iOS: เพิ่มคีย์ Pushwoosh_APPLICATION_EXIT_TIMEOUT_SECONDS (ตัวเลข, 10–30) ไปยัง Info.plist ของแอปของคุณ

แอตทริบิวต์ของอีเวนต์

screen_name (string): หน้าจอสุดท้ายที่ใช้งานอยู่เมื่อผู้ใช้ย้ายแอปไปที่พื้นหลัง
session_duration (integer): วินาทีนับตั้งแต่แอปถูกนำมาไว้เบื้องหน้าครั้งล่าสุด
exit_intent_seconds (integer): เวลาที่ผ่านไปอย่างมีผลก่อนที่อีเวนต์จะทำงาน (10–30 วินาที)
device_type (integer): รหัสประเภทอุปกรณ์ โปรดดูรายละเอียดที่ registerDevice
application_version (string): เวอร์ชันของแอป

พฤติกรรม

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

กรณีการใช้งาน

ดึงดูดผู้ใช้ที่ละทิ้งขั้นตอนการซื้อหรือการลงทะเบียนอีกครั้ง กระตุ้น push notification หรืออีเมลพร้อมการแจ้งเตือนหรือส่วนลด
เริ่ม Customer Journey เพื่อดึงลูกค้ากลับสำหรับผู้ใช้ที่ออกโดยไม่ดำเนินการสำคัญให้เสร็จสิ้น (เช่น ทิ้งตะกร้าสินค้าหรือหยุดกลางคันในการเริ่มต้นใช้งาน)
ระบุหน้าจอที่มีการออกสูงโดยการกรองสถิติของอีเวนต์ตาม screen_name

เว็บ

PW_SiteOpened

สำหรับเว็บเท่านั้น

อีเวนต์ SiteOpened จะทำงานทุกครั้งที่ผู้ใช้เปิดหน้าใดๆ ของเว็บไซต์ของคุณ

แอตทริบิวต์ของอีเวนต์

device_type (integer): รหัสประเภทอุปกรณ์ โปรดดูรายละเอียดที่ registerDevice
title (string): ชื่อของหน้าที่เข้าชม
url (string): URL ของหน้าที่เข้าชม

กรณีการใช้งาน

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

การวิเคราะห์การเข้าชมเว็บไซต์ที่แสดงสถิติการเข้าชมหน้าและรูปแบบพฤติกรรมของผู้ใช้

การค้า

PW_InAppPurchase

สำหรับแอปมือถือเท่านั้น

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

ในการใช้งานอีเวนต์ In-App Purchase:

iOS: เปิดใช้งานอีเวนต์ PW_InAppPurchase ใน Control Panel ของคุณ ตั้งค่าพารามิเตอร์ Pushwoosh_PURCHASE_TRACKING_ENABLED ของ Pushwoosh iOS SDK เป็น yes
Android: เปิดใช้งานอีเวนต์ PW_InAppPurchase ใน Control Panel ของคุณ กำหนดค่าการส่งข้อมูลการซื้อไปยัง Pushwoosh โดยใช้คู่มือนี้

แอตทริบิวต์ของอีเวนต์

productIdentifier (string): ได้รับจาก App Store
quantity (integer): จำนวนไอเท็มที่ซื้อ
transactionDate (string): วันที่ซื้อ
status (string): สถานะการซื้อ

กรณีการใช้งาน

รวบรวมสถิติการซื้อในแอป
ดำเนินโปรโมชันและติดตามความสำเร็จของโปรโมชัน ตั้งค่าอีเวนต์ Wait for Trigger ตามหลังข้อความโปรโมชัน

การกำหนดค่า Customer journey ที่แสดงขั้นตอน Wait for Trigger พร้อมอีเวนต์ In-App Purchase

Push notifications

PW_NotificationSend

สำหรับมือถือและเว็บเท่านั้น

อีเวนต์นี้จะทำงานเมื่อข้อความ Pushwoosh ถูกส่งไปยังอุปกรณ์ของผู้ใช้

แอตทริบิวต์ของอีเวนต์

message_id (string)
message_code (string)
campaign_id (string)

กรณีการใช้งาน

ติดตามว่าข้อความถูกส่งหรือไม่ โดยไม่คำนึงถึงช่องทางที่ใช้
สร้าง Segments ของผู้ใช้ตามจำนวนข้อความที่ส่ง
ดูข้อความทั้งหมดที่ส่งไปยังผู้ใช้ใน Events history และวิเคราะห์พฤติกรรมต่อไปของผู้ใช้

PW_NotificationOpen

สำหรับมือถือและเว็บเท่านั้น

อีเวนต์นี้จะทำงานทุกครั้งที่ผู้ใช้เปิด push notification ที่ส่งด้วย Pushwoosh

กรณีการใช้งาน

กำหนดค่า เวลาที่เหมาะสมที่สุดในการส่ง push
สร้าง Segments ตามประสิทธิภาพของการแจ้งเตือนภายในช่วงเวลาที่กำหนด

อีเมล

PW_EmailSent

สำหรับอีเมลเท่านั้น

อีเวนต์นี้จะทำงานเมื่ออีเมลถูกส่งไปยังผู้ให้บริการอีเมล ตรวจสอบ status_code เพื่อดูผลลัพธ์

แอตทริบิวต์ของอีเวนต์

message_id (string): ID ของข้อความ
message_code (string): ตัวระบุที่ไม่ซ้ำกันของข้อความอีเมลเฉพาะ
status_code (integer): รหัสสถานะการจัดส่งที่ส่งคืนโดยผู้ให้บริการอีเมลสำหรับความพยายามในการส่งครั้งนี้
campaign_id (string): ID ของแคมเปญ รวมอยู่ด้วยเฉพาะเมื่ออีเมลถูกส่งเป็นส่วนหนึ่งของแคมเปญ
campaign_code (string): รหัสที่ไม่ซ้ำกันของแคมเปญ รวมอยู่ด้วยเมื่อการส่งเป็นส่วนหนึ่งของแคมเปญและการค้นหาแคมเปญสำเร็จ campaign_code อาจหายไปแม้ว่าจะมี campaign_id อยู่ก็ตาม

กรณีการใช้งาน

ติดตามผลลัพธ์การส่งโดยใช้ status_code แยกต่างหากจากว่าอีเมลถูกเปิดหรือคลิกในภายหลังหรือไม่
สร้าง Segments ของผู้ใช้ตามจำนวนอีเมลที่ส่ง
ดูอีเมลทั้งหมดที่ส่งไปยังผู้ใช้ใน Events history และวิเคราะห์พฤติกรรมต่อไปของผู้ใช้

PW_EmailOpen

สำหรับอีเมลเท่านั้น

อีเวนต์นี้จะทำงานเมื่อผู้ใช้เปิดอีเมลที่ส่งผ่าน Pushwoosh

แอตทริบิวต์ของอีเวนต์

campaign_code (string): รหัสที่ไม่ซ้ำกันของแคมเปญที่เกี่ยวข้องกับอีเมล
campaign_id (string): ID ของแคมเปญ
message_code (string): ตัวระบุที่ไม่ซ้ำกันของข้อความอีเมลเฉพาะ
message_id (string): ID ของข้อความ
opened_by (string): ใครหรืออะไรที่กระตุ้นการเปิด: user สำหรับการเปิดจริงโดยผู้รับ หรือ ampp สำหรับการเปิดอัตโนมัติที่ถูกกระตุ้นโดย Apple Mail Privacy Protection ที่ดึงพิกเซลติดตามล่วงหน้า

กรณีการใช้งาน

ติดตามการเปิดอีเมลเพื่อระบุผู้ใช้ที่มีส่วนร่วมกับอีเมลของคุณอย่างแข็งขัน ใช้ข้อมูลนี้เพื่อสร้างแคมเปญติดตามผล เช่น การส่งรหัสส่วนลดให้กับผู้ใช้ที่เปิดอีเมลโปรโมชัน
หากผู้ใช้เปิดอีเมลแต่ไม่ดำเนินการตามที่ต้องการ (เช่น การซื้อ) คุณสามารถกระตุ้นอีเมลติดตามผลพร้อมการแจ้งเตือนหรือข้อเสนอส่วนบุคคลได้
วิเคราะห์อัตราการเปิดในแคมเปญต่างๆ เพื่อปรับปรุงหัวเรื่องและกลยุทธ์การกำหนดเวลาอีเมลสำหรับแคมเปญ เช่น การเปิดตัวผลิตภัณฑ์หรือโปรโมชันตามฤดูกาล
สร้าง segment ตาม PW_EmailOpen โดยที่ opened_by เท่ากับ user เพื่อกำหนดเป้าหมายผู้รับที่เปิดอีเมล โดยไม่รวมการเปิดที่ถูกกระตุ้นโดย AMPP

PW_EmailLinkClicked

สำหรับอีเมลเท่านั้น

อีเวนต์นี้จะทำงานทุกครั้งที่ผู้ใช้คลิกลิงก์ในอีเมล

แอตทริบิวต์ของอีเวนต์

message_id (string)
message_code (string)
campaign_id (string)
redirect_link (string)
original_link (string)

กรณีการใช้งาน

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

PW_EmailSubscribed

สำหรับอีเมลเท่านั้น

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

แอตทริบิวต์ของอีเวนต์

message_id (string): ID ของข้อความที่กระตุ้นการสมัครรับข้อมูล (ถ้ามี)
campaign_id (string): ID ของแคมเปญที่เกี่ยวข้อง (ถ้ามี)
message_code (string): ตัวระบุที่ไม่ซ้ำกันของข้อความเฉพาะ (ถ้ามี)
categories (array of strings): ชื่อของหมวดหมู่อีเมลที่ผู้ใช้สมัครรับข้อมูล; ละเว้นหากไม่มี (เช่น การลงทะเบียนที่ไม่มีหมวดหมู่ที่สมัครรับข้อมูลอัตโนมัติ)
resubscribe (boolean): true สำหรับการส่ง preference center หรือลิงก์สมัครรับข้อมูลอีกครั้งใดๆ — รวมถึงการสมัครรับข้อมูลครั้งแรกของผู้ใช้ที่นั่น; ละเว้นสำหรับการสมัครรับข้อมูลอัตโนมัติเมื่อลงทะเบียนอุปกรณ์

กรณีการใช้งาน

ใช้ resubscribe เพื่อแยกการสมัครรับข้อมูลที่ขับเคลื่อนโดย preference center ออกจากการสมัครรับข้อมูลอัตโนมัติเมื่อลงทะเบียน
สร้าง Segments ของผู้ใช้ที่สมัครรับข้อมูลหมวดหมู่เฉพาะ

PW_EmailUnsubscribed

สำหรับอีเมลเท่านั้น

อีเวนต์นี้จะทำงานเมื่อผู้ใช้ยกเลิกการสมัครรับข้อมูลหมวดหมู่อีเมลหนึ่งหมวดหมู่หรือมากกว่า และยังรวมถึงการเลือกไม่รับอีเมลการตลาดทั้งหมด (Unsubscribed Emails tag) — ในกรณีนั้น categories จะถูกละเว้น หากผู้ใช้ยกเลิกการสมัครรับข้อมูลหลายหมวดหมู่พร้อมกัน categories จะแสดงรายการทั้งหมด

แอตทริบิวต์ของอีเวนต์

message_id (string): ID ของข้อความที่ผู้ใช้ยกเลิกการสมัครรับข้อมูล (ถ้ามี)
campaign_id (string): ID ของแคมเปญที่เกี่ยวข้อง (ถ้ามี)
message_code (string): ตัวระบุที่ไม่ซ้ำกันของข้อความเฉพาะ (ถ้ามี)
categories (array of strings): ชื่อของหมวดหมู่อีเมลที่ผู้ใช้ยกเลิกการสมัครรับข้อมูล; ละเว้นเมื่อเลือกไม่รับทั้งหมด

กรณีการใช้งาน

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

ข้อความในแอป

PW_InAppShown

สำหรับแอปมือถือเท่านั้น

อีเวนต์นี้จะทำงานเมื่อข้อความในแอปถูกแสดงให้ผู้ใช้เห็น

แอตทริบิวต์ของอีเวนต์

message_code (string): ตัวระบุที่ไม่ซ้ำกันของข้อความเฉพาะที่เกี่ยวข้องกับ in-app
message_id (integer): ID ของข้อความ
campaign_code (string): รหัสที่ไม่ซ้ำกันของแคมเปญที่เกี่ยวข้องกับ in-app
campaign_id (integer): ID ของแคมเปญที่กระตุ้น in-app
rich_media_code (string): ตัวระบุที่ไม่ซ้ำกันของเนื้อหาสื่อสมบูรณ์ที่แสดงใน in-app
inapp_code (string): รหัสที่ไม่ซ้ำกันที่ระบุข้อความ in-app เฉพาะที่แสดง

กรณีการใช้งาน

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

PW_InAppClicked

สำหรับแอปมือถือเท่านั้น

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

แอตทริบิวต์ของอีเวนต์

message_code (string): ตัวระบุที่ไม่ซ้ำกันของข้อความเฉพาะที่เกี่ยวข้องกับ in-app
message_id (integer): ID ของข้อความ
campaign_code (string): รหัสที่ไม่ซ้ำกันของแคมเปญที่เกี่ยวข้องกับ in-app
campaign_id (integer): ID ของแคมเปญที่กระตุ้น in-app
rich_media_code (string): ตัวระบุที่ไม่ซ้ำกันของเนื้อหาสื่อสมบูรณ์ที่แสดงใน in-app (ถ้ามี)
inapp_code (string): รหัสที่ไม่ซ้ำกันที่ระบุข้อความ in-app เฉพาะที่ถูกคลิก
element_id (string): ตัวระบุขององค์ประกอบเฉพาะภายในข้อความในแอปที่ถูกคลิก (เช่น ปุ่มหรือลิงก์)
link (string): URL หรือ deep link ที่เกี่ยวข้องกับองค์ประกอบที่ถูกคลิก

กรณีการใช้งาน

วิเคราะห์พฤติกรรมการคลิกเพื่อระบุว่าปุ่มหรือลิงก์ใดที่ผู้ใช้โต้ตอบบ่อยที่สุด และปรับปรุงการออกแบบข้อความในแอปในอนาคต ตัวอย่างเช่น ทดสอบ CTA ที่แตกต่างกันในแคมเปญอัปเกรดการสมัครสมาชิก
กระตุ้นการดำเนินการอัตโนมัติตามการคลิกของผู้ใช้ เช่น การเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าผลิตภัณฑ์เฉพาะหรือการส่ง push notification

SMS

PW_SMSSent

สำหรับ SMS เท่านั้น

อีเวนต์นี้จะทำงานเมื่อ SMS ถูกส่งไปยังผู้ให้บริการ SMS ตรวจสอบ status_code เพื่อดูผลลัพธ์

แอตทริบิวต์ของอีเวนต์

message_id (string): ID ของข้อความ
message_code (string): ตัวระบุที่ไม่ซ้ำกันของข้อความ SMS เฉพาะ
status_code (integer): รหัสสถานะการจัดส่งที่ส่งคืนโดยผู้ให้บริการ SMS สำหรับความพยายามในการส่งครั้งนี้ ใช้เพื่อบอกความสำเร็จจากความล้มเหลว
campaign_id (string): ID ของแคมเปญ รวมอยู่ด้วยเฉพาะเมื่อ SMS ถูกส่งเป็นส่วนหนึ่งของแคมเปญ
campaign_code (string): รหัสที่ไม่ซ้ำกันของแคมเปญ รวมอยู่ด้วยเมื่อการส่งเป็นส่วนหนึ่งของแคมเปญและการค้นหาแคมเปญสำเร็จ campaign_code อาจหายไปแม้ว่าจะมี campaign_id อยู่ก็ตาม

กรณีการใช้งาน

ติดตามผลลัพธ์การส่งโดยใช้ status_code โดยไม่คำนึงถึงช่องทางที่ใช้ที่อื่นใน journey เดียวกัน
สร้าง Segments ของผู้ใช้ตามจำนวนข้อความ SMS ที่ส่ง
ดูข้อความ SMS ทั้งหมดที่ส่งไปยังผู้ใช้ใน Events history และวิเคราะห์พฤติกรรมต่อไปของผู้ใช้

PW_WhatsAppSent

สำหรับ WhatsApp เท่านั้น

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

แอตทริบิวต์ของอีเวนต์

message_id (string): ID ของข้อความ
message_code (string): ตัวระบุที่ไม่ซ้ำกันของข้อความ WhatsApp เฉพาะ
status_code (integer): รหัสสถานะการจัดส่งที่ส่งคืนโดยผู้ให้บริการ WhatsApp สำหรับความพยายามในการส่งครั้งนี้ ใช้เพื่อบอกความสำเร็จจากความล้มเหลว
campaign_id (string): ID ของแคมเปญ รวมอยู่ด้วยเฉพาะเมื่อข้อความ WhatsApp ถูกส่งเป็นส่วนหนึ่งของแคมเปญ
campaign_code (string): รหัสที่ไม่ซ้ำกันของแคมเปญ รวมอยู่ด้วยเมื่อการส่งเป็นส่วนหนึ่งของแคมเปญและการค้นหาแคมเปญสำเร็จ campaign_code อาจหายไปแม้ว่าจะมี campaign_id อยู่ก็ตาม

กรณีการใช้งาน

ติดตามผลลัพธ์การส่งโดยใช้ status_code แยกต่างหากจากสถานะการจัดส่งหรือการอ่าน
สร้าง Segments ของผู้ใช้ตามจำนวนข้อความ WhatsApp ที่ส่ง
ดูข้อความ WhatsApp ทั้งหมดที่ส่งไปยังผู้ใช้ใน Events history และวิเคราะห์พฤติกรรมต่อไปของผู้ใช้

PW_WhatsAppReceived

สำหรับ WhatsApp เท่านั้น

อีเวนต์นี้จะทำงานเมื่อข้อความ WhatsApp ถูกรับผ่านระบบ

แอตทริบิวต์ของอีเวนต์

message (string): เนื้อหาของข้อความที่ได้รับ สำหรับข้อความตำแหน่งที่ตั้ง จะมีพิกัดในรูปแบบ "latitude,longitude" (เช่น "55.751244,37.618423")
latitude (number): ละติจูดของตำแหน่งที่แชร์ รวมอยู่ด้วยเฉพาะเมื่อผู้ใช้แชร์ตำแหน่งปัจจุบันของตน
longitude (number): ลองจิจูดของตำแหน่งที่แชร์ รวมอยู่ด้วยเฉพาะเมื่อผู้ใช้แชร์ตำแหน่งปัจจุบันของตน

แอตทริบิวต์เหล่านี้จะรวมอยู่ด้วยเฉพาะเมื่อผู้ให้บริการ WhatsApp ส่งมา ในข้อความแรกของการสนทนา Click-to-WhatsApp:

ctwa_clid (string): ID การคลิกของโฆษณา Click-to-WhatsApp ที่เริ่มการสนทนา ใช้สำหรับการระบุแหล่งที่มาของการแปลง — แต่ละค่าจะไม่ซ้ำกันต่อการคลิก ดังนั้นจึงไม่เป็นประโยชน์สำหรับการแบ่งกลุ่ม
referral_source_id (string): ID ของโฆษณาหรือโพสต์ที่เริ่มการสนทนา เมื่อแหล่งที่มาเป็นโฆษณา นี่คือ ID โฆษณาเดียวกับที่แสดงใน Meta Ads Manager; โพสต์จะไม่แสดงรายการที่นั่น
referral_source_type (string): ประเภทของแหล่งที่มาของการอ้างอิง เช่น โฆษณาหรือโพสต์
referral_source_url (string): URL ของโฆษณาหรือโพสต์ที่เริ่มการสนทนา
referral_headline (string): ข้อความพาดหัวของโฆษณา
referral_body (string): ข้อความเนื้อหาของโฆษณา

กรณีการใช้งาน

ดำเนินการติดตามผลอัตโนมัติเพื่อตอบสนองต่อข้อความ WhatsApp ที่เข้ามา (เช่น การเริ่ม Customer Journey หรือการติดตามอีเวนต์การมีส่วนร่วมของผู้ใช้)
แบ่งกลุ่มผู้ใช้ตามการโต้ตอบข้อความ WhatsApp ของพวกเขาเพื่อเปิดใช้งานการส่งข้อความที่กำหนดเป้าหมายหรือแคมเปญส่วนบุคคล
ใช้แอตทริบิวต์ latitude และ longitude เพื่อกระตุ้น journeys ตามตำแหน่งที่ตั้งเมื่อผู้ใช้แชร์ตำแหน่งของตน
ใช้แอตทริบิวต์ ctwa_clid และ referral_* เพื่อระบุแหล่งที่มาของการสนทนาไปยังโฆษณา Click-to-WhatsApp ที่เฉพาะเจาะจงที่เริ่มการสนทนา
ใช้แท็กอุปกรณ์ WhatsApp Ad Click ID และ WhatsApp Ad Click Date ซึ่งคงอยู่หลังจากการสนทนา เพื่อสร้าง Segments ของผู้ใช้ที่คลิกโฆษณาและแปลงในภายหลัง