# การผสานรวมกับ Solitics

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

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

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

แบรนด์ยังสามารถใช้ Solitics เพื่อวิเคราะห์ข้อมูลผู้ใช้และระบุส่วนที่ต้องปรับปรุงในเส้นทางของผู้ใช้ (user journey) ได้อีกด้วย ด้วยการผสานรวมข้อมูลนี้กับ Pushwoosh แบรนด์สามารถส่ง push notifications เพื่อดึงดูดผู้ใช้ที่อาจละทิ้งเส้นทางของตนกลับมาอีกครั้ง โดยนำพวกเขากลับไปยังแอปหรือเว็บไซต์และปรับปรุงอัตราคอนเวอร์ชันในที่สุด

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

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

### โปรโมชันและข้อเสนอส่วนบุคคล

ธุรกิจสามารถใช้ข้อมูลของ Solitics เพื่อวิเคราะห์ความชอบและพฤติกรรมของลูกค้า จากนั้นพวกเขาสามารถส่ง push notifications ที่ปรับแต่งผ่าน Pushwoosh พร้อมโปรโมชันและข้อเสนอที่ปรับให้เหมาะกับความสนใจของแต่ละบุคคล

### การเพิ่มการมีส่วนร่วม

ธุรกิจเกมสามารถกำหนดค่า Solitics เพื่อติดตามการกระทำและความสำเร็จของผู้เล่น จากนั้นใช้ Pushwoosh เพื่อส่ง push notifications สำหรับเหตุการณ์สำคัญและกิจกรรมพิเศษให้กับผู้เล่นทันที เพื่อกระตุ้นการมีส่วนร่วมและการเข้าร่วมในกิจกรรมในเกมที่เฉพาะเจาะจง

### การแจ้งเตือนความปลอดภัย

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

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

กระบวนการผสานรวมประกอบด้วยสองขั้นตอนหลัก:

1.  รวม Pushwoosh SDK เข้ากับเว็บไซต์หรือแอปมือถือของคุณ
2.  สร้าง User ID ที่ทำหน้าที่เป็นตัวระบุที่ไม่ซ้ำกันสำหรับทั้ง Solitics และ Pushwoosh

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

