Event เริ่มต้น

หมายเหตุ

ใช้งานได้ตั้งแต่ SDK 5.2.2

Event เริ่มต้นคืออะไร

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

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

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

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

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

เคล็ดลับ

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

วิดีโอ Youtube: วิธีใช้ Event เริ่มต้นเพื่อสร้างแคมเปญการตลาดใน Pushwoosh และเปลี่ยนผู้ใช้ฟรีเป็นลูกค้าที่ชำระเงินโดยอัตโนมัติ

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

PW_DeviceRegistered

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

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

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

PW_DeviceUnregistered

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

แอตทริบิวต์ของ Event

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

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

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

PW_ApplicationOpen

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

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

แอตทริบิวต์ของ Event

• device_type (integer): รหัสประเภทอุปกรณ์ อ้างอิงถึง registerDevice สำหรับรายละเอียด
• application_version (string): เวอร์ชันของแอป

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

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

PW_ScreenOpen

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

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

แอตทริบิวต์ของ Event

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

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

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

PW_ApplicationMinimized

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

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

แอตทริบิวต์ของ Event

• device_type (integer): รหัสประเภทอุปกรณ์ อ้างอิงถึง registerDevice สำหรับรายละเอียด
• application_version (string): เวอร์ชันของแอป

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

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

PW_UserIdle

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

ต้องการความช่วยเหลือจากนักพัฒนา

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

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

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

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

แอตทริบิวต์ของ Event

• 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 หรือผู้ช่วยในบริบทเมื่อผู้ใช้ค้างอยู่ที่หน้าจอที่มีความตั้งใจสูง (ตะกร้าสินค้า, ราคา, การชำระเงิน) โดยไม่ดำเนินการใดๆ
• แสดงคำใบ้หรือบทช่วยสอนเมื่อผู้ใช้หยุดชะงักในขั้นตอนการเริ่มต้นใช้งาน
• ระบุตำแหน่งที่ผู้ใช้สูญเสียแรงผลักดันโดยการกรองสถิติ event ที่ไม่ได้ใช้งานตาม screen_name

PW_ApplicationExit

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

ต้องการความช่วยเหลือจากนักพัฒนา

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

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

การตรวจจับเจตนาการออกถูกปิดใช้งานโดยค่าเริ่มต้น หากต้องการเปิดใช้งาน ให้ตั้งค่าการหมดเวลา (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 ของแอปของคุณ

แอตทริบิวต์ของ Event

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

พฤติกรรม

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

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

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

เว็บ

PW_SiteOpened

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

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

แอตทริบิวต์ของ Event

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

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

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

การค้า

PW_InAppPurchase

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

ต้องการความช่วยเหลือจากนักพัฒนา

ในการตั้งค่า In-App Purchase event คุณจะต้องได้รับความช่วยเหลือจากทีมนักพัฒนาของคุณ แบ่งปันคู่มือนี้กับพวกเขา

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

หมายเหตุ

โปรดทราบว่ารายการเหล่านี้ต้องระบุไว้ในหน้า App Store ของแอปของคุณ

ในการใช้งาน In-App Purchase event:

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

แอตทริบิวต์ของ Event

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

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

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

เคล็ดลับ

คุณสามารถแมป PW_InAppPurchase เป็นแหล่งรายได้สำหรับ Conversion events โดยไม่ต้องเพิ่มโค้ดใหม่ เพื่อใช้รายได้ใน RFM segmentation, การระบุแหล่งที่มาของ journey และ ManyMoney AI

Push notifications

PW_NotificationSend

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

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

แอตทริบิวต์ของ Event

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

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

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

PW_NotificationOpen

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

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

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

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

อีเมล

PW_EmailSent

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

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

แอตทริบิวต์ของ Event

• 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

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

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

แอตทริบิวต์ของ Event

• 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

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

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

แอตทริบิวต์ของ Event

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

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

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

PW_EmailSubscribed

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

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

แอตทริบิวต์ของ Event

• 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

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

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

แอตทริบิวต์ของ Event

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

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

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

เคล็ดลับ

ในตัวสร้าง segment เมนูแบบเลื่อนลงของแอตทริบิวต์ categories สำหรับ PW_EmailSubscribed และ PW_EmailUnsubscribed จะแสดงรายการหมวดหมู่อีเมลจริงของบัญชีของคุณแทนค่าที่บันทึกไว้ดิบ — ดู segment by category (ต้องเปิดใช้งาน preference center)

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

PW_InAppShown

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

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

แอตทริบิวต์ของ Event

• 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

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

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

แอตทริบิวต์ของ Event

• 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 เท่านั้น

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

แอตทริบิวต์ของ Event

• 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 และวิเคราะห์พฤติกรรมต่อไปของผู้ใช้

WhatsApp

PW_WhatsAppSent

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

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

แอตทริบิวต์ของ Event

• 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 เท่านั้น

event นี้จะทำงานเมื่อข้อความ WhatsApp ได้รับผ่านระบบ

แอตทริบิวต์ของ Event

• 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 หรือการติดตาม event การมีส่วนร่วมของผู้ใช้)
• แบ่งส่วนผู้ใช้ตามการโต้ตอบข้อความ WhatsApp ของพวกเขาเพื่อเปิดใช้งานการส่งข้อความที่กำหนดเป้าหมายหรือแคมเปญส่วนบุคคล
• ใช้แอตทริบิวต์ latitude และ longitude เพื่อกระตุ้น journeys ตามตำแหน่งที่ตั้งเมื่อผู้ใช้แชร์ตำแหน่งของตน
• ใช้แอตทริบิวต์ ctwa_clid และ referral_* เพื่อระบุแหล่งที่มาของการสนทนาไปยังโฆษณา Click-to-WhatsApp เฉพาะที่เริ่มการสนทนา