# Solitics 集成

<Aside type="caution" icon="setting" title="需要开发人员协助">
 您需要开发团队的帮助来设置集成。请与他们分享本指南。
</Aside>

[Solitics](https://solitics.com/) 是一个先进的数据管理和实时营销自动化平台，使 B2C 品牌能够为其客户提供高度个性化的体验。通过利用客户数据，企业可以通过提高转化率和留存率来增加收入，同时显著降低开发和 IT 费用。

当与 Pushwoosh 结合使用时，Solitics 的数据管理功能使品牌能够向其用户提供高度定向和相关的消息。这确保用户收到的内容和优惠是专门根据他们的兴趣和需求量身定制的，从而增强他们的整体体验。

品牌还可以使用 Solitics 来分析用户数据，并识别用户旅程中需要改进的领域。通过将这些数据与 Pushwoosh 集成，品牌可以发送推送通知来重新吸引可能已放弃其旅程的用户，将他们引导回应用程序或网站，并最终提高转化率。

## 用例

以下是一些实际用例，展示了如何利用 Solitics 和 Pushwoosh 的集成来改善客户体验并推动业务成果：

### 个性化促销和优惠

企业可以使用 Solitics 的数据来分析客户的偏好和行为。然后，他们可以通过 Pushwoosh 发送定制的推送通知，根据个人兴趣提供量身定制的促销和优惠。

### 提升参与度

游戏企业可以配置 Solitics 来监控玩家的行动和成就，然后利用 Pushwoosh 及时向玩家发送里程碑和特殊事件的推送通知，鼓励他们积极参与特定的游戏内活动。

### 安全警报

借助 Solitics + Pushwoosh 集成，银行应用程序可以让客户对其数据安全充满信心。他们可以配置 Solitics 来监控账户活动，并针对异常行为触发警报。然后，他们可以使用 Pushwoosh 发送实时推送通知，通知受影响的客户，鼓励他们迅速采取行动保护账户并防止潜在问题。

## 设置集成

集成过程包括两个主要步骤：

1. 将 Pushwoosh SDK 整合到您的网站或移动应用程序中。
2. 建立一个用户 ID，作为 Solitics 和 Pushwoosh 的唯一标识符。

### 先决条件

1. Pushwoosh 账户
2. [Pushwoosh API Access token](/zh/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 中使用相同的成员 ID 注册每个用户。这是集成有效运作的主要要求。
</Aside>

### 为集成配置 Pushwoosh

1. 如果您还没有 Pushwoosh 账户，请先设置一个。
2. 配置您的项目。[了解更多关于如何操作的信息。](/zh/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 团队将为您提供一个访问令牌，用于未来与 Solitics API 的交互。

## 用户注册

如前所述，在 Solitics 和 Pushwoosh 中使用相同的用户 ID 注册用户非常重要。

<Aside type="note">
在注册推送通知时，请使用您的品牌用于成员集成的相同唯一成员 ID。这种一致性不仅能确保您的成员 ID 是唯一的，还能简化跟踪并在出现任何问题时方便调试。
</Aside>

### 在 Pushwoosh 中注册

Pushwoosh 提供了两种将用户 ID 与特定设备关联的方法。如果您不使用这些方法，Pushwoosh 将自动使用设备硬件 ID 作为用户的标识符。

要将用户 ID 链接到 Pushwoosh 中的设备，您可以选择以下方法之一：

#### `setUserId`

这是一个 SDK 函数，允许您将字符串值设置为 Pushwoosh ID，该 ID 将自动与 Pushwoosh 用于识别设备的硬件 ID (HWID) 匹配。

**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 方法

此方法允许您从后端远程将用户 ID 分配给特定的 HWID。

有关使用此 API 调用的详细信息，请参见[此处](/zh/developer/api-reference/user-centric-api#registeruser)。

### 在 Solitics 中注册

当用户注册推送消息时，也需要通知 Solitics。为此，请发出以下 HTTP 请求：

**HTTP 方法：** POST

**端点：** `https://api.solitics.com/rest/subscribers/register/app`

**请求正文**

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

**正文参数**

| 参数     | 描述                                                                                      |
| ---------- | ----------------------------------------------------------------------------------------- |
| memberID   | 这代表用户在 Solitics 中的唯一标识符（例如 CRM ID）                                       |
| email      | 用于双因素身份验证的成员电子邮件                                                          |
| token      | 由 Solitics 提供的用于访问推送 API 的令牌。                                               |
| key        | 成员的推送注册密钥应与用于在 Pushwoosh 注册的用户 ID 相匹配。                             |

虽然 Solitics 建议使用成员 ID 作为密钥，但也可能存在例外情况。例如，如果在 Pushwoosh 中使用了多个应用程序，则应为每个应用程序为用户分配不同的密钥。

## 集成测试

完成设置过程后，进行测试以确保集成按预期运行至关重要。请按照以下步骤进行测试：

1. 在 Solitics 中创建一个推送促销并保存。

2. 登录您的应用程序或网站。访问您期望推送消息出现的应用程序或网站。确保您登录的用户账户已在 Solitics 和 Pushwoosh 中注册了推送通知。

如果您不确定注册状态，请随时联系 Solitics ([support@solitics.com](mailto:support@solitics.com)) 进行确认，并提供有关用户注册状态和相关用户 ID 的详细信息。

3. 启动测试。在 Solitics 促销中，单击“测试”按钮。输入订阅者（推送消息的预期接收者）的电子邮件、电话号码或成员 ID。单击“发送”。

如果所有配置都正确，推送消息应该会出现。