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

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

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

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

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

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

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

ปลายทาง: ข้อมูลถูกส่งจาก Amplitude ไปยัง Pushwoosh

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

ในการตั้งค่าการผสานรวม Event Streaming และ Cohort Sync จาก Amplitude ไปยัง Pushwoosh โปรดตรวจสอบให้แน่ใจว่าตรงตามข้อกำหนดเบื้องต้นต่อไปนี้:

• คุณต้องมีบัญชี Pushwoosh ที่ใช้งานอยู่
• สร้าง API Access Token ใน Pushwoosh เพื่อส่งข้อมูล
• ค้นหา Pushwoosh App Code ของคุณก่อนที่จะกำหนดค่าการผสานรวม
• การผสานรวมนี้มีให้สำหรับลูกค้า Amplitude ที่มีแผนชำระเงินเท่านั้น
• คุณต้องมีแผนชำระเงินของ Pushwoosh เพื่อใช้การผสานรวมนี้

คำศัพท์ (การจับคู่ชื่อเอนทิตีหากแตกต่างกัน)

Cohorts ใน Amplitude = Segments ใน Pushwoosh

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

• Events
• Tags
• Segments

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

การผสานรวม Amplitude กับ Pushwoosh ทำงานโดยการซิงค์ข้อมูลระหว่างสองแพลตฟอร์มเพื่อเพิ่มการมีส่วนร่วมและการแบ่งกลุ่มผู้ใช้ นี่คือรายละเอียดวิธีการทำงาน:

การส่งข้อมูล

• Events: Amplitude ส่งข้อมูล event ไปยัง Pushwoosh แต่ละ event ประกอบด้วย user ID (external_id), รหัสแอปพลิเคชัน (app_id), การประทับเวลา (created_at) และแอตทริบิวต์เพิ่มเติม (attributes)

• Tags: Pushwoosh ได้รับ tag ที่เชื่อมโยงกับโปรไฟล์ผู้ใช้ tag เหล่านี้จะถูกส่งพร้อมกับ user ID (external_id), รหัสแอปพลิเคชัน (app_id) และคุณสมบัติของ tag (properties)

• Segments: Segment จะถูกนำเข้าในลักษณะเดียวกับที่ Pushwoosh จัดการการนำเข้าไฟล์ CSV ผู้ใช้จะถูกเพิ่มหรือลบออกจาก segment ผ่านคำขอ

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

• Events และ Tags: ข้อมูลจะถูกส่งจาก Amplitude ไปยัง Pushwoosh ตามการโต้ตอบของผู้ใช้หรือแอตทริบิวต์ที่ติดตามใน Amplitude Events และ tag จะถูกสร้างหรืออัปเดตใน Pushwoosh ตามการกำหนดค่าและการจับคู่ที่ตั้งค่าไว้ใน Amplitude

• Segments: Segment จะถูกสร้างขึ้นใน Pushwoosh เมื่อ Amplitude ส่งคำขอ Pushwoosh จะสร้างตัวระบุที่ไม่ซ้ำกันสำหรับแต่ละ segment ซึ่ง Amplitude จะใช้เพื่อจัดการ segment โดยการเพิ่มหรือลบผู้ใช้

คำขอ

คำขอจะถูกส่งไปยัง endpoint เฉพาะใน Pushwoosh เพื่อจัดการ event, แอตทริบิวต์ผู้ใช้ และการอัปเดต segment แต่ละคำขอต้องการการรับรองความถูกต้องและมีรูปแบบ header และ payload ที่เฉพาะเจาะจง

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

การติดตาม Event

ติดตามการกระทำและการโต้ตอบของผู้ใช้จาก Amplitude และส่ง event เหล่านี้ไปยัง Pushwoosh เพื่อทริกเกอร์การแจ้งเตือนหรือการอัปเดต

การติด Tag ผู้ใช้

กำหนด tag ให้กับผู้ใช้ตามพฤติกรรมหรือแอตทริบิวต์ของพวกเขาใน Amplitude tag เหล่านี้สามารถใช้ใน Pushwoosh สำหรับการส่งข้อความเป้าหมายหรือการแบ่งกลุ่ม

การจัดการ Segment

สร้างและจัดการ segment ผู้ใช้ใน Pushwoosh ตามข้อมูลและ segment ที่กำหนดค่าไว้ใน Amplitude ซึ่งช่วยในการกำหนดเป้าหมายกลุ่มผู้ใช้เฉพาะด้วยข้อความส่วนบุคคล

การจัดการผู้ใช้อัตโนมัติ

เพิ่มหรือลบผู้ใช้ออกจาก segment โดยอัตโนมัติตามการกระทำหรือแอตทริบิวต์ของพวกเขาใน Amplitude เพื่อให้แน่ใจว่าการแบ่งกลุ่มใน Pushwoosh เป็นปัจจุบันอยู่เสมอ

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

การซิงค์ Cohort

การตั้งค่า Pushwoosh