1.  บัญชี Pushwoosh
2.  [Pushwoosh API Access token](/th/developer/api-reference/api-access-token): เพื่อเปิดใช้งานการส่งข้อมูลไปยัง Pushwoosh คุณต้องสร้าง Pushwoosh API Access token หากต้องการรับโทเค็น ให้ไปที่ **Settings > API Access** และคัดลอกโทเค็นจากที่นั่น
3.  Pushwoosh App Code: ในทำนองเดียวกัน คุณจะต้องค้นหา Pushwoosh App Code ของคุณเพื่ออำนวยความสะดวกในการถ่ายโอนข้อมูลไปยัง Pushwoosh โดยค้นหาชื่อโปรเจกต์ที่มุมบนซ้ายและคัดลอกโค้ดที่แสดงอยู่ด้านล่าง
4.  [บัญชี Solitics](https://dashboard.solitics.com/#/pages/signin)

<Aside type="note">
เพื่อเปิดใช้งานการผสานรวม ให้ลงทะเบียนผู้ใช้แต่ละคนทั้งใน Solitics และ Pushwoosh โดยใช้ member ID เดียวกัน นี่คือข้อกำหนดหลักเพื่อให้การผสานรวมทำงานได้อย่างมีประสิทธิภาพ
</Aside>

### การกำหนดค่า Pushwoosh สำหรับการผสานรวม

1.  ตั้งค่าบัญชี Pushwoosh หากคุณยังไม่มี
2.  กำหนดค่าโปรเจกต์ของคุณ [เรียนรู้เพิ่มเติมเกี่ยวกับวิธีการทำ](/th/product/first-steps/start-with-your-project/configure-platforms)
3.  ถัดไป สร้างแอปพลิเคชันภายใน Pushwoosh และเลือกช่องทางการสื่อสารที่ต้องการ คุณสามารถเลือกใช้แอปพลิเคชันที่มีอยู่แล้วได้หากคุณมีอยู่แล้ว

### การกำหนดค่า Solitics สำหรับการผสานรวม

1.  ติดต่อ Solitics ([support@solitics.com](mailto:support@solitics.com)) และขอให้ผสานรวมแบรนด์ของคุณกับ Pushwoosh

ระบุรายละเอียดต่อไปนี้:

*   Pushwoosh API Key
*   Pushwoosh Application Code

2.  ทีม Solitics จะให้ access token แก่คุณสำหรับการโต้ตอบกับ API ของ Solitics ในอนาคต

## การลงทะเบียนผู้ใช้

ดังที่ได้เน้นย้ำไปก่อนหน้านี้ สิ่งสำคัญคือต้องลงทะเบียนผู้ใช้ด้วย User ID ที่เหมือนกันทั้งใน Solitics และ Pushwoosh

<Aside type="note">
ใช้ member ID ที่ไม่ซ้ำกันซึ่งแบรนด์ของคุณใช้สำหรับการผสานรวมสมาชิกเมื่อลงทะเบียนสำหรับ push notifications ความสอดคล้องกันนี้ไม่เพียงแต่จะทำให้แน่ใจว่า member ID ของคุณไม่ซ้ำกัน แต่ยังจะช่วยเพิ่มความคล่องตัวในการติดตามและอำนวยความสะดวกในการดีบักในกรณีที่เกิดปัญหาใดๆ
</Aside>

### การลงทะเบียนกับ Pushwoosh

Pushwoosh มีสองวิธีในการเชื่อมโยง User ID กับอุปกรณ์เฉพาะ หากคุณไม่ใช้วิธีการเหล่านี้ Pushwoosh จะใช้ device hardware ID เป็นตัวระบุของผู้ใช้โดยอัตโนมัติ

ในการเชื่อมโยง User ID กับอุปกรณ์ใน Pushwoosh คุณสามารถเลือกหนึ่งในวิธีการต่อไปนี้:

#### `setUserId`

นี่คือฟังก์ชัน SDK ที่ช่วยให้คุณสามารถตั้งค่าสตริงเป็น Pushwoosh ID ซึ่งจะถูกจับคู่กับ Hardware ID (HWID) ที่ Pushwoosh ใช้เพื่อระบุอุปกรณ์โดยอัตโนมัติ

**Android**

<LinkCard title="setUserId – Android" href="https://github.com/Pushwoosh/pushwoosh-android-sdk/blob/master/Documentation/inapp/PushwooshInApp.md#1a69cdb1592ad7640a49ba8bac8a14d54d" />

**iOS**
<LinkCard title="setUserId – iOS" href="https://github.com/Pushwoosh/pushwoosh-ios-sdk/blob/master/Documentation/PushNotificationManager.md#1ad51b323a64cbedb408442f9b52cc39fd" />


#### เมธอด `registerUser` API

เมธอดนี้ช่วยให้คุณสามารถกำหนด User ID ให้กับ HWID ที่เฉพาะเจาะจงจากแบ็กเอนด์ของคุณได้จากระยะไกล

ข้อมูลโดยละเอียดเกี่ยวกับการใช้การเรียก API นี้สามารถพบได้[ที่นี่](/th/developer/api-reference/user-centric-api#registeruser)

### การลงทะเบียนกับ Solitics

เมื่อผู้ใช้ลงทะเบียนสำหรับข้อความพุช Solitics ก็จำเป็นต้องได้รับแจ้งเช่นกัน สำหรับสิ่งนี้ ให้ส่งคำขอ HTTP ต่อไปนี้:

**เมธอด HTTP:** POST

**Endpoint:** `https://api.solitics.com/rest/subscribers/register/app`

**เนื้อหาของคำขอ (Request body)**

```json
{
 "memberId": "1234567",
 "email": "abcd@solitics.com",
 "token": "GH2TKoXXXXXXXEj1111",
 "key": "1234567”
}
```

**พารามิเตอร์ของเนื้อหา (Body parameters)**

| พารามิเตอร์ | คำอธิบาย                                                                                          |
| ---------- | ------------------------------------------------------------------------------------------------- |
| memberID   | นี่คือตัวระบุที่ไม่ซ้ำกันของผู้ใช้ใน Solitics (เช่น CRM ID)                                         |
| email      | อีเมลของสมาชิกที่ใช้สำหรับการยืนยันตัวตนแบบสองปัจจัย                                              |
| token      | โทเค็นที่ Solitics ให้มาเพื่อเข้าถึง push API                                                     |
| key        | คีย์การลงทะเบียนพุชของสมาชิกควรตรงกับ User ID ที่ใช้สำหรับการลงทะเบียนกับ Pushwoosh                 |

แม้ว่า Solitics จะแนะนำให้ใช้ member ID เป็นคีย์ แต่อาจมีข้อยกเว้น ตัวอย่างเช่น หากมีการใช้แอปพลิเคชันหลายตัวใน Pushwoosh ควรมีการกำหนดคีย์ที่แตกต่างกันให้กับผู้ใช้สำหรับแต่ละแอปพลิเคชัน

## การทดสอบการผสานรวม

เมื่อคุณทำกระบวนการตั้งค่าเสร็จสิ้นแล้ว สิ่งสำคัญคือต้องทำการทดสอบเพื่อให้แน่ใจว่าการผสานรวมทำงานได้ตามที่คาดไว้ ทำตามขั้นตอนเหล่านี้เพื่อทำการทดสอบ:

1.  สร้าง Push Promotion ใน Solitics และบันทึก

2.  เข้าสู่ระบบแอปหรือเว็บไซต์ของคุณ เข้าถึงแอปหรือเว็บไซต์ที่คุณคาดว่าข้อความพุชจะปรากฏขึ้น ตรวจสอบให้แน่ใจว่าคุณเข้าสู่ระบบบัญชีผู้ใช้ที่ได้ลงทะเบียนสำหรับ push notifications ไว้ก่อนหน้านี้ทั้งใน Solitics และ Pushwoosh

หากคุณไม่แน่ใจเกี่ยวกับสถานะการลงทะเบียน โปรดติดต่อ Solitics ที่ [support@solitics.com](mailto:support@solitics.com) เพื่อยืนยัน รวมถึงรายละเอียดเกี่ยวกับสถานะการลงทะเบียนของผู้ใช้และ User ID ที่เกี่ยวข้อง

3.  เริ่มการทดสอบ ในโปรโมชันของ Solitics คลิกปุ่ม Test ป้อนอีเมล หมายเลขโทรศัพท์ หรือ member ID ของผู้สมัครสมาชิก (ผู้รับข้อความพุชที่ต้องการ) คลิก Send

หากการกำหนดค่าทั้งหมดถูกต้อง ข้อความพุชควรจะปรากฏขึ้น