การผสานรวมกับ Segment

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

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

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

เมื่อตั้งค่าการผสานรวมแล้ว Segment จะส่งข้อมูลต่อไปนี้ไปยัง Pushwoosh:

• คุณลักษณะของผู้ใช้ (User attributes): ชื่อ, อุปกรณ์, ความชอบ, สถานที่, พฤติกรรม ฯลฯ Pushwoosh จะบันทึกข้อมูลนี้เป็น Tags และค่าของ Tag สำหรับผู้ใช้แต่ละคน
• Events: แต่ละ Segment Event จะถูกโอนไปยัง Pushwoosh และบันทึกเป็น Pushwoosh Event ที่มีชื่อเดียวกัน Pushwoosh จะได้รับข้อมูลเกี่ยวกับว่าผู้ใช้แต่ละคนได้กระตุ้น Event ใดบ้าง

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

1. สร้างแคมเปญที่ตรงเป้าหมายโดยอิงจากข้อมูลพฤติกรรมของผู้ใช้ ใช้ข้อมูล Events จาก Segment เพื่อสร้างเซกเมนต์ผู้ใช้ที่แม่นยำใน Pushwoosh โดยอิงจากพฤติกรรมเฉพาะของผู้ใช้

ตัวอย่างเช่น Segment ส่งข้อมูลเกี่ยวกับ SubscribedToOffers Event ไปยัง Pushwoosh คุณสามารถสร้างเซกเมนต์ผู้ใช้ใน Pushwoosh ที่ประกอบด้วยผู้ใช้ที่สมัครรับข้อเสนอพิเศษ:

จากนั้น คุณสามารถสร้าง Customer Journey ที่น่าสนใจพร้อมข้อความโปรโมชันและส่วนลดสำหรับผู้ใช้ที่สมัครรับข้อเสนอของคุณ:

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

ตัวอย่างเช่น Segment ส่งค่าของคุณลักษณะ searched_product ไปยัง Pushwoosh คุณสามารถสร้างพรีเซ็ตพุชที่เสนอส่วนลดสำหรับสินค้าจากหมวดหมู่ที่ผู้ใช้เคยค้นหาก่อนหน้านี้:

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

ภาพรวมการผสานรวม

ประเภทการผสานรวม

• Destination: ข้อมูลถูกส่งจาก Segment ไปยัง Pushwoosh
• Source: ข้อมูลถูกส่งจาก Pushwoosh ไปยัง Segment

ข้อกำหนดเบื้องต้น

บัญชีแบบชำระเงินทั้งใน Pushwoosh และ Segment

เอนทิตีที่ซิงโครไนซ์

Source

• สถิติพุช (Push Statistics)

Destination

• อุปกรณ์ (Devices)
• Tags

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

การติดตามการแจ้งเตือน (Tracking Notifications)

ส่ง push notifications และติดตามสถานะ รวมถึงว่าส่งและจัดส่งสำเร็จหรือไม่

การวิเคราะห์ Event (Event Analysis)

วิเคราะห์ Event ที่ผู้ใช้กระตุ้น เช่น push notifications หรือการจัดส่งอีเมล และตรวจสอบให้แน่ใจว่า Event เหล่านี้ถูกบันทึกอย่างถูกต้องใน Segment

การจัดการผู้ใช้ (User Management)

ลงทะเบียนและจัดการข้อมูลผู้ใช้ รวมถึงการแท็กผู้ใช้ด้วยคุณลักษณะที่เกี่ยวข้องหรือการลบผู้ใช้เมื่อจำเป็น

การตั้งค่าการผสานรวม

หมายเหตุ

ก่อนที่จะตั้งค่าการผสานรวมกับ Segment ตรวจสอบให้แน่ใจว่าได้ผสานรวม Pushwoosh SDK แล้ว

การกำหนดค่า Destination

1. ในอินเทอร์เฟซของ Segment ไปที่ Connections → Destinations และคลิก Add Destination

2. ค้นหา Pushwoosh และเลือก

3. เลือก Sources ที่คุณต้องการเชื่อมต่อกับ Destination

4. ไปที่การตั้งค่า Destination:

5. ป้อน Pushwoosh API key และ application code ตรวจสอบให้แน่ใจว่าสวิตช์ Enable Destination เปิดอยู่ หลังจากนั้น คลิก Save Changes

