ข้ามไปยังเนื้อหา

การผสานรวมกับ 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 to

destination จับคู่ข้อมูลทั้งหมดด้วย User ID ดังนั้นให้ตรวจสอบข้อกำหนดเบื้องต้นเหล่านี้ก่อน:

  • Pushwoosh SDK ถูกผสานรวมในแอปของคุณแล้ว
  • แอปของคุณเรียก setUserId ด้วยค่าเดียวกับที่ RudderStack ส่งเป็น userId Pushwoosh เชื่อมโยง 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 to

RudderStack ต้องใช้ค่าสองค่าเพื่อส่งข้อมูลไปยังแอปพลิเคชันของคุณ: application code และ Device API token

  1. ใน Pushwoosh ให้เปิดแอปพลิเคชันที่คุณต้องการส่งข้อมูลไป
  2. คัดลอก application code ซึ่งจะแสดงอยู่ใต้ชื่อแอปพลิเคชันที่มุมซ้ายบน และมีรูปแบบเป็น XXXXX-XXXXX
  3. ไปที่ Settings → API Access แล้วคลิก Generate New Token
  4. ใน Token type ให้เลือก device
  5. ใน Name ให้ป้อนชื่อของ token เช่น RudderStack
  6. คลิก Generate
  7. ในรายการ token ให้คลิกเมนูสามจุดข้าง token ใหม่ แล้วเลือก Edit token…
  8. ใน Applications ให้เลือกแอปพลิเคชันจากขั้นตอนที่ 1 แล้วคลิก Save
  9. คัดลอกค่า token จากรายการ token

Device API token เพียงพอสำหรับ destination คุณไม่จำเป็นต้องใช้ Server API token

เพิ่ม destination ใน RudderStack

Anchor link to

Pushwoosh destination เชื่อมต่อแหล่งข้อมูลใน RudderStack ของคุณเข้ากับแอปพลิเคชัน Pushwoosh ของคุณ

  1. ในแดชบอร์ด RudderStack ให้ไปที่ Collect → Destinations
  2. คลิก New destination
  3. เลือก Pushwoosh จากรายการ
  4. ป้อนชื่อของ destination แล้วคลิก Continue
  5. เลือกแหล่งข้อมูลที่คุณต้องการส่งไปยัง Pushwoosh
  6. ใน Application Code ให้วาง application code
  7. ใน API Token ให้วาง Device API token
  8. ตั้งค่าให้เสร็จเพื่อบันทึก destination

RudderStack ส่งข้อมูลไปยัง Pushwoosh จากเซิร์ฟเวอร์ของตัวเอง (cloud mode) สำหรับแหล่งข้อมูลทุกประเภทที่ destination รองรับ

สำหรับการตั้งค่าฝั่ง RudderStack โปรดดู คู่มือ Pushwoosh destination ในเอกสารของ RudderStack

ข้อมูลที่ RudderStack ส่งไปยัง Pushwoosh

Anchor link to

destination รองรับการเรียกสองประเภท คือ track และ identify RudderStack จะปฏิเสธการเรียกประเภทอื่นทั้งหมดสำหรับ destination นี้ เช่น page, screen, group หรือ alias

การเรียกทุกครั้งต้องมี userId RudderStack จะไม่ส่งการเรียกที่ไม่มีค่านี้ เนื่องจาก Pushwoosh ไม่สามารถระบุการเรียกแบบไม่ระบุตัวตนว่าเป็นของผู้ใช้รายใดได้

การเรียก track จะกลายเป็น event ใน Pushwoosh

Anchor link to

การเรียก track แต่ละครั้งจะกลายเป็น event ใน Pushwoosh ที่มีชื่อเดียวกับ event ใน RudderStack:

ฟิลด์ RudderStackPushwoosh
eventชื่อ event
propertiesattribute ของ event
userIdUser ID
timestamp (หรือ originalTimestamp)เวลาของ event
context.device.idDevice 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 to

destination ส่งเฉพาะข้อมูล 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 to

API token ไม่ตรงกับ application code ตรวจสอบว่า token เป็นของบัญชี Pushwoosh เดียวกันกับแอปพลิเคชัน

การเรียก identify ไม่ตรวจสอบ token จึงยังคงสำเร็จแม้ใช้ token ที่ไม่ถูกต้อง ใช้การเรียก track เพื่อทดสอบ token

การเรียกล้มเหลวพร้อม application not found หรือ application code is not valid

Anchor link to

application 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 to

trait ทั้งหมดในการเรียกเป็น trait ด้านตัวตนหรือการติดต่อ เช่น email หรือ phone ซึ่งจะไม่ถูกคัดลอกไปเป็น tag เพิ่ม trait อื่นอย่างน้อยหนึ่งรายการ หรือข้ามการเรียกนั้น

การเรียก identify สำเร็จแต่ tag ไม่ปรากฏ

Anchor link to

ตรวจสอบรายการต่อไปนี้ตามลำดับ:

  1. มีอุปกรณ์ที่มี User ID นี้ลงทะเบียนอยู่ใน Pushwoosh ค้นหาผู้ใช้ใน Audience → User Explorer
  2. แอปเรียก setUserId ด้วยค่าเดียวกันทุกประการกับที่ RudderStack ส่งเป็น userId
  3. tag ที่มีชื่อนี้เป็นแบบ User-specific trait สำหรับ tag แบบ General ที่มีอยู่จะถูกข้าม ให้เปลี่ยนขอบเขตของ tag หรือเปลี่ยนชื่อ trait
  4. ค่าของ trait ตรงกับประเภทของ tag ที่มีอยู่
  5. trait ไม่ใช่ trait ด้านตัวตนหรือการติดต่อที่ไม่ถูกคัดลอก เช่น email หรือ phone