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

การผสานการทำงานกับ 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
  1. ใน Pushwoosh ไปที่ การตั้งค่า (Settings) > การผสานการทำงาน (Integrations)

  2. คลิก เพิ่มการผสานการทำงาน (Add Integration) จากนั้นค้นหาและเพิ่ม Amplitude

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

การตั้งค่า Amplitude
Anchor link to

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

  1. ใน ข้อมูล (Data) ของ Amplitude ของคุณ ไปที่ แคตตาล็อก (Catalog) และเลือก ปลายทาง (Destinations)
  2. ใต้ส่วน Cohort ค้นหาและคลิก Pushwoosh
Choosing Pushwoosh from destinations
  1. คลิก เพิ่มปลายทางอื่น (Add another destination)
Adding another destination
  1. ระบุชื่อและวางคีย์ API ที่คุณคัดลอกมาจาก Pushwoosh
Adding Pushwoosh APi access token and application code
  1. จับคู่ฟิลด์รหัสผู้ใช้ Amplitude (Amplitude User ID) กับฟิลด์รหัสผู้ใช้ Pushwoosh (Pushwoosh User ID)
  2. บันทึกการตั้งค่าของคุณเมื่อเสร็จสิ้น
การส่งโคฮอร์ต
Anchor link to

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

  1. ใน Amplitude เปิดโคฮอร์ตที่คุณต้องการซิงโครไนซ์ จากนั้นคลิกที่ ซิงค์ (Sync)
Sending a cohort
  1. เลือก Pushwoosh และเลือกบัญชีที่คุณต้องการซิงโครไนซ์ด้วย จากนั้นคลิก ถัดไป (Next)
  1. ตัดสินใจเลือกความถี่ในการซิงโครไนซ์และบันทึกการกำหนดค่าของคุณ

การสตรีมเหตุการณ์ (Event streaming)

Anchor link to
การตั้งค่า Pushwoosh
Anchor link to
  1. รับคีย์ API ของ Pushwoosh ของคุณ

  2. ค้นหารหัสแอป (App Code) ในบัญชี Pushwoosh ของคุณ

การตั้งค่า Amplitude
Anchor link to
  1. ใน Amplitude ไปที่ ปลายทางข้อมูล (Data Destinations) และค้นหา Pushwoosh - Event Stream
  1. ป้อนชื่อการซิงค์ จากนั้นคลิก สร้างการซิงค์ (Create Sync)
  1. เปลี่ยนสถานะจาก ปิดใช้งาน (Disabled) เป็น เปิดใช้งาน (Enabled) และวางโทเค็นการเข้าถึง API และรหัสแอปของ Pushwoosh ของคุณ
  1. จากเมนูดรอปดาวน์ด้านซ้าย ให้เลือกคุณสมบัติผู้ใช้ Amplitude ที่สอดคล้องกับ UserID ของ Pushwoosh ของคุณ
  2. (ทางเลือก) เปิดใช้งานสวิตช์ สร้างและอัปเดตผู้ใช้ (Create & Update users) หากคุณต้องการส่งผู้ใช้และคุณสมบัติของพวกเขาแบบเรียลไทม์เมื่อใดก็ตามที่ Amplitude สร้างหรืออัปเดตคุณสมบัติผู้ใช้
  1. เปิดใช้งาน ส่งเหตุการณ์ (Send Events) (“เหตุการณ์จะถูกส่งไปยัง Pushwoosh”) หากคุณต้องการสตรีมเหตุการณ์ไปยัง Pushwoosh ซึ่งจะส่งต่อเหตุการณ์ไปยัง Pushwoosh โดยอัตโนมัติเมื่อมีการนำเข้าข้อมูลใน Amplitude เหตุการณ์จะไม่ถูกส่งตามกำหนดเวลาหรือตามความต้องการโดยใช้การผสานการทำงานนี้
  1. จากนั้น เลือกเหตุการณ์ที่คุณต้องการส่งในส่วน เลือกและกรองเหตุการณ์ (Select and Filter Events) เลือกเฉพาะเหตุการณ์ที่คุณต้องการใน Pushwoosh เท่านั้น ไม่รองรับเหตุการณ์ที่ถูกแปลงค่า
  2. เมื่อเสร็จแล้ว ให้เปิดใช้งานปลายทางและคลิก บันทึก (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 สำหรับความช่วยเหลือเพิ่มเติม โปรดติดต่อทีมสนับสนุนของแต่ละฝ่าย