ฉันจะหา API key และ application code ได้ที่ไหน

คุณสามารถหา API key ได้ในส่วน Settings → API Access:

ส่วน application code สามารถพบได้ที่มุมบนซ้ายของอินเทอร์เฟซ Pushwoosh ใต้ชื่อโปรเจกต์:

6. ไปที่แท็บ Mappings และตรวจสอบให้แน่ใจว่าตัวเลือก Create or Update User Profile และ Track Events เปิดใช้งานอยู่:

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

หาก Event ไม่มีฟิลด์ device_platform หรือฟิลด์นี้ไม่ถูกต้อง Event ของคุณจะถูกละเว้น นอกจากนี้ หาก Event ไม่มีทั้ง userId หรือ deviceId ก็จะถูกละเว้นเช่นกัน

เพื่อให้แน่ใจว่าการแมปของคุณได้รับการกำหนดค่าอย่างถูกต้อง ให้ไปที่ Pushwoosh as Destination > Settings

จากนั้น เลือกแท็บ Mapping และคลิก Edit Mapping สำหรับเมธอด Track Events

ถัดไป ตรวจสอบให้แน่ใจว่าการแมป Event ของคุณกับ Event ที่ส่งไปยัง Pushwoosh นั้นถูกต้อง และฟิลด์ Device Platform และ External User ID (หรือ Device ID) ถูกจับคู่อย่างเหมาะสม

Event ของคุณอาจแตกต่างจากตัวอย่างที่ให้ไว้ข้างต้น อย่างไรก็ตาม สิ่งสำคัญคือการจับคู่การถ่ายโอนข้อมูลสำหรับแพลตฟอร์มและอุปกรณ์สำหรับ Event ที่ส่งไปยัง Pushwoosh

หากการผสานรวมได้รับการกำหนดค่าอย่างถูกต้อง Pushwoosh จะเริ่มรับ Events และคุณลักษณะของผู้ใช้จาก Segment จากข้อมูลนี้ คุณสามารถสร้าง Customer Journeys ที่ตรงเป้าหมายสูงและ ปรับแต่ง push notifications, in-app messages และอีเมลของคุณได้

การกำหนดค่า Source

1. จากหน้า Sources catalog ของพื้นที่ทำงานของคุณ คลิก Add Source
2. ค้นหา “Pushwoosh” ใน Sources Catalog เลือก Pushwoosh และคลิก Add Source
3. ในหน้าจอถัดไป ตั้งชื่อ Source และกำหนดค่าการตั้งค่าอื่นๆ

หมายเหตุ

ชื่อนี้ใช้เป็นป้ายกำกับในแอป Segment และ Segment จะสร้างชื่อสคีมาที่เกี่ยวข้องในคลังข้อมูลของคุณ ชื่อนี้สามารถเป็นอะไรก็ได้ แต่ Pushwoosh แนะนำให้ใช้ชื่อที่สะท้อนถึง source เองและแยกความแตกต่างระหว่างสภาพแวดล้อมของคุณ (ตัวอย่างเช่น: Pushwoosh_Prod, Pushwoosh_Staging, Pushwoosh_Dev)

4. คลิก Add Source เพื่อบันทึกการตั้งค่าของคุณ
5. คัดลอก Write key จาก UI ของ Segment
6. เข้าสู่ระบบบัญชี Pushwoosh ของคุณ และเลือกแอปพลิเคชันที่คุณต้องการเชื่อมต่อ
7. ไปที่ Settings > 3rd party integration > Segment คลิกปุ่ม Configure และป้อน Write key ของคุณจากพื้นที่ทำงานของ Segment
8. ระบุรายการ Event ที่คุณต้องการส่งออกโดยใช้ตัวคั่น , ในฟิลด์ Events หรือเว้นว่างไว้หากคุณต้องการส่งออก Event ทั้งหมด จากนั้นคลิก Apply

Stream

Pushwoosh ใช้คอมโพเนนต์ Segment stream Source เพื่อส่งข้อมูล Event ของ Segment โดยใช้วิธีการ track ฝั่งเซิร์ฟเวอร์เพื่อส่งข้อมูลไปยัง Segment จากนั้น Event เหล่านี้จะพร้อมใช้งานใน destination ใดๆ ที่ยอมรับ Event ฝั่งเซิร์ฟเวอร์ และพร้อมใช้งานในสคีมาในคลังข้อมูลของคุณ

