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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Source

• สถิติพุช

Destination

• อุปกรณ์
• Tags

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

Tracking Notifications

ส่งการแจ้งเตือนแบบพุชและติดตามสถานะ รวมถึงว่าส่งและจัดส่งสำเร็จหรือไม่

Event Analysis

วิเคราะห์อีเวนต์ที่ผู้ใช้กระตุ้น เช่น การแจ้งเตือนแบบพุชหรือการส่งอีเมล และตรวจสอบให้แน่ใจว่าอีเวนต์เหล่านี้ถูกบันทึกใน 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 เปิดใช้งานอยู่:

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

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

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

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

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

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

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

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

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

หมายเหตุ

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

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

Stream

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

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

Events

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

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

Event Properties

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

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

Adding Destinations

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

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

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

การทำงานของการผสานรวม

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

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

Destination

track-user

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

post-event

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

delete-user

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

Source

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

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

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

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

Destination

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

Source

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

อีเวนต์ไม่ตรงกัน

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

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

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

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

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

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

อีเวนต์ประเภทใดบ้างที่ส่งจาก Pushwoosh ไปยัง Segment

อีเวนต์ที่สงวนไว้ เช่น Push Sent, Email Sent, SMS Sent, Push Delivered, Email Delivered, SMS Delivered, และ Email Bounced จะถูกส่งไปยัง Segment

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

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

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

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

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

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

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

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