1. ใน Pushwoosh ไปที่ Settings > Integrations

2. คลิก Add Integration จากนั้นค้นหาและเพิ่ม Amplitude

   

3. คัดลอก API Key และ App Code ของ Pushwoosh ไปยังคลิปบอร์ดของคุณ

การตั้งค่า Amplitude

ในการกำหนดค่า Amplitude สำหรับการผสานรวม ให้ทำตามขั้นตอนเหล่านี้:

1. ใน Data ของ Amplitude ของคุณ ไปที่ Catalog และเลือก Destinations
2. ใต้ส่วน Cohort ค้นหาและคลิก Pushwoosh

3. คลิก Add another destination

4. ระบุชื่อและวาง API key ที่คุณคัดลอกมาจาก Pushwoosh

5. จับคู่ฟิลด์ Amplitude User ID กับฟิลด์ Pushwoosh User ID
6. บันทึกการตั้งค่าของคุณเมื่อเสร็จสิ้น

การส่ง Cohort

ในการซิงโครไนซ์ cohort แรกของคุณ ให้ทำตามขั้นตอนต่อไปนี้:

1. ใน Amplitude เปิด cohort ที่คุณต้องการซิงโครไนซ์ จากนั้นคลิกที่ Sync

2. เลือก Pushwoosh และเลือกบัญชีที่คุณต้องการซิงโครไนซ์ด้วย จากนั้นคลิก Next

3. ตัดสินใจเกี่ยวกับความถี่ในการซิงโครไนซ์และบันทึกการกำหนดค่าของคุณ

การสตรีม Event

การตั้งค่า Pushwoosh

1. รับ Pushwoosh API Key ของคุณ

2. ค้นหา App Code ในบัญชี Pushwoosh ของคุณ

การตั้งค่า Amplitude

1. ใน Amplitude ไปที่ Data Destinations และค้นหา Pushwoosh - Event Stream

2. ป้อนชื่อการซิงค์แล้วคลิก Create Sync

3. เปลี่ยนสถานะจาก Disabled เป็น Enabled และวาง Pushwoosh API Access Token และ App Code ของคุณ

4. จากเมนู dropdown ด้านซ้าย เลือกคุณสมบัติผู้ใช้ Amplitude ที่สอดคล้องกับ Pushwoosh UserID ของคุณ
5. (ไม่บังคับ) เปิดใช้งานสวิตช์ Create & Update users หากคุณต้องการส่งผู้ใช้และคุณสมบัติของพวกเขาแบบเรียลไทม์เมื่อใดก็ตามที่ Amplitude สร้างหรืออัปเดตคุณสมบัติผู้ใช้

6. เปิดใช้งาน Send Events (“Events are sent to Pushwoosh”) หากคุณต้องการสตรีม event ไปยัง Pushwoosh ซึ่งจะส่งต่อ event ไปยัง Pushwoosh โดยอัตโนมัติเมื่อถูกนำเข้าใน Amplitude Event จะไม่ถูกส่งตามกำหนดเวลาหรือตามความต้องการโดยใช้การผสานรวมนี้

8. จากนั้น เลือก event ที่คุณต้องการส่งในส่วน Select and Filter Events เลือกเฉพาะ event ที่คุณต้องการใน Pushwoosh; ไม่รองรับ event ที่ถูกแปลง
9. เมื่อเสร็จแล้ว ให้เปิดใช้งานปลายทางและคลิก Save

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

ในการตรวจสอบว่าการผสานรวม Amplitude และ Pushwoosh ทำงานอย่างถูกต้อง คุณสามารถใช้วิธีการต่อไปนี้:

ตรวจสอบแดชบอร์ด Pushwoosh

• Events และ Tags: ตรวจสอบแดชบอร์ด Pushwoosh เพื่อดูว่า event และ tag ที่ส่งจาก Amplitude ปรากฏตามที่คาดไว้หรือไม่ มองหากิจกรรมล่าสุดหรือการอัปเดตที่เกี่ยวข้องกับ event และ tag ของคุณ
• Segments: ตรวจสอบว่า segment กำลังถูกสร้าง อัปเดต หรือแก้ไขตามข้อมูลจาก Amplitude หรือไม่ ตรวจสอบให้แน่ใจว่าจำนวนผู้ใช้และการเป็นสมาชิก segment สะท้อนถึงการเปลี่ยนแปลงที่คาดหวัง

ตรวจสอบการตอบกลับของ API

• การตอบกลับที่สำเร็จ: ตรวจสอบให้แน่ใจว่าคุณได้รับการตอบกลับ 200 OK จาก Pushwoosh API endpoints แม้ว่าอาจจะไม่มีเนื้อหาการตอบกลับเสมอไป แต่สถานะ 200 OK บ่งชี้ว่าคำขอได้รับการรับสำเร็จแล้ว
• การตอบกลับข้อผิดพลาด: ตรวจสอบการตอบกลับข้อผิดพลาดหรือรหัสสถานะอื่นที่ไม่ใช่ 200 OK เพื่อหาเบาะแสหากมีบางอย่างไม่ทำงาน ข้อผิดพลาดทั่วไปอาจรวมถึง 400 Bad Request, 401 Unauthorized หรือ 500 Internal Server Error