โดยค่าเริ่มต้น Pushwoosh จะส่ง Pushwoosh User ID เป็นคุณสมบัติ Segment userId หากไม่มี User ID ที่เกี่ยวข้อง Pushwoosh จะส่ง HWID เป็น Segment anonymousId

Events

ตารางด้านล่างแสดงรายการ Event ที่ Pushwoosh ส่งไปยัง Segment Event เหล่านี้จะปรากฏเป็นตารางในคลังข้อมูลของคุณ และเป็น Event ปกติใน Destinations อื่นๆ

ชื่อ Event	คำอธิบาย
Email Sent	อีเมลถูกส่งสำเร็จ
Push Sent	Push notification ส่งสำเร็จ
SMS Sent	SMS ส่งถึงผู้รับ
Push Opened	Push notification ถูกเปิด
Email Opened	การแจ้งเตือนทางอีเมลถูกเปิด
Email Delivered	อีเมลจัดส่งสำเร็จ
Push Delivered	Push notification จัดส่งสำเร็จ
SMS Delivered	SMS จัดส่งสำเร็จ
SMS Not Delivered	การจัดส่ง SMS ล้มเหลว
Email Bounced	อีเมลตีกลับไปยังผู้ส่งเนื่องจากข้อผิดพลาดถาวร
Email Unsubscribed	คลิกที่ลิงก์ยกเลิกการสมัครรับอีเมล

คุณสมบัติของ Event (Event Properties)

ตารางด้านล่างแสดงรายการคุณสมบัติที่รวมอยู่ใน Event ที่ระบุไว้ข้างต้น

ชื่อคุณสมบัติ	คำอธิบาย
message_type	ประกอบด้วยประเภทของข้อความ (Push, Email, In-App หรือ SMS)
campaign_code	ตัวระบุที่ไม่ซ้ำกันของแคมเปญข้อความ
device_type	ประเภทของอุปกรณ์

การเพิ่ม Destinations

ตอนนี้ Source ของคุณได้รับการตั้งค่าแล้ว คุณสามารถเชื่อมต่อกับ Destinations ได้

เข้าสู่ระบบเครื่องมือดาวน์สตรีมของคุณและตรวจสอบว่า Event ของคุณปรากฏตามที่คาดไว้และมีคุณสมบัติทั้งหมดที่คุณคาดหวัง หาก Event และคุณสมบัติของคุณไม่ปรากฏขึ้น ให้ตรวจสอบ Event Delivery และอ้างอิงเอกสาร Destination สำหรับแต่ละเครื่องมือเพื่อแก้ไขปัญหา

หากมีปัญหาใดๆ เกี่ยวกับวิธีการที่ Event มาถึง Segment โปรดติดต่อทีมสนับสนุนของเรา

การผสานรวมทำงานอย่างไร

1. การเริ่มต้น push notification: ไคลเอ็นต์เริ่มกระบวนการโดยการเริ่มต้น push notification ผ่านอินเทอร์เฟซของ Pushwoosh
2. การสร้าง Event: แบ็กเอนด์ของ Pushwoosh ประมวลผลคำขอ push notification และสร้าง Event จากนั้น Event นี้จะถูกส่งไปยังหัวข้อ Kafka ที่ชื่อว่า channels-tracking-log ซึ่งจัดการโดย Pushwoosh
3. การบริโภค Event: บริการ Segment Integration จะคอยฟังหัวข้อ Kafka channels-tracking-log อย่างต่อเนื่องและบริโภค Event เมื่อมาถึง
4. การประมวลผล Event: Event ที่บริโภคจะถูกประมวลผลโดยบริการ Segment Integration ซึ่งจะแปลงเป็น Segment Track Events
5. การส่ง Event: Segment Track Events ที่ประมวลผลแล้วจะถูกส่งไปยังแบ็กเอนด์ของ Segment เพื่อการจัดการและวิเคราะห์ต่อไป

คุณจะรู้ได้อย่างไรว่าการผสานรวมทำงานอยู่?

Destination

track-user

