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

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

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

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

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

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

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

Назначение: Данные отправляются из Amplitude в Pushwoosh.

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

Чтобы настроить интеграцию Event Streaming и Cohort Sync из Amplitude в Pushwoosh, убедитесь, что выполнены следующие предварительные требования:

• У вас должен быть активный аккаунт Pushwoosh.
• Сгенерируйте API Access Token в Pushwoosh для отправки данных.
• Найдите ваш код приложения Pushwoosh перед настройкой интеграции.
• Эта интеграция доступна только для клиентов Amplitude с платными тарифами.
• Для использования этой интеграции у вас должен быть платный тарифный план Pushwoosh.

Глоссарий (сопоставление названий сущностей, если они отличаются)

Когорты (Cohorts) в Amplitude = Сегменты (Segments) в Pushwoosh

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

• События (Events)
• Теги (Tags)
• Сегменты (Segments)

Как работает интеграция?

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

Передача данных

• События (Events): Amplitude отправляет данные о событиях в Pushwoosh. Каждое событие содержит идентификатор пользователя (external_id), код приложения (app_id), название события (event_name), временную метку (created_at) и свойства события (properties).

  • Платформу Pushwoosh берет из properties.platform (iOS, Android или Web). Событие без этого свойства записывается как событие iOS.
  • Идентификатор устройства Pushwoosh берет из properties.device_id. Если его нет, в качестве идентификатора устройства используется идентификатор пользователя.
  • Принимаются значения свойств любого типа; они сохраняются как атрибуты события. Числа и логические значения сохраняются в виде текста, пустые значения (null) пропускаются.
  • Новое событие создается в Pushwoosh автоматически при первом получении. Типы его атрибутов определяются по значениям: дата, целое число, логическое значение, цена или строка. Когда у существующего события появляется новое свойство, Pushwoosh автоматически добавляет его как атрибут — до 100 атрибутов на событие. Тип таких атрибутов определяется только по тексту: дата, версия или строка, поэтому числовое свойство, добавленное позже, становится строковым атрибутом.

• Теги (Tags): Pushwoosh получает свойства пользователя и сохраняет их как теги пользователя. Каждый запрос содержит идентификатор пользователя (external_id, обязательный), код приложения (app_id) и свойства пользователя (properties).

  • Недостающие теги создаются автоматически; их тип определяется по значению так же, как для атрибутов событий.
  • Свойства, названные так же, как теги Pushwoosh по умолчанию, например Language, Country или Timezone, игнорируются.

• Сегменты (Segments): Для каждой синхронизированной когорты Pushwoosh создает сегмент с названием когорты. Принадлежность к когорте хранится как значение списочного тега CSV import у пользователя, а пользователи сопоставляются по User ID. Пользователи добавляются в сегмент или удаляются из него по мере того, как Amplitude синхронизирует когорту.

Поток данных

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

• Сегменты: Сегменты создаются в Pushwoosh, когда Amplitude делает запрос. Pushwoosh генерирует уникальный идентификатор для каждого сегмента, который Amplitude использует для управления сегментом путем добавления или удаления пользователей.

Запросы

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

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

Отслеживание событий

Отслеживайте действия и взаимодействия пользователей из Amplitude и отправляйте эти события в Pushwoosh для запуска уведомлений или обновлений.

Тегирование пользователей

Присваивайте теги пользователям на основе их поведения или атрибутов в Amplitude. Эти теги можно использовать в Pushwoosh для целевых сообщений или сегментации.

Управление сегментами

Создавайте и управляйте сегментами пользователей в Pushwoosh на основе данных и сегментов, настроенных в Amplitude. Это помогает нацеливать персонализированные сообщения на определенные группы пользователей.

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

Автоматически добавляйте или удаляйте пользователей из сегментов на основе их действий или атрибутов в Amplitude, обеспечивая актуальность сегментации в Pushwoosh.

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

