การผสานรวมกับ RudderStack
RudderStack เป็นแพลตฟอร์มข้อมูลลูกค้าที่รวบรวม event จากแอป เว็บไซต์ เซิร์ฟเวอร์ และคลังข้อมูลของคุณ แล้วส่งต่อไปยังเครื่องมืออื่น เมื่อใช้ Pushwoosh destination ใน RudderStack ข้อมูลที่คุณรวบรวมไว้ที่นั่นอยู่แล้วจะส่งถึง Pushwoosh โดยไม่ต้องเพิ่มโค้ดในแอปของคุณ:
- Track event จะกลายเป็น event ใน Pushwoosh ใช้ event เหล่านี้เพื่อสร้างเซกเมนต์ และเพื่อเริ่มหรือแตกแขนง Customer Journey
- Identify trait จะกลายเป็น tag เฉพาะผู้ใช้ (user-specific) ใช้ tag เหล่านี้เพื่อกำหนดเป้าหมายและปรับแต่ง push notification, in-app message และอีเมลให้เป็นแบบเฉพาะบุคคล
ก่อนเริ่มต้น
Anchor link todestination จับคู่ข้อมูลทั้งหมดด้วย User ID ดังนั้นให้ตรวจสอบข้อกำหนดเบื้องต้นเหล่านี้ก่อน:
- Pushwoosh SDK ถูกผสานรวมในแอปของคุณแล้ว
- แอปของคุณเรียก
setUserIdด้วยค่าเดียวกับที่ RudderStack ส่งเป็นuserIdPushwoosh เชื่อมโยง event และ trait ที่เข้ามากับผู้ใช้ด้วยค่านี้ - อุปกรณ์ของผู้ใช้แต่ละรายลงทะเบียนด้วย User ID นี้แล้วก่อนที่ RudderStack จะส่งการเรียก
identifyสำหรับผู้ใช้รายนั้น trait ของ User ID ที่ Pushwoosh ยังไม่รู้จักจะถูกทิ้ง - คุณมีสิทธิ์เข้าถึง Settings → API Access ใน Pushwoosh เพื่อสร้าง API token
- คุณมี workspace ของ RudderStack ที่มีอย่างน้อยหนึ่งแหล่งข้อมูล (source) ที่ส่งการเรียก
trackหรือidentify
ตั้งค่า Pushwoosh destination ใน RudderStack
Anchor link toการตั้งค่ามีสองส่วน: คุณรับค่าสองค่าใน Pushwoosh จากนั้นสร้าง destination ใน RudderStack
รับ application code และ Device API token
Anchor link toRudderStack ต้องใช้ค่าสองค่าเพื่อส่งข้อมูลไปยังแอปพลิเคชันของคุณ: application code และ Device API token
- ใน Pushwoosh ให้เปิดแอปพลิเคชันที่คุณต้องการส่งข้อมูลไป
- คัดลอก application code ซึ่งจะแสดงอยู่ใต้ชื่อแอปพลิเคชันที่มุมซ้ายบน และมีรูปแบบเป็น
XXXXX-XXXXX - ไปที่ Settings → API Access แล้วคลิก Generate New Token
- ใน Token type ให้เลือก
device - ใน Name ให้ป้อนชื่อของ token เช่น
RudderStack - คลิก Generate
- ในรายการ token ให้คลิกเมนูสามจุดข้าง token ใหม่ แล้วเลือก Edit token…
- ใน Applications ให้เลือกแอปพลิเคชันจากขั้นตอนที่ 1 แล้วคลิก Save
- คัดลอกค่า token จากรายการ token
Device API token เพียงพอสำหรับ destination คุณไม่จำเป็นต้องใช้ Server API token
เพิ่ม destination ใน RudderStack
Anchor link toPushwoosh destination เชื่อมต่อแหล่งข้อมูลใน RudderStack ของคุณเข้ากับแอปพลิเคชัน Pushwoosh ของคุณ
- ในแดชบอร์ด RudderStack ให้ไปที่ Collect → Destinations
- คลิก New destination
- เลือก Pushwoosh จากรายการ
- ป้อนชื่อของ destination แล้วคลิก Continue
- เลือกแหล่งข้อมูลที่คุณต้องการส่งไปยัง Pushwoosh
- ใน Application Code ให้วาง application code
- ใน API Token ให้วาง Device API token
- ตั้งค่าให้เสร็จเพื่อบันทึก destination
RudderStack ส่งข้อมูลไปยัง Pushwoosh จากเซิร์ฟเวอร์ของตัวเอง (cloud mode) สำหรับแหล่งข้อมูลทุกประเภทที่ destination รองรับ
สำหรับการตั้งค่าฝั่ง RudderStack โปรดดู คู่มือ Pushwoosh destination ในเอกสารของ RudderStack
ข้อมูลที่ RudderStack ส่งไปยัง Pushwoosh
Anchor link todestination รองรับการเรียกสองประเภท คือ track และ identify RudderStack จะปฏิเสธการเรียกประเภทอื่นทั้งหมดสำหรับ destination นี้ เช่น page, screen, group หรือ alias
การเรียกทุกครั้งต้องมี userId RudderStack จะไม่ส่งการเรียกที่ไม่มีค่านี้ เนื่องจาก Pushwoosh ไม่สามารถระบุการเรียกแบบไม่ระบุตัวตนว่าเป็นของผู้ใช้รายใดได้
การเรียก track จะกลายเป็น event ใน Pushwoosh
Anchor link toการเรียก track แต่ละครั้งจะกลายเป็น event ใน Pushwoosh ที่มีชื่อเดียวกับ event ใน RudderStack:
| ฟิลด์ RudderStack | Pushwoosh |
|---|---|
event | ชื่อ event |
properties | attribute ของ event |
userId | User ID |
timestamp (หรือ originalTimestamp) | เวลาของ event |
context.device.id | Device ID หากมี |
context.device.type หรือ context.os.name | แพลตฟอร์ม: android; ios สำหรับ iOS, iPadOS, watchOS และ tvOS; web สำหรับค่าอื่นใดหรือเมื่อไม่มีค่า |
หาก event หรือ attribute ยังไม่มีอยู่ในแอปพลิเคชัน Pushwoosh จะสร้างให้โดยอัตโนมัติ
Pushwoosh จะทิ้ง event ทั้งหมดในกรณีต่อไปนี้ โดยไม่ส่งข้อผิดพลาดกลับ ดังนั้น RudderStack จะรายงานว่า event ถูกส่งแล้ว:
- การเรียกมี property มากกว่า 100 รายการ
- ค่าของ property ยาวเกิน 10 KB
- ชื่อ event ยาวเกิน 255 อักขระ
- event เป็น event ใหม่ และชื่อยาวเกิน 128 อักขระหรือมีอักขระควบคุม
event หนึ่งรายการเก็บ attribute ได้สูงสุด 100 รายการ เมื่อ event มี attribute ที่รู้จักครบ 100 รายการแล้ว Pushwoosh จะยังคงบันทึกการเรียกใหม่ แต่ชื่อ property ใหม่จะไม่ถูกเพิ่มเป็น attribute
ออบเจ็กต์ที่ซ้อนกันใน properties จะมาถึงเป็นสตริง JSON และ property ที่มีค่า null จะถูกทิ้ง
การเรียก identify จะกลายเป็น tag เฉพาะผู้ใช้
Anchor link toการเรียก identify แต่ละครั้งจะตั้งค่า trait ของตนเป็น tag ของผู้ใช้ที่มี userId ที่ระบุ trait มาจาก traits หรือจาก context.traits เมื่อ traits ว่างเปล่า
- จะเขียนเฉพาะ tag เฉพาะผู้ใช้เท่านั้น หากเปิดใช้การสร้าง tag อัตโนมัติสำหรับบัญชีของคุณ trait ที่มีชื่อใหม่จะสร้าง tag เฉพาะผู้ใช้ หากมี tag แบบ General ที่มีชื่อเดียวกันอยู่แล้ว Pushwoosh จะข้าม trait นั้นโดยไม่มีข้อผิดพลาด
- ค่าต้องตรงกับประเภทของ tag หากมี tag อยู่แล้วและค่าของ trait ไม่ตรงกับประเภทของ tag เช่น ข้อความสำหรับ tag ประเภท Integer Pushwoosh จะข้าม trait นั้นโดยไม่มีข้อผิดพลาด
- ผู้ใช้ต้องมีอยู่ใน Pushwoosh แล้ว tag จะถูกนำไปใช้ก็ต่อเมื่อ Pushwoosh SDK ลงทะเบียนอุปกรณ์ที่ตั้งค่า
setUserIdเป็นuserIdเดียวกันแล้วเท่านั้น trait ของผู้ใช้ที่ไม่รู้จักจะถูกทิ้งโดยไม่มีข้อผิดพลาด - trait ด้านตัวตนและการติดต่อจะไม่ถูกคัดลอกไปเป็น tag
email,phone,firstName,lastName,name,address,id,userIdและanonymousIdจะไม่ถูกส่งเป็น tag การเรียกidentifyที่มีเพียง trait เหล่านี้จะล้มเหลวพร้อมNo traits left to send as Pushwoosh tags - ค่าว่างจะล้าง tag trait ที่มีสตริงว่างหรือรายการว่างจะลบค่าปัจจุบันของ tag นั้นสำหรับผู้ใช้
- ออบเจ็กต์ที่ซ้อนกันจะมาถึงเป็นสตริง JSON trait ที่มีค่า
nullจะถูกทิ้ง
สิ่งที่ destination ไม่ได้ทำ
Anchor link todestination ส่งเฉพาะข้อมูล track และ identify งานต่อไปนี้อยู่นอกขอบเขตของ destination:
- ไม่ลงทะเบียนอุปกรณ์หรือที่อยู่อีเมล อุปกรณ์มาจาก Pushwoosh SDK
- ไม่ลบผู้ใช้ destination นี้ไม่รองรับคำขอลบผู้ใช้จาก RudderStack
ตรวจสอบว่าการผสานรวมทำงาน
Anchor link toหลังจากบันทึก destination แล้ว ให้ส่งการเรียก track และ identify เพื่อทดสอบจากแหล่งข้อมูลที่มี userId ซึ่งมีอุปกรณ์อยู่ใน Pushwoosh แล้ว
- Event: ใน Pushwoosh ให้ไปที่ Audience → Events เปิด event แล้วตรวจสอบว่ามีการนับแล้ว
- Tag: ไปที่ Audience → User Explorer ค้นหาผู้ใช้ด้วย User ID แล้วตรวจสอบค่า tag
ข้อผิดพลาดในการส่งของการเรียกแต่ละครั้งจะแสดงในมุมมอง Live Events ของ destination ใน RudderStack
การแก้ไขปัญหา
Anchor link toค้นหาข้อความแสดงข้อผิดพลาดที่ RudderStack แสดงสำหรับ destination ใน Live Events เพื่อดูสาเหตุและวิธีแก้ไข
การเรียก track ล้มเหลวพร้อม unauthorized
Anchor link toAPI token ไม่ตรงกับ application code ตรวจสอบว่า token เป็นของบัญชี Pushwoosh เดียวกันกับแอปพลิเคชัน
การเรียก identify ไม่ตรวจสอบ token จึงยังคงสำเร็จแม้ใช้ token ที่ไม่ถูกต้อง ใช้การเรียก track เพื่อทดสอบ token
การเรียกล้มเหลวพร้อม application not found หรือ application code is not valid
Anchor link toapplication code ไม่ถูกต้อง หรือบัญชีไม่ได้โฮสต์บน app.pushwoosh.com การเรียก track จะล้มเหลวพร้อม application not found และการเรียก identify จะล้มเหลวพร้อม application code is not valid ตรวจสอบ code ใน Pushwoosh Control Panel หาก code ถูกต้อง โปรดติดต่อ Customer Success Manager ของคุณหรือฝ่ายสนับสนุน
การเรียกล้มเหลวพร้อม Missing required value from userId
Anchor link toการเรียกไม่มี userId การเรียกแบบไม่ระบุตัวตนจะไม่ถูกส่งไปยัง Pushwoosh เรียก identify ในแหล่งข้อมูล RudderStack ของคุณหลังจากผู้ใช้ลงชื่อเข้าใช้ เพื่อให้การเรียกครั้งต่อไปมี userId
การเรียกล้มเหลวพร้อม Invalid enum value
Anchor link toประเภทการเรียกไม่ใช่ track หรือ identify Pushwoosh รับเฉพาะสองประเภทนี้ ให้เลือกระหว่างไม่เชื่อมต่อแหล่งข้อมูลที่ส่งเฉพาะการเรียก page, screen, group หรือ alias หรือเพิกเฉยต่อข้อผิดพลาดเหล่านี้
การเรียก identify ล้มเหลวพร้อม No traits left to send as Pushwoosh tags
Anchor link totrait ทั้งหมดในการเรียกเป็น trait ด้านตัวตนหรือการติดต่อ เช่น email หรือ phone ซึ่งจะไม่ถูกคัดลอกไปเป็น tag เพิ่ม trait อื่นอย่างน้อยหนึ่งรายการ หรือข้ามการเรียกนั้น
การเรียก identify สำเร็จแต่ tag ไม่ปรากฏ
Anchor link toตรวจสอบรายการต่อไปนี้ตามลำดับ:
- มีอุปกรณ์ที่มี User ID นี้ลงทะเบียนอยู่ใน Pushwoosh ค้นหาผู้ใช้ใน Audience → User Explorer
- แอปเรียก
setUserIdด้วยค่าเดียวกันทุกประการกับที่ RudderStack ส่งเป็นuserId - tag ที่มีชื่อนี้เป็นแบบ User-specific trait สำหรับ tag แบบ General ที่มีอยู่จะถูกข้าม ให้เปลี่ยนขอบเขตของ tag หรือเปลี่ยนชื่อ trait
- ค่าของ trait ตรงกับประเภทของ tag ที่มีอยู่
- trait ไม่ใช่ trait ด้านตัวตนหรือการติดต่อที่ไม่ถูกคัดลอก เช่น
emailหรือphone