Интеграция с 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, для изменения содержания ваших пуш-уведомлений, сообщений в приложении и электронных писем. Это позволит вам настроить релевантные и высококонверсионные коммуникации.

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

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

Обзор интеграции

Тип интеграции

• Destination: Данные отправляются из Segment в Pushwoosh.
• Source: Данные отправляются из Pushwoosh в Segment.

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

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

Синхронизируемые сущности

Source

• Push Statistics

Destination

• Devices
• Tags

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

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

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

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

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

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

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

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

Примечание

Перед настройкой интеграции с Segment убедитесь, что вы интегрировали Pushwoosh SDK.

Настройка Destination

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 и персонализировать ваши пуш-уведомления, сообщения в приложении и электронные письма.

Настройка Source

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

Примечание

Имя используется как метка в приложении Segment, и Segment создает соответствующее имя схемы в вашем хранилище. Имя может быть любым, но Pushwoosh рекомендует использовать что-то, что отражает сам источник и различает ваши среды (например: Pushwoosh_Prod, Pushwoosh_Staging, Pushwoosh_Dev).

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

Stream

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

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

Events

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

Название события	Описание
Email Sent	Электронное письмо успешно отправлено
Push Sent	Пуш-уведомление успешно отправлено
SMS Sent	SMS отправлено получателю
Push Opened	Пуш-уведомление было открыто
Email Opened	Электронное письмо было открыто
Email Delivered	Электронное письмо успешно доставлено
Push Delivered	Пуш-уведомление успешно доставлено
SMS Delivered	SMS успешно доставлено
SMS Not Delivered	Доставка SMS не удалась
Email Bounced	Электронное письмо возвращено отправителю из-за постоянной ошибки
Email Unsubscribed	Была нажата ссылка отписки в электронном письме

Свойства событий

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

Название свойства	Описание
message_type	Содержит тип сообщения (Push, Email, In-App или SMS)
campaign_code	Уникальный идентификатор кампании сообщения
device_type	Тип устройства

Добавление Destinations

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

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

Если возникли проблемы с тем, как события поступают в 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 для дальнейшей обработки и анализа.

Как узнать, что интеграция работает?

Destination

track-user

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

post-event

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

delete-user

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

Source

Используйте отладчик Source, чтобы обнаружить события, которые были отправлены из 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 отслеживаются правильно.

FAQ

Какие типы событий отправляются из Pushwoosh в Segment?

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

Как я могу проверить, что события правильно отправляются в Segment?

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

Что делать, если у меня возникли проблемы с интеграцией?

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

Как обрабатывается информация о пользователе и устройстве в интеграции?

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

Где я могу найти подробную документацию по интеграции?

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