Синхронизация когорт (Cohort sync)

Настройка в Pushwoosh

1. В Pushwoosh создайте или скопируйте Токен доступа API в разделе Settings > API Access.
2. Скопируйте код приложения приложения, в которое нужно синхронизировать когорты.

Настройка в Amplitude

Чтобы настроить Amplitude для интеграции, выполните следующие шаги:

1. В Amplitude в разделе Data перейдите в Catalog и выберите Destinations.
2. В разделе Cohort найдите и нажмите Pushwoosh.

3. Нажмите Add another destination.

4. Укажите имя и вставьте токен доступа API, скопированный из Pushwoosh.

5. Сопоставьте поле User ID в Amplitude с полем User ID в Pushwoosh. Pushwoosh сопоставляет участников когорты по User ID, поэтому выбранное поле Amplitude должно содержать то же значение, которое ваше приложение устанавливает в качестве User ID в Pushwoosh. На странице настройки Amplitude указано, что поле должно содержать адрес электронной почты. Если ваше приложение устанавливает в качестве User ID в Pushwoosh другое значение, участники когорты не сопоставляются. В этом случае установите email пользователя в качестве User ID в Pushwoosh SDK или обратитесь в службу поддержки Pushwoosh.
6. По завершении сохраните настройки.

Отправка когорты

Чтобы синхронизировать вашу первую когорту, выполните следующие шаги:

1. В Amplitude откройте когорту, которую вы хотите синхронизировать, затем нажмите Sync.

2. Выберите Pushwoosh и выберите аккаунт, с которым вы хотите синхронизироваться. Затем нажмите Next.

3. Определите частоту синхронизации и сохраните конфигурации.

Потоковая передача событий (Event streaming)

Настройка в Pushwoosh

1. Создайте или скопируйте Токен доступа API в разделе Settings > API Access.

2. Скопируйте код приложения вашего приложения.

Настройка в Amplitude

1. В Amplitude перейдите в Data Destinations и найдите Pushwoosh - Event Stream.

2. Введите имя для синхронизации и нажмите Create Sync.

3. Измените статус с Disabled на Enabled и вставьте ваш токен доступа API и код приложения из Pushwoosh.

4. В левом выпадающем списке выберите свойство пользователя Amplitude, которое соответствует вашему UserID в Pushwoosh.
5. (Опционально) Включите переключатель Create & Update users, если вы хотите отправлять пользователей и их свойства в реальном времени, когда Amplitude создает или обновляет свойство пользователя.

6. Включите Send Events (“Events are sent to Pushwoosh”), если вы хотите передавать события в Pushwoosh. Это автоматически перенаправит события в Pushwoosh по мере их поступления в Amplitude. События не отправляются по расписанию или по запросу с помощью этой интеграции.

8. Затем выберите, какие события вы хотите отправлять, в разделе Select and Filter Events. Выбирайте только те события, которые вам нужны в Pushwoosh; преобразованные события не поддерживаются.
9. После завершения включите назначение и нажмите Save.

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

Чтобы убедиться, что интеграция Amplitude и Pushwoosh функционирует правильно, вы можете использовать следующие методы:

Мониторинг панели управления Pushwoosh

• События и теги: Проверьте панель управления Pushwoosh, чтобы увидеть, появляются ли события и теги, отправленные из Amplitude, как ожидалось. Ищите недавние действия или обновления, связанные с вашими событиями и тегами.
• Сегменты: Убедитесь, что сегменты создаются, обновляются или изменяются на основе данных из Amplitude. Убедитесь, что количество пользователей и членство в сегментах отражают ожидаемые изменения.

Проверка ответов API

