Интеграция с Solitics

Требуется помощь разработчика

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

Solitics — это передовая платформа для управления данными и автоматизации маркетинга в реальном времени, которая позволяет B2C-брендам предоставлять своим клиентам высоко персонализированный опыт. Используя данные клиентов, компании могут увеличить доход за счет повышения коэффициентов конверсии и удержания, при этом значительно сокращая расходы на разработку и IT.

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

Бренды также могут использовать Solitics для анализа данных пользователей и выявления областей для улучшения в пути пользователя (user journey). Интегрируя эти данные с Pushwoosh, бренды могут отправлять push-уведомления для повторного вовлечения пользователей, которые могли прервать свой путь, направляя их обратно в приложение или на веб-сайт и, в конечном итоге, повышая коэффициенты конверсии.

Сценарии использования

Ниже приведены некоторые практические сценарии использования, которые демонстрируют, как интеграция Solitics и Pushwoosh может быть использована для улучшения клиентского опыта и достижения бизнес-результатов:

Персонализированные акции и предложения

Компании могут использовать данные Solitics для анализа предпочтений и поведения клиентов. Затем они могут отправлять через Pushwoosh персонализированные push-уведомления с индивидуальными акциями и предложениями, основанными на интересах конкретного человека.

Повышение вовлеченности

Игровые компании могут настроить Solitics для отслеживания действий и достижений игроков, а затем использовать Pushwoosh для оперативной отправки push-уведомлений о достижениях и специальных событиях, поощряя активное участие в конкретных игровых активностях.

Оповещения о безопасности

Банковские приложения могут поддерживать уверенность своих клиентов в безопасности их данных благодаря интеграции Solitics и Pushwoosh. Они могут настроить Solitics для мониторинга активности по счетам и запуска оповещений о необычном поведении. Затем они могут использовать Pushwoosh для доставки push-уведомлений в реальном времени, чтобы уведомить затронутых клиентов, побуждая их к быстрым действиям для защиты своих счетов и предотвращения потенциальных проблем.

Настройка интеграции

Процесс интеграции включает два основных шага:

1. Внедрите Pushwoosh SDK в ваш веб-сайт или мобильное приложение.
2. Установите User ID, который будет служить уникальным идентификатором как для Solitics, так и для Pushwoosh.

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

1. Учетная запись Pushwoosh
2. Токен доступа к API Pushwoosh: Чтобы разрешить передачу данных в Pushwoosh, вам необходимо сгенерировать токен доступа к API Pushwoosh. Чтобы получить его, перейдите в Настройки > Доступ к API и скопируйте его оттуда.
3. Код приложения Pushwoosh: Аналогично, вам нужно будет найти код вашего приложения Pushwoosh для облегчения передачи данных в Pushwoosh. Для этого найдите название проекта в левом верхнем углу и скопируйте код, отображаемый под ним.
4. Учетная запись Solitics

Примечание

Чтобы включить интеграцию, зарегистрируйте каждого пользователя как в Solitics, так и в Pushwoosh, используя один и тот же ID участника. Это основное требование для эффективной работы интеграции.

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

1. Создайте учетную запись Pushwoosh, если у вас ее еще нет.
2. Настройте свои проекты. Узнайте больше о том, как это сделать.
3. Далее создайте приложение в Pushwoosh и выберите предпочтительные каналы связи. Вы можете использовать существующее приложение, если оно у вас уже есть.

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

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

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

• Ключ API Pushwoosh
• Код приложения Pushwoosh

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

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

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

Примечание

Используйте тот же уникальный ID участника, который ваш бренд использует для интеграции участников при регистрации на получение push-уведомлений. Такая последовательность не только обеспечит уникальность вашего ID участника, но и упростит отслеживание и облегчит отладку в случае возникновения каких-либо проблем.

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

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

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

setUserId

Это функция SDK, которая позволяет вам установить строковое значение в качестве ID Pushwoosh, который будет автоматически сопоставлен с аппаратным ID (HWID), используемым Pushwoosh для идентификации устройств.

Android

setUserId – Android

iOS

setUserId – iOS

Метод API registerUser

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

Подробную информацию об использовании этого вызова API можно найти здесь.

Регистрация в Solitics

Когда пользователь регистрируется для получения push-сообщений, Solitics также должен быть проинформирован. Для этого сделайте следующий HTTP-запрос:

Метод HTTP: POST

Эндпоинт: https://api.solitics.com/rest/subscribers/register/app

Тело запроса

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

Параметры тела запроса

Параметр	Описание
memberID	Это уникальный идентификатор пользователя в Solitics (например, CRM ID)
email	Электронная почта участника, которая используется для двухфакторной аутентификации
token	Токен, предоставленный Solitics для получения доступа к push API.
key	Ключ регистрации push-уведомлений участника должен совпадать с User ID, используемым для регистрации в Pushwoosh.

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

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

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

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

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

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

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

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