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

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

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

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

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

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

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

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

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

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

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

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

Cohorts в Amplitude = Segments в Pushwoosh

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

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

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

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

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

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

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

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

Поток данных

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

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

Запросы

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

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

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

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

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

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

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

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

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

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

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

Синхронизация когорт

Настройка в Pushwoosh

1. В Pushwoosh перейдите в Settings > Integrations.

2. Нажмите Add Integration, затем найдите и добавьте Amplitude.

   

3. Скопируйте API Key и App Code из Pushwoosh в буфер обмена.

Настройка в Amplitude

Чтобы настроить 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. Определите частоту синхронизации и сохраните конфигурации.

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

Настройка в Pushwoosh

1. Получите ваш Pushwoosh API Key.

2. Найдите App Code в вашем аккаунте Pushwoosh.

Настройка в Amplitude

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

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

3. Измените Status с Disabled на Enabled и вставьте ваш Pushwoosh API Access Token и App Code.

4. В левом выпадающем списке выберите свойство пользователя Amplitude, которое соответствует вашему Pushwoosh UserID.
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, 401 Unauthorized или 500 Internal Server Error.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

FAQ

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

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

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

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

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

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

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

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

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

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