ไปที่ บัญชี Pushwoosh ของคุณ > แอปพลิเคชันที่เชื่อมต่อของคุณ > Audience > User Explorer ค้นหาผู้ใช้/อุปกรณ์ของคุณและตรวจสอบแท็กที่ Segment ส่งมา

post-event

ไปที่ บัญชี Pushwoosh ของคุณ > แอปพลิเคชันที่เชื่อมต่อของคุณ > Audience > Events เลือก Event คลิกเมนูสามจุด และเลือก Event Statistics ตรวจสอบให้แน่ใจว่า Event ถูกนับ

delete-user

ไปที่ บัญชี PW ของคุณ > แอปพลิเคชันที่เชื่อมต่อของคุณ > Audience > User Explorer ตรวจสอบให้แน่ใจว่าผู้ใช้/อุปกรณ์ไม่มีอยู่

Source

ใช้ Source debugger เพื่อตรวจจับ Event ที่ถูกส่งจาก Pushwoosh ไปยัง Segment

การแก้ไขปัญหา

ตรวจสอบสถานะการผสานรวม

ในการแก้ไขปัญหาเกี่ยวกับการผสานรวม Pushwoosh ให้เริ่มโดยการตรวจสอบสิ่งต่อไปนี้:

Destination

• Track-User: ตรวจสอบข้อมูลผู้ใช้/อุปกรณ์และแท็กใน Pushwoosh ใต้ Audience > User Explorer
• Post-Event: ตรวจสอบให้แน่ใจว่า Event ถูกนับใน Pushwoosh โดยการตรวจสอบสถิติ Event
• Delete-User: ยืนยันว่าผู้ใช้/อุปกรณ์ไม่มีอยู่อีกต่อไปใน Pushwoosh

Source

ใช้ source debugger ที่ Segment Debugger เพื่อตรวจสอบว่า Event จาก Pushwoosh ถูกส่งไปยัง Segment อย่างถูกต้องหรือไม่

Event ไม่ตรงกัน

หาก Event ไม่ปรากฏอย่างถูกต้องใน Segment ตรวจสอบให้แน่ใจว่า Pushwoosh events ถูกแมปกับ Segment Track Events อย่างถูกต้องตามกฎการแมปที่ให้ไว้

ปัญหาการยืนยันตัวตน

ตรวจสอบว่าใช้โทเค็นการยืนยันตัวตนหรือ API keys ที่ถูกต้องในคำขอไปยัง Pushwoosh และ Segment

ปัญหาการไหลของข้อมูล

ยืนยันว่าการไหลของข้อมูลระหว่าง Pushwoosh และ Segment ไม่ถูกขัดจังหวะและหัวข้อ Kafka กำลังถูกตรวจสอบอย่างถูกต้อง

คำถามที่พบบ่อย

Event ประเภทใดบ้างที่ถูกส่งไปยัง Segment จาก Pushwoosh?

Reserved events เช่น Push Sent, Email Sent, SMS Sent, Push Delivered, Email Delivered, SMS Delivered, และ Email Bounced จะถูกส่งไปยัง Segment

ฉันจะตรวจสอบได้อย่างไรว่า Event ถูกส่งไปยัง Segment อย่างถูกต้อง?

ใช้ Segment source debugger เพื่อตรวจสอบ Event ที่ส่งจาก Pushwoosh และตรวจสอบสถิติ Event ในบัญชี Pushwoosh ของคุณเพื่อให้แน่ใจว่าถูกนับอย่างถูกต้อง

ฉันควรทำอย่างไรหากพบปัญหากับการผสานรวม?

ตรวจสอบสถานะการผสานรวมโดยการตรวจสอบข้อมูลผู้ใช้/อุปกรณ์, จำนวน Event, และการลบผู้ใช้ใน Pushwoosh นอกจากนี้ ตรวจสอบให้แน่ใจว่าใช้โทเค็นการยืนยันตัวตนที่ถูกต้องและว่าการไหลของข้อมูลไม่ถูกขัดจังหวะ

ข้อมูลผู้ใช้และอุปกรณ์ถูกจัดการในการผสานรวมอย่างไร?

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

ฉันจะหาเอกสารโดยละเอียดสำหรับการผสานรวมได้ที่ไหน?

เอกสารโดยละเอียดมีอยู่ในคู่มือการผสานรวมของ Segment และ Pushwoosh รวมถึงในเอกสาร API ของแต่ละแห่ง