การผสานการทำงานกับ Amplitude
Amplitude เป็นแพลตฟอร์มวิเคราะห์ผลิตภัณฑ์ที่แข็งแกร่ง ช่วยให้ธุรกิจสามารถทำความเข้าใจพฤติกรรมของผู้ใช้แบบเรียลไทม์ ติดตามการโต้ตอบภายในผลิตภัณฑ์ และได้รับข้อมูลเชิงลึกอันมีค่าเกี่ยวกับการมีส่วนร่วมของผู้ใช้ การรักษาผู้ใช้ และรายได้
การผสานการทำงานระหว่าง Amplitude กับ Pushwoosh ช่วยให้คุณสามารถปรับแต่งแคมเปญ Pushwoosh ของคุณในแบบส่วนตัวด้วยข้อมูลจาก Amplitude สั่งการแคมเปญอัตโนมัติตามการกระทำของผู้ใช้ วิเคราะห์ประสิทธิภาพเพื่อการปรับปรุงอย่างต่อเนื่อง และท้ายที่สุดคือขับเคลื่อนการมีส่วนร่วมที่เพิ่มขึ้น ลดการเลิกใช้งานของลูกค้า และเพิ่มรายได้
ภาพรวมการผสานการทำงาน
Anchor link toประเภทการผสานการทำงาน
Anchor link toปลายทาง (Destination): ข้อมูลจะถูกส่งจาก Amplitude ไปยัง Pushwoosh
ข้อกำหนดเบื้องต้น
Anchor link toในการตั้งค่าการผสานการทำงาน Event Streaming และ Cohort Sync จาก Amplitude ไปยัง Pushwoosh โปรดตรวจสอบให้แน่ใจว่าคุณมีคุณสมบัติตรงตามข้อกำหนดเบื้องต้นต่อไปนี้:
- คุณต้องมีบัญชี Pushwoosh ที่ใช้งานอยู่
- สร้าง โทเค็นการเข้าถึง API (API Access Token) ใน Pushwoosh เพื่อส่งข้อมูล
- ค้นหารหัสแอป Pushwoosh (Pushwoosh App Code) ของคุณก่อนที่จะกำหนดค่าการผสานการทำงาน
- การผสานการทำงานนี้มีให้สำหรับลูกค้า Amplitude ที่มีแผนบริการแบบชำระเงินเท่านั้น
- คุณต้องมีแผนบริการ Pushwoosh แบบชำระเงินเพื่อใช้การผสานการทำงานนี้
อภิธานศัพท์ (การจับคู่ชื่อเอนทิตีหากแตกต่างกัน)
Anchor link toโคฮอร์ต (Cohorts) ใน Amplitude = เซกเมนต์ (Segments) ใน Pushwoosh
เอนทิตีที่ซิงโครไนซ์
Anchor link to- เหตุการณ์ (Events)
- แท็ก (Tags)
- เซกเมนต์ (Segments)
การผสานการทำงานทำงานอย่างไร
Anchor link toการผสานการทำงานระหว่าง Amplitude กับ Pushwoosh ทำงานโดยการซิงโครไนซ์ข้อมูลระหว่างสองแพลตฟอร์มเพื่อเพิ่มการมีส่วนร่วมและการแบ่งกลุ่มผู้ใช้ นี่คือรายละเอียดวิธีการทำงาน:
การส่งข้อมูล
Anchor link toเหตุการณ์ (Events): Amplitude ส่งข้อมูลเหตุการณ์ไปยัง Pushwoosh แต่ละเหตุการณ์ประกอบด้วยรหัสผู้ใช้ (
external_id
), รหัสแอปพลิเคชัน (app_id
), การประทับเวลา (created_at
) และแอตทริบิวต์เพิ่มเติม (attributes
)แท็ก (Tags): Pushwoosh รับแท็กที่เชื่อมโยงกับโปรไฟล์ผู้ใช้ แท็กเหล่านี้จะถูกส่งพร้อมกับรหัสผู้ใช้ (
external_id
), รหัสแอปพลิเคชัน (app_id
) และคุณสมบัติของแท็ก (properties
)เซกเมนต์ (Segments): เซกเมนต์จะถูกนำเข้าคล้ายกับวิธีที่ Pushwoosh จัดการการนำเข้าไฟล์ CSV ผู้ใช้จะถูกเพิ่มเข้าหรือลบออกจากเซกเมนต์ผ่านคำขอ
โฟลว์ข้อมูล
Anchor link toเหตุการณ์และแท็ก: ข้อมูลจะถูกส่งจาก Amplitude ไปยัง Pushwoosh โดยอิงตามการโต้ตอบหรือแอตทริบิวต์ของผู้ใช้ที่ติดตามใน Amplitude เหตุการณ์และแท็กจะถูกสร้างหรืออัปเดตใน Pushwoosh ตามการกำหนดค่าและการจับคู่ที่ตั้งค่าไว้ใน Amplitude
เซกเมนต์: เซกเมนต์จะถูกสร้างขึ้นใน Pushwoosh เมื่อ Amplitude ส่งคำขอ Pushwoosh จะสร้างตัวระบุที่ไม่ซ้ำกันสำหรับแต่ละเซกเมนต์ ซึ่ง Amplitude จะใช้เพื่อจัดการเซกเมนต์โดยการเพิ่มหรือลบผู้ใช้
คำขอ (Requests)
Anchor link toคำขอจะถูกส่งไปยังเอนด์พอยต์เฉพาะใน Pushwoosh เพื่อจัดการเหตุการณ์ แอตทริบิวต์ผู้ใช้ และการอัปเดตเซกเมนต์ แต่ละคำขอต้องมีการรับรองความถูกต้องและมีส่วนหัว (headers) และรูปแบบเพย์โหลด (payload) ที่เฉพาะเจาะจง
กรณีการใช้งาน
Anchor link toการติดตามเหตุการณ์
Anchor link toติดตามการกระทำและการโต้ตอบของผู้ใช้จาก Amplitude และส่งเหตุการณ์เหล่านี้ไปยัง Pushwoosh เพื่อสั่งการการแจ้งเตือนหรือการอัปเดต
การติดแท็กผู้ใช้
Anchor link toกำหนดแท็กให้กับผู้ใช้ตามพฤติกรรมหรือแอตทริบิวต์ของพวกเขาใน Amplitude แท็กเหล่านี้สามารถใช้ใน Pushwoosh สำหรับการส่งข้อความที่ตรงเป้าหมายหรือการแบ่งกลุ่ม
การจัดการเซกเมนต์
Anchor link toสร้างและจัดการเซกเมนต์ผู้ใช้ใน Pushwoosh โดยอิงจากข้อมูลและเซกเมนต์ที่กำหนดค่าไว้ใน Amplitude ซึ่งช่วยในการกำหนดเป้าหมายกลุ่มผู้ใช้ที่เฉพาะเจาะจงด้วยข้อความส่วนบุคคล
การจัดการผู้ใช้อัตโนมัติ
Anchor link toเพิ่มหรือลบผู้ใช้ออกจากเซกเมนต์โดยอัตโนมัติตามการกระทำหรือแอตทริบิวต์ของพวกเขาใน Amplitude เพื่อให้แน่ใจว่าการแบ่งกลุ่มใน Pushwoosh เป็นปัจจุบันอยู่เสมอ
การตั้งค่าการผสานการทำงาน
Anchor link toการซิงค์โคฮอร์ต (Cohort sync)
Anchor link toการตั้งค่า Pushwoosh
Anchor link toใน Pushwoosh ไปที่ การตั้งค่า (Settings) > การผสานการทำงาน (Integrations)
คลิก เพิ่มการผสานการทำงาน (Add Integration) จากนั้นค้นหาและเพิ่ม Amplitude
คัดลอก คีย์ API (API Key) และ รหัสแอป (App Code) ของ Pushwoosh ไปยังคลิปบอร์ดของคุณ
การตั้งค่า Amplitude
Anchor link toในการกำหนดค่า Amplitude สำหรับการผสานการทำงาน ให้ทำตามขั้นตอนเหล่านี้:
- ใน ข้อมูล (Data) ของ Amplitude ของคุณ ไปที่ แคตตาล็อก (Catalog) และเลือก ปลายทาง (Destinations)
- ใต้ส่วน Cohort ค้นหาและคลิก Pushwoosh

