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

Segment — это платформа клиентских данных, которая упрощает сбор данных о пользователях и помогает эффективно их использовать. Если вы храните данные о своих клиентах в Segment, вы можете настроить интеграцию с Pushwoosh всего за несколько кликов.

После настройки интеграции Segment будет отправлять в Pushwoosh следующие данные:

• Атрибуты пользователя: имя, устройство, предпочтения, местоположение, поведение и т. д. Pushwoosh сохранит эти данные в виде Тегов и их значений для каждого пользователя.
• События: каждое Событие из Segment будет передано в Pushwoosh и сохранено как Событие Pushwoosh с тем же названием. Pushwoosh также будет получать информацию о том, какие события инициировал каждый пользователь.

Используя данные из Segment, вы можете выстраивать бесшовные коммуникации с вашей аудиторией в Pushwoosh. Ниже приведены два примера использования возможностей обеих платформ:

1. Создавайте целевые кампании на основе данных о поведении пользователей. Используйте данные о Событиях из Segment для создания точных пользовательских сегментов в Pushwoosh на основе определенного поведения пользователей.

Например, Segment отправляет в Pushwoosh данные о Событии SubscribedToOffers. Вы можете создать в Pushwoosh сегмент пользователей, которые подписались на специальные предложения:

Затем вы можете создавать увлекательные Customer Journeys с промо-сообщениями и скидками для пользователей, подписавшихся на ваши предложения:

2. Персонализируйте сообщения на основе атрибутов пользователей из Segment. Вы можете использовать атрибуты пользователей, полученные из Segment, для изменения содержания ваших пуш-уведомлений, In-App сообщений и email. Это позволит вам настраивать релевантные и высококонверсионные коммуникации.

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

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

• Destination (Назначение): Данные отправляются из Segment в Pushwoosh.
• Source (Источник): Данные отправляются из Pushwoosh в Segment.

Платные аккаунты в Pushwoosh и Segment.

Source (Источник)

• Статистика по пушам

Destination (Назначение)

• Устройства
• Теги

Отслеживание уведомлений

Отправляйте пуш-уведомления и отслеживайте их статус, включая успешную отправку и доставку.

Анализ событий

Анализируйте события, инициированные пользователями, такие как доставка пуш-уведомлений или email, и убедитесь, что эти события точно записываются в Segment.

Управление пользователями

Регистрируйте и управляйте информацией о пользователях, включая добавление релевантных атрибутов с помощью тегов или удаление пользователей при необходимости.

1. В интерфейсе Segment перейдите в Connections → Destinations и нажмите Add Destination.

2. Найдите Pushwoosh и выберите его.

3. Выберите Источники (Sources), которые вы хотите подключить к Назначению (Destination).

4. Перейдите к настройкам Назначения (Destination):

5. Введите API-ключ Pushwoosh и код приложения. Убедитесь, что переключатель Enable Destination включен. После этого нажмите Save Changes.

Где найти API-ключ и код приложения?

Вы можете найти API-ключ в разделе Settings → API Access:

Код приложения можно найти в верхнем левом углу интерфейса Pushwoosh, прямо под названием проекта:

6. Перейдите на вкладку Mappings и убедитесь, что опции Create or Update User Profile и Track Events включены:

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

Если событие не содержит поле device_platform или это поле некорректно, ваше событие будет проигнорировано. Кроме того, если событие не содержит ни userId, ни deviceId, оно также будет проигнорировано.

Чтобы убедиться, что ваше сопоставление настроено правильно, перейдите в Pushwoosh as Destination > Settings.

Затем выберите вкладку Mapping и нажмите Edit Mapping для метода Track Events.

Далее убедитесь, что сопоставление ваших событий с событиями, отправляемыми в Pushwoosh, корректно, и что поля Device Platform и External User ID (или Device ID) правильно сопоставлены.

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

Если интеграция настроена правильно, Pushwoosh начнет получать События и атрибуты пользователей из Segment. На основе этих данных вы сможете создавать высокотаргетированные Customer Journeys и персонализировать свои пуш-уведомления, In-App сообщения и email.

1. На странице каталога Sources catalog page вашего рабочего пространства нажмите Add Source.
2. Найдите “Pushwoosh” в каталоге источников (Sources Catalog), выберите Pushwoosh и нажмите Add Source.
3. На следующем экране дайте Источнику (Source) имя и настройте другие параметры.

