# Интеграция с 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. Внедрение SDK Pushwoosh в ваш веб-сайт или мобильное приложение.
2. Установка User ID, который служит уникальным идентификатором как для Solitics, так и для Pushwoosh.

### Предварительные требования

1. Аккаунт Pushwoosh
2. [Токен доступа к API Pushwoosh](/ru/developer/api-reference/api-access-token): Чтобы разрешить передачу данных в Pushwoosh, вам необходимо сгенерировать токен доступа к API Pushwoosh. Чтобы получить его, перейдите в **Settings > API Access** и скопируйте его там.
3. Код приложения Pushwoosh: Аналогично, вам нужно будет найти код вашего приложения Pushwoosh для облегчения передачи данных в Pushwoosh. Для этого найдите название проекта в левом верхнем углу и скопируйте код, отображаемый под ним.
4. [Аккаунт Solitics](https://dashboard.solitics.com/#/pages/signin)

<Aside type="note">
Чтобы включить интеграцию, зарегистрируйте каждого пользователя как в Solitics, так и в Pushwoosh, используя один и тот же member ID. Это основное требование для эффективной работы интеграции.
</Aside>

### Настройка Pushwoosh для интеграции

1. Создайте аккаунт Pushwoosh, если у вас его еще нет.
2. Настройте свои проекты. [Узнайте больше о том, как это сделать.](/ru/product/first-steps/start-with-your-project/configure-platforms)
3. Далее создайте приложение в Pushwoosh и выберите предпочтительные каналы коммуникации. Вы можете использовать существующее приложение, если оно у вас уже есть.

### Настройка Solitics для интеграции

1. Свяжитесь с Solitics ([support@solitics.com](mailto:support@solitics.com)) и попросите интегрировать ваш бренд с Pushwoosh.

Укажите следующие данные:

* API-ключ Pushwoosh
* Код приложения Pushwoosh

2. Команда Solitics предоставит вам токен доступа для будущих взаимодействий с API Solitics.

## Регистрация пользователя

Как уже подчеркивалось ранее, важно регистрировать пользователей с одинаковыми User ID как в Solitics, так и в Pushwoosh.

<Aside type="note">
Используйте тот же уникальный member ID, который ваш бренд использует для интеграции участников при регистрации для получения пуш-уведомлений. Эта последовательность не только обеспечит уникальность вашего member ID, но и упростит отслеживание и облегчит отладку в случае возникновения каких-либо проблем.
</Aside>

### Регистрация в Pushwoosh

Pushwoosh предлагает два метода для связывания User ID с конкретным устройством. Если вы не используете эти методы, Pushwoosh автоматически будет использовать аппаратный ID устройства в качестве идентификатора пользователя.

Чтобы связать User ID с устройством в Pushwoosh, вы можете выбрать один из следующих методов:

#### `setUserId`

Это функция SDK, которая позволяет вам установить строковое значение в качестве ID Pushwoosh, которое будет автоматически сопоставлено с 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" />


#### Метод API `registerUser`

Этот метод позволяет вам удаленно присвоить User ID конкретному HWID из вашего бэкенда.

Подробную информацию об использовании этого вызова API можно найти [здесь](/ru/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 для доступа к push API.                                              |
| key        | Ключ регистрации для пуш-уведомлений участника должен совпадать с User ID, использованным при регистрации в Pushwoosh. |

Хотя Solitics рекомендует использовать member ID в качестве ключа, могут быть исключения. Например, если в Pushwoosh используется несколько приложений, пользователю должен быть назначен разный ключ для каждого приложения.

## Тестирование интеграции

После завершения процесса настройки крайне важно провести тест, чтобы убедиться, что интеграция работает так, как ожидалось. Выполните следующие шаги для тестирования:

1. Создайте Push Promotion в Solitics и сохраните.

2. Войдите в свое приложение или на сайт. Зайдите в приложение или на веб-сайт, где вы ожидаете появления пуш-сообщения. Убедитесь, что вы вошли в учетную запись пользователя, который ранее был зарегистрирован для получения пуш-уведомлений как в Solitics, так и в Pushwoosh.

Если вы не уверены в статусе регистрации, свяжитесь с Solitics по адресу [support@solitics.com](mailto:support@solitics.com) для подтверждения, указав информацию о статусе регистрации пользователя и связанном с ним User ID.

3. Начните тест. В акции Solitics нажмите кнопку Test. Введите email, номер телефона или member ID подписчика (предполагаемого получателя пуш-сообщения). Нажмите Send.

Если все настройки верны, пуш-сообщение должно появиться.