- คลิก เพิ่มปลายทางอื่น (Add another destination)

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

- จับคู่ฟิลด์รหัสผู้ใช้ Amplitude (Amplitude User ID) กับฟิลด์รหัสผู้ใช้ Pushwoosh (Pushwoosh User ID)
- บันทึกการตั้งค่าของคุณเมื่อเสร็จสิ้น
การส่งโคฮอร์ต
Anchor link toในการซิงโครไนซ์โคฮอร์ตแรกของคุณ ให้ทำตามขั้นตอนต่อไปนี้:
- ใน Amplitude เปิดโคฮอร์ตที่คุณต้องการซิงโครไนซ์ จากนั้นคลิกที่ ซิงค์ (Sync)

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

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

การสตรีมเหตุการณ์ (Event streaming)
Anchor link toการตั้งค่า Pushwoosh
Anchor link toรับคีย์ API ของ Pushwoosh ของคุณ
ค้นหารหัสแอป (App Code) ในบัญชี Pushwoosh ของคุณ
การตั้งค่า Amplitude
Anchor link to- ใน Amplitude ไปที่ ปลายทางข้อมูล (Data Destinations) และค้นหา Pushwoosh - Event Stream

- ป้อนชื่อการซิงค์ จากนั้นคลิก สร้างการซิงค์ (Create Sync)

