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

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

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

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

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

• У вас должна быть активная учетная запись Pushwoosh.
• Чтобы отправлять данные, сгенерируйте API Access Token в Pushwoosh.
• Перед настройкой интеграции найдите код вашего приложения (App Code) в Pushwoosh.
• Эта интеграция доступна только клиентам Amplitude с платными тарифными планами.
• Для использования этой интеграции у вас должен быть платный тарифный план Pushwoosh.

Cohorts в Amplitude = Segments в Pushwoosh

• События
• Теги
• Сегменты

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

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

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

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

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

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

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

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

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

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

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

1. В Pushwoosh перейдите в Настройки > Интеграции.

2. Нажмите Добавить интеграцию, затем найдите и добавьте Amplitude.

   

3. Скопируйте API-ключ (API Key) и код приложения (App Code) из Pushwoosh в буфер обмена.

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

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

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

4. Введите название и вставьте API-ключ, который вы скопировали из Pushwoosh.

5. Сопоставьте поле Amplitude User ID с полем Pushwoosh User ID.
6. По завершении сохраните настройки.

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

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

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

3. Выберите периодичность синхронизации и сохраните конфигурацию.

1. Получите ваш API-ключ Pushwoosh.

2. Найдите код приложения (App Code) в вашей учетной записи Pushwoosh.

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

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

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

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

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

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

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

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

• Успешные ответы: Убедитесь, что вы получаете ответы 200 OK от конечных точек API Pushwoosh. Хотя тело ответа может отсутствовать, статус 200 OK указывает на то, что запрос был успешно получен.
• Ответы об ошибках: Проанализируйте любые ответы об ошибках или коды состояния, отличные от 200 OK, чтобы выявить возможные проблемы. Распространенные ошибки могут включать 400 Bad Request, 401 Unauthorized или 500 Internal Server Error.

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

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

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

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

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

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

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

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

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

• Отсутствует тело ответа: Если вы получили ответ 200 OK, но тело ответа пустое, проверьте, был ли запрос правильно отформатирован и были ли данные отправлены корректно.

Проверьте полезную нагрузку (payload) запроса на наличие ошибок форматирования или отсутствующих полей. Убедитесь, что все обязательные поля включены и правильно отформатированы.

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

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

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

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