• Успешные ответы: Убедитесь, что вы получаете ответы 200 OK от конечных точек API Pushwoosh. Хотя тело ответа может не всегда присутствовать, статус 200 OK указывает на то, что запрос был успешно получен.
• Ответы об ошибках: Если что-то не работает, проанализируйте коды состояния, отличные от 200 OK:
  • 400 Bad Request: тело запроса не является корректным JSON или отсутствует идентификатор пользователя.
  • 401 Unauthorized: токен API или код приложения отсутствует или недействителен, либо токен принадлежит другому аккаунту.
  • 503 Service Unavailable: Pushwoosh временно не может обработать событие. Запрос можно повторить.
  • Другие коды 5xx: внутренняя ошибка при проверке токена API, сохранении тегов, создании сегмента или обновлении состава когорты. Повторите запрос позже.
• События, которые Pushwoosh отклоняет из-за их содержимого, получают 200 OK и не обрабатываются, поэтому сам по себе ответ 200 OK не подтверждает, что событие записано.

Логирование запросов и ответов

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

Тестирование с использованием образцов данных

• Отправка тестовых событий/тегов: Создайте и отправьте тестовые события и теги из Amplitude в Pushwoosh. Убедитесь, что эти тестовые записи правильно отображаются в Pushwoosh и вызывают ожидаемое поведение.
• Симуляция действий пользователя: Выполните действия в Amplitude, которые должны вызывать определенные события или обновления в Pushwoosh. Проверьте, приводят ли эти действия к ожидаемым изменениям в Pushwoosh.

Использование инструментов мониторинга

• Мониторинг интеграции: Используйте инструменты или сервисы мониторинга, которые могут отслеживать состояние и производительность интеграции. Эти инструменты могут оповещать вас о проблемах или сбоях в реальном времени.
• Аналитика и отчетность: Используйте функции аналитики в Amplitude и Pushwoosh для анализа потока данных и производительности интеграции.

Просмотр документации по интеграции

• Проверка конфигурации: Дважды проверьте конфигурацию интеграции как в Amplitude, так и в Pushwoosh, чтобы убедиться, что все настройки и сопоставления применены правильно.
• Обновления документации: Следите за любыми изменениями или обновлениями в документации по интеграции, которые могут повлиять на функциональность.

Обращение в службу поддержки

Если вы сталкиваетесь с постоянными проблемами или несоответствиями, обратитесь за помощью в службы поддержки Amplitude или Pushwoosh. Предоставьте им подробную информацию о настройке интеграции и любые логи ошибок для более быстрого решения проблемы.

Устранение неполадок

Проблемы с интеграцией

• Событие не появляется в Pushwoosh: Убедитесь, что событие правильно сопоставлено, и проверьте, что код приложения Pushwoosh и токен API настроены правильно.

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

Проблемы с сегментами

• Сегмент не создан: Проверьте, что запрос на создание сегмента отформатирован правильно и что токен API Pushwoosh действителен.

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

Проблемы с ответами

• Отсутствует тело ответа: Ответ 200 OK не содержит тела. Он не подтверждает, что событие записано, поскольку события, отклоненные из-за содержимого, тоже получают 200 OK (см. Проверка ответов API). Проверьте событие в Pushwoosh, как описано в разделе Мониторинг панели управления Pushwoosh.

FAQ

Что делать, если я получаю ошибку 400 Bad Request?

Pushwoosh возвращает 400, если тело запроса не является корректным JSON или отсутствует идентификатор пользователя (external_id). Проверьте, что сопоставление User ID в Amplitude указывает на свойство, заполненное у каждого пользователя.

Как я могу проверить, работает ли интеграция?

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

Могу ли я настраивать события или теги, отправляемые в Pushwoosh?

Да, вы можете настраивать события и теги в конфигурации Amplitude. Убедитесь, что данные соответствуют ожидаемому формату Pushwoosh.

Как часто синхронизируются данные между Amplitude и Pushwoosh?

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

Где я могу найти дополнительную информацию или поддержку по этой интеграции?

Обратитесь к официальной документации Amplitude и Pushwoosh. За дополнительной помощью свяжитесь с соответствующими командами поддержки.