- เปลี่ยนสถานะจาก ปิดใช้งาน (Disabled) เป็น เปิดใช้งาน (Enabled) และวางโทเค็นการเข้าถึง API และรหัสแอปของ Pushwoosh ของคุณ

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

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

- จากนั้น เลือกเหตุการณ์ที่คุณต้องการส่งในส่วน เลือกและกรองเหตุการณ์ (Select and Filter Events) เลือกเฉพาะเหตุการณ์ที่คุณต้องการใน Pushwoosh เท่านั้น ไม่รองรับเหตุการณ์ที่ถูกแปลงค่า
- เมื่อเสร็จแล้ว ให้เปิดใช้งานปลายทางและคลิก บันทึก (Save)
คุณจะทราบได้อย่างไรว่าการผสานการทำงานกำลังทำงานอยู่
Anchor link toในการตรวจสอบว่าการผสานการทำงานระหว่าง Amplitude และ Pushwoosh ทำงานอย่างถูกต้อง คุณสามารถใช้วิธีการต่อไปนี้:
ตรวจสอบแดชบอร์ด Pushwoosh
Anchor link to- เหตุการณ์และแท็ก: ตรวจสอบแดชบอร์ด Pushwoosh เพื่อดูว่าเหตุการณ์และแท็กที่ส่งจาก Amplitude ปรากฏขึ้นตามที่คาดไว้หรือไม่ มองหากิจกรรมล่าสุดหรือการอัปเดตที่เกี่ยวข้องกับเหตุการณ์และแท็กของคุณ
- เซกเมนต์: ตรวจสอบว่าเซกเมนต์กำลังถูกสร้าง อัปเดต หรือแก้ไขตามข้อมูลจาก Amplitude หรือไม่ ตรวจสอบให้แน่ใจว่าจำนวนผู้ใช้และการเป็นสมาชิกเซกเมนต์สะท้อนถึงการเปลี่ยนแปลงที่คาดไว้
ตรวจสอบการตอบกลับของ API
Anchor link to- การตอบกลับที่สำเร็จ: ตรวจสอบให้แน่ใจว่าคุณได้รับการตอบกลับ
200 OK
จากเอนด์พอยต์ของ Pushwoosh API แม้ว่าจะไม่มีเนื้อหาการตอบกลับเสมอไป แต่สถานะ200 OK
บ่งชี้ว่าคำขอได้รับการยอมรับเรียบร้อยแล้ว - การตอบกลับข้อผิดพลาด: ตรวจสอบการตอบกลับข้อผิดพลาดหรือรหัสสถานะอื่น ๆ นอกเหนือจาก
200 OK
เพื่อหาเบาะแสหากมีบางอย่างทำงานไม่ถูกต้อง ข้อผิดพลาดทั่วไปอาจรวมถึง400 Bad Request
,401 Unauthorized
หรือ500 Internal Server Error
บันทึกคำขอและการตอบกลับ
Anchor link to- บันทึกคำขอ: เก็บบันทึกคำขอที่ส่งออกจาก Amplitude และการตอบกลับที่เข้ามาจาก Pushwoosh ตรวจสอบบันทึกเหล่านี้เพื่อให้แน่ใจว่าคำขอมีรูปแบบที่ถูกต้องและการตอบกลับเป็นไปตามที่คาดหวัง
- การบันทึกข้อผิดพลาด: ใช้การบันทึกข้อผิดพลาดเพื่อจับปัญหาใด ๆ ระหว่างการถ่ายโอนข้อมูลหรือกระบวนการผสานการทำงาน
ทดสอบด้วยข้อมูลตัวอย่าง
Anchor link to- ส่งเหตุการณ์/แท็กทดสอบ: สร้างและส่งเหตุการณ์และแท็กทดสอบจาก Amplitude ไปยัง Pushwoosh ตรวจสอบว่ารายการทดสอบเหล่านี้ปรากฏอย่างถูกต้องใน Pushwoosh และกระตุ้นพฤติกรรมที่คาดหวัง
- จำลองการกระทำของผู้ใช้: ดำเนินการใน Amplitude ที่ควรจะกระตุ้นเหตุการณ์หรือการอัปเดตเฉพาะใน Pushwoosh ตรวจสอบว่าการกระทำเหล่านี้ส่งผลให้เกิดการเปลี่ยนแปลงที่คาดหวังใน Pushwoosh หรือไม่
ใช้เครื่องมือตรวจสอบ
Anchor link to- การตรวจสอบการผสานการทำงาน: ใช้เครื่องมือหรือบริการตรวจสอบที่สามารถติดตามสถานะและประสิทธิภาพของการผสานการทำงานได้ เครื่องมือเหล่านี้สามารถแจ้งเตือนคุณถึงปัญหาหรือความล้มเหลวแบบเรียลไทม์
- การวิเคราะห์และการรายงาน: ใช้คุณสมบัติการวิเคราะห์ทั้งใน Amplitude และ Pushwoosh เพื่อตรวจสอบโฟลว์ข้อมูลและประสิทธิภาพการผสานการทำงาน
ตรวจสอบเอกสารการผสานการทำงาน
Anchor link to- การตรวจสอบการกำหนดค่า: ตรวจสอบการกำหนดค่าการผสานการทำงานทั้งใน Amplitude และ Pushwoosh อีกครั้งเพื่อให้แน่ใจว่าการตั้งค่าและการจับคู่ทั้งหมดถูกนำไปใช้อย่างถูกต้อง
- การอัปเดตเอกสาร: ติดตามการเปลี่ยนแปลงหรือการอัปเดตใด ๆ ในเอกสารการผสานการทำงานที่อาจส่งผลต่อการทำงาน
ติดต่อฝ่ายสนับสนุน
Anchor link toหากคุณประสบปัญหาที่ไม่สามารถแก้ไขได้หรือไม่สอดคล้องกัน โปรดติดต่อทีมสนับสนุนของ Amplitude หรือ Pushwoosh เพื่อขอความช่วยเหลือ โปรดให้รายละเอียดเกี่ยวกับการตั้งค่าการผสานการทำงานและบันทึกข้อผิดพลาดใด ๆ เพื่อการแก้ไขที่รวดเร็วยิ่งขึ้น
การแก้ไขปัญหา
Anchor link toปัญหาการผสานการทำงาน
Anchor link toเหตุการณ์ไม่ปรากฏใน Pushwoosh: ตรวจสอบให้แน่ใจว่าเหตุการณ์ถูกจับคู่อย่างถูกต้อง และตรวจสอบว่ารหัสแอปพลิเคชัน Pushwoosh และโทเค็น API ได้รับการกำหนดค่าอย่างถูกต้อง
แท็กไม่ซิงค์: ยืนยันว่าแท็กมีรูปแบบที่ถูกต้องและมีรายละเอียดการรับรองความถูกต้องที่จำเป็นทั้งหมดรวมอยู่ในคำขอ
ปัญหาเกี่ยวกับเซกเมนต์
Anchor link toเซกเมนต์ไม่ถูกสร้าง: ตรวจสอบว่าคำขอเพื่อสร้างเซกเมนต์มีรูปแบบที่ถูกต้องและโทเค็น API ของ Pushwoosh นั้นถูกต้อง
ผู้ใช้ไม่ถูกเพิ่ม/ลบ: ตรวจสอบว่ารหัสผู้ใช้ถูกระบุอย่างถูกต้องและรหัสเซกเมนต์นั้นถูกต้อง ตรวจสอบให้แน่ใจว่าเพย์โหลดของคำขอมีรูปแบบที่เหมาะสม
ปัญหาการตอบกลับ
Anchor link to- ไม่มีเนื้อหาการตอบกลับ (response body): หากคุณได้รับการตอบกลับ
200 OK
แต่ไม่มีเนื้อหาการตอบกลับ ให้ตรวจสอบว่าคำขอมีรูปแบบที่เหมาะสมและข้อมูลถูกส่งอย่างถูกต้อง
คำถามที่พบบ่อย
Anchor link toฉันควรทำอย่างไรหากได้รับข้อผิดพลาด 400 Bad Request
Anchor link toตรวจสอบเพย์โหลดของคำขอเพื่อหาข้อผิดพลาดในการจัดรูปแบบหรือฟิลด์ที่ขาดหายไป ตรวจสอบให้แน่ใจว่าฟิลด์ที่จำเป็นทั้งหมดถูกรวมและจัดรูปแบบอย่างถูกต้อง
ฉันจะตรวจสอบได้อย่างไรว่าการผสานการทำงานกำลังทำงานอยู่
Anchor link toตรวจสอบแดชบอร์ด Pushwoosh สำหรับเหตุการณ์ แท็ก และการอัปเดตเซกเมนต์ที่เข้ามา คุณยังสามารถตรวจสอบบันทึกหรือการตอบกลับจากเอนด์พอยต์ API เพื่อดูการถ่ายโอนข้อมูลที่สำเร็จ
ฉันสามารถปรับแต่งเหตุการณ์หรือแท็กที่ส่งไปยัง Pushwoosh ได้หรือไม่
Anchor link toได้ คุณสามารถปรับแต่งเหตุการณ์และแท็กภายในการกำหนดค่าของ Amplitude ตรวจสอบให้แน่ใจว่าข้อมูลเป็นไปตามรูปแบบที่ Pushwoosh คาดหวัง
ข้อมูลซิงค์ระหว่าง Amplitude และ Pushwoosh บ่อยแค่ไหน
Anchor link toข้อมูลจะซิงค์แบบเรียลไทม์หรือเกือบเรียลไทม์ตามคำขอที่ทำจาก Amplitude ตรวจสอบให้แน่ใจว่าการกำหนดค่าของคุณรองรับความถี่ในการอัปเดตที่ต้องการ
ฉันจะหาข้อมูลเพิ่มเติมหรือการสนับสนุนสำหรับการผสานการทำงานนี้ได้ที่ไหน
Anchor link toอ้างอิงถึงเอกสารอย่างเป็นทางการจาก Amplitude และ Pushwoosh สำหรับความช่วยเหลือเพิ่มเติม โปรดติดต่อทีมสนับสนุนของแต่ละฝ่าย