# การผสานรวม Amplitude

<Aside type="caution" icon="setting" title="จำเป็นต้องได้รับความช่วยเหลือจากนักพัฒนา">
คุณจะต้องได้รับความช่วยเหลือจากทีมนักพัฒนาของคุณเพื่อตั้งค่าการผสานรวม โปรดแชร์คู่มือนี้กับพวกเขา
</Aside>

[Amplitude](https://amplitude.com/) ซึ่งเป็นแพลตฟอร์มการวิเคราะห์ผลิตภัณฑ์ที่แข็งแกร่ง ช่วยให้ธุรกิจสามารถเข้าใจพฤติกรรมของผู้ใช้แบบเรียลไทม์ ติดตามการโต้ตอบภายในผลิตภัณฑ์ และรับข้อมูลเชิงลึกอันมีค่าเกี่ยวกับการมีส่วนร่วมของผู้ใช้ การรักษาผู้ใช้ และรายได้

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

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

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

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

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

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

* คุณต้องมีบัญชี Pushwoosh ที่ใช้งานอยู่
* สร้าง [API Access Token](/th/developer/api-reference/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`), application code (`app_id`), timestamp (`created_at`) และ attributes เพิ่มเติม (`attributes`)

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

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

##### โฟลว์ข้อมูล

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

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

##### Requests

Requests จะถูกส่งไปยัง endpoints เฉพาะใน Pushwoosh เพื่อจัดการ events, user attributes และการอัปเดต segment แต่ละ request ต้องการการรับรองความถูกต้องและมี headers และรูปแบบ payload ที่เฉพาะเจาะจง


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

##### การติดตาม Event

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

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

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

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

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

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

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


### การซิงค์ Cohort

##### การตั้งค่า Pushwoosh

1. ใน Pushwoosh ไปที่ **Settings > Integrations**
2. คลิก **Add Integration** จากนั้นค้นหาและเพิ่ม **Amplitude**

   <img src="/integrations-amplitude-integration-1.webp" alt="ตัวเลือกการผสานรวม Amplitude ในการตั้งค่า Pushwoosh"/>

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


##### การตั้งค่า Amplitude

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

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

<img src="/integrations-amplitude-integration-2.webp" alt="การเลือก Pushwoosh จากปลายทาง"/>

3. คลิก **Add another destination**

<img src="/integrations-amplitude-integration-3.webp" alt="การเพิ่มปลายทางอื่น"/>

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

<img src="/integrations-amplitude-integration-4.webp" alt="การเพิ่ม Pushwoosh API access token และ application code"/>

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

##### การส่ง Cohort

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

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

<img src="/integrations-amplitude-integration-5.webp" alt="การส่ง cohort"/>

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

<img src="/integrations-amplitude-integration-6.webp" alt="การเลือก Pushwoosh เป็นปลายทางการซิงค์"/>

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

<img src="/integrations-amplitude-integration-7.webp" alt="การตั้งค่าความถี่ในการซิงโครไนซ์"/>

### การสตรีม Event

##### การตั้งค่า Pushwoosh
1. รับ Pushwoosh API Key ของคุณ

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

##### การตั้งค่า Amplitude
1. ใน Amplitude ไปที่ **Data Destinations** และค้นหา **Pushwoosh - Event Stream**

<img src="/integrations-amplitude-integration-8.webp" alt="Data Destinations ที่แสดงตัวเลือก Pushwoosh Event Stream"/>

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

<img src="/integrations-amplitude-integration-9.webp" alt="ฟอร์มการสร้างชื่อการซิงค์ของ Amplitude"/>

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

<img src="/integrations-amplitude-integration-10.webp" alt="การเปิดใช้งาน Pushwoosh Event Stream ด้วยข้อมูลประจำตัว API"/>

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

<img src="/integrations-amplitude-integration-11.webp" alt="ตัวเลือกสลับ Create and Update users"/>

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

<img src="/integrations-amplitude-integration-12.webp" alt="ตัวเลือก Send Events สำหรับการสตรีม event แบบเรียลไทม์"/>

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

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

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

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

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

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

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

##### บันทึก requests และ responses

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

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

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

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

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

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

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

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

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

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

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

- **Event ไม่ปรากฏใน Pushwoosh**: ตรวจสอบให้แน่ใจว่า event ถูกแมปอย่างถูกต้อง และตรวจสอบว่า application code และ API token ของ Pushwoosh ได้รับการกำหนดค่าอย่างถูกต้อง

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

##### ปัญหา Segment

- **Segment ไม่ถูกสร้าง**: ตรวจสอบว่า request เพื่อสร้าง segment ถูกจัดรูปแบบอย่างถูกต้องและ API token ของ Pushwoosh นั้นถูกต้อง

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

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

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

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

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

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

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

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

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