4. Нажмите Add Source, чтобы сохранить настройки.
5. Скопируйте Write key из интерфейса Segment.
6. Войдите в свой аккаунт Pushwoosh и выберите приложение, которое хотите подключить.
7. Перейдите в Settings > 3rd party integration > Segment, нажмите кнопку Configure и введите Write key из вашего рабочего пространства Segment.
8. Перечислите события, которые вы хотите экспортировать, используя , в качестве разделителя в поле Events, или оставьте его пустым, если хотите экспортировать все события, затем нажмите Apply.

Pushwoosh использует компонент Segment stream Source для отправки данных о событиях в Segment. Он использует серверный метод track для отправки данных в Segment. Эти события затем доступны в любом назначении, которое принимает серверные события, и доступны в виде схемы в вашем хранилище данных.

По умолчанию Pushwoosh передает User ID из Pushwoosh как свойство userId в Segment. Если связанного User ID нет, Pushwoosh передаст HWID как anonymousId в Segment.

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

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

Теперь, когда ваш Источник (Source) настроен, вы можете подключить его к Назначениям (Destinations).

Войдите в свои downstream-инструменты и проверьте, что ваши события отображаются как ожидалось и содержат все необходимые свойства. Если ваши события и свойства не отображаются, проверьте доставку событий (Event Delivery) и обратитесь к документации по Назначениям для каждого инструмента для устранения неполадок.

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

1. Инициация пуш-уведомления: Клиент запускает процесс, инициируя пуш-уведомление через интерфейс Pushwoosh.
2. Создание события: Бэкенд Pushwoosh обрабатывает запрос на пуш-уведомление и генерирует событие. Это событие затем отправляется в топик Kafka с названием channels-tracking-log, управляемый Pushwoosh.
3. Потребление события: Сервис интеграции с Segment постоянно прослушивает топик Kafka channels-tracking-log и потребляет события по мере их поступления.
4. Обработка события: Потребленные события обрабатываются сервисом интеграции с Segment, который преобразует их в события Segment Track Events.
5. Передача события: Обработанные события Segment Track Events затем отправляются на бэкенд Segment для дальнейшей обработки и анализа.

Перейдите в ваш аккаунт Pushwoosh > Ваше подключенное приложение > Audience > User Explorer. Найдите вашего пользователя/устройство и проверьте теги, которые отправил Segment.

Перейдите в ваш аккаунт Pushwoosh > Ваше подключенное приложение > Audience > Events. Выберите событие, нажмите на меню с тремя точками и выберите Event Statistics. Убедитесь, что событие посчитано.

Перейдите в ваш аккаунт PW > Ваше подключенное приложение > Audience > User Explorer. Убедитесь, что пользователь/устройство не существует.

Используйте отладчик Источника (Source debugger) для обнаружения событий, которые были отправлены из Pushwoosh в Segment.

Для устранения проблем с интеграцией Pushwoosh начните с проверки следующего:

Destination (Назначение)

• Track-User: Проверьте информацию о пользователе/устройстве и теги в Pushwoosh в разделе Audience > User Explorer.
• Post-Event: Убедитесь, что событие учитывается в Pushwoosh, проверив статистику событий.
• Delete-User: Подтвердите, что пользователь/устройство больше не существует в Pushwoosh.

Source (Источник)

Используйте отладчик источника на Segment Debugger, чтобы проверить, правильно ли отправляются события из Pushwoosh в Segment.

Если события не отображаются корректно в Segment, убедитесь, что события Pushwoosh правильно сопоставлены с событиями Segment Track Events в соответствии с предоставленными правилами сопоставления.

Убедитесь, что в запросах к Pushwoosh и Segment используются правильные токены аутентификации или API-ключи.

Подтвердите, что поток данных между Pushwoosh и Segment не прерывается и что топики Kafka отслеживаются правильно.

В Segment отправляются зарезервированные события, такие как Push Sent, Email Sent, SMS Sent, Push Delivered, Email Delivered, SMS Delivered и Email Bounced.

Используйте отладчик источника Segment для проверки событий, отправленных из Pushwoosh, и просмотрите статистику событий в своем аккаунте Pushwoosh, чтобы убедиться, что они правильно подсчитываются.

Проверьте статус интеграции, убедившись в правильности информации о пользователе/устройстве, количестве событий и удалениях пользователей в Pushwoosh. Кроме того, убедитесь, что используются правильные токены аутентификации и что поток данных не прерывается.

Информация о пользователях и устройствах, включая атрибуты и теги, регистрируется или обновляется в Pushwoosh на основе запросов от Segment. Обратите внимание, что теги по умолчанию не создаются в Pushwoosh автоматически.

Подробная документация доступна в руководствах по интеграции Segment и Pushwoosh, а также в их соответствующей документации по API.