บันทึกคำขอและการตอบกลับ

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

ทดสอบด้วยข้อมูลตัวอย่าง

• ส่ง Events/Tags ทดสอบ: สร้างและส่ง event และ tag ทดสอบจาก Amplitude ไปยัง Pushwoosh ตรวจสอบว่ารายการทดสอบเหล่านี้ปรากฏอย่างถูกต้องใน Pushwoosh และทริกเกอร์พฤติกรรมที่คาดหวัง
• จำลองการกระทำของผู้ใช้: ดำเนินการใน Amplitude ที่ควรจะทริกเกอร์ event หรือการอัปเดตเฉพาะใน Pushwoosh ตรวจสอบว่าการกระทำเหล่านี้ส่งผลให้เกิดการเปลี่ยนแปลงที่คาดหวังใน Pushwoosh หรือไม่

ใช้เครื่องมือตรวจสอบ

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

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

• การตรวจสอบการกำหนดค่า: ตรวจสอบการกำหนดค่าการผสานรวมอีกครั้งในทั้ง Amplitude และ Pushwoosh เพื่อให้แน่ใจว่าการตั้งค่าและการจับคู่ทั้งหมดถูกนำไปใช้อย่างถูกต้อง
• การอัปเดตเอกสาร: ติดตามการเปลี่ยนแปลงหรือการอัปเดตใดๆ ในเอกสารการผสานรวมที่อาจส่งผลต่อการทำงาน

ติดต่อฝ่ายสนับสนุน

หากคุณพบปัญหาหรือความไม่สอดคล้องอย่างต่อเนื่อง โปรดติดต่อทีมสนับสนุนของ Amplitude หรือ Pushwoosh เพื่อขอความช่วยเหลือ ให้รายละเอียดเกี่ยวกับการตั้งค่าการผสานรวมและบันทึกข้อผิดพลาดใดๆ เพื่อการแก้ไขที่รวดเร็วยิ่งขึ้น

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

ปัญหาการผสานรวม

• Event ไม่ปรากฏใน Pushwoosh: ตรวจสอบให้แน่ใจว่า event ถูกจับคู่อย่างถูกต้อง และตรวจสอบว่ารหัสแอปพลิเคชัน Pushwoosh และ API token ได้รับการกำหนดค่าอย่างถูกต้อง

• Tags ไม่ซิงค์: ยืนยันว่า tag ถูกจัดรูปแบบอย่างถูกต้องและรายละเอียดการรับรองความถูกต้องที่จำเป็นทั้งหมดรวมอยู่ในคำขอ

ปัญหาเกี่ยวกับ Segment

• Segment ไม่ถูกสร้าง: ตรวจสอบว่าคำขอสร้าง segment ถูกจัดรูปแบบอย่างถูกต้องและ Pushwoosh API token นั้นถูกต้อง

• ผู้ใช้ไม่ถูกเพิ่ม/ลบ: ตรวจสอบว่า user ID ถูกระบุอย่างถูกต้องและ segment ID นั้นถูกต้อง ตรวจสอบให้แน่ใจว่า request payload ถูกจัดรูปแบบอย่างถูกต้อง

ปัญหาการตอบกลับ

• ไม่มีเนื้อหาการตอบกลับ: หากคุณได้รับการตอบกลับ 200 OK แต่ไม่มีเนื้อหาการตอบกลับ ให้ตรวจสอบว่าคำขอถูกจัดรูปแบบอย่างถูกต้องและข้อมูลถูกส่งอย่างถูกต้อง

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

ฉันควรทำอย่างไรหากได้รับข้อผิดพลาด 400 Bad Request?

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

ฉันจะตรวจสอบได้อย่างไรว่าการผสานรวมทำงานอยู่?

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

ฉันสามารถปรับแต่ง event หรือ tag ที่ส่งไปยัง Pushwoosh ได้หรือไม่?

ได้ คุณสามารถปรับแต่ง event และ tag ภายในการกำหนดค่าของ Amplitude ได้ ตรวจสอบให้แน่ใจว่าข้อมูลเป็นไปตามรูปแบบที่ Pushwoosh คาดหวัง

ข้อมูลซิงค์ระหว่าง Amplitude และ Pushwoosh บ่อยแค่ไหน?

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

ฉันจะหาข้อมูลเพิ่มเติมหรือการสนับสนุนสำหรับการผสานรวมนี้ได้ที่ไหน?

โปรดดูเอกสารอย่างเป็นทางการจาก Amplitude และ Pushwoosh หากต้องการความช่วยเหลือเพิ่มเติม โปรดติดต่อทีมสนับสนุนของแต่ละฝ่าย