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

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

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

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

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

1. Интегрируйте Pushwoosh SDK
2. Настройте платформы в Pushwoosh
3. Настройте интеграцию в Mixpanel

1. Интегрируйте Pushwoosh SDK

Примечание

Пропустите этот шаг, если вы уже интегрировали Pushwoosh SDK в свое приложение или на сайт.

Сначала интегрируйте Pushwoosh SDK в ваш мобильный или веб-проект:

• Настройка Pushwoosh iOS SDK
• Интеграция Pushwoosh Android SDK
• Web Push SDK 3.0

2. Настройте платформы в Pushwoosh

Примечание

Пропустите этот шаг, если вы уже настроили платформы для своего проекта.

Настройте платформы для отправки сообщений через Pushwoosh, следуя инструкциям в руководствах:

• Настройка iOS
• Настройка Android
• Настройка Chrome и Firefox

3. Настройте Pushwoosh для Mixpanel

Получите учетные данные вашего проекта Pushwoosh

Для настройки интеграции вам понадобятся код приложения (app code) и токен доступа API (API access token) проекта Pushwoosh.

Код приложения

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

Токен аутентификации

Перейдите в Настройки -> Доступ к API и скопируйте токен аутентификации API, применимый к выбранному вами проекту.

Настройте интеграцию с Pushwoosh в Mixpanel

1. Войдите в Mixpanel.
2. Перейдите в Data Management -> Integrations -> Pushwoosh.
3. Нажмите Connect.
4. В открывшемся окне задайте имя коннектора (Connector name), затем вставьте токен доступа API (API Access Token) и код приложения (App Code) Pushwoosh, которые вы скопировали на предыдущем шаге.

5. Чтобы сопоставить пользователя Mixpanel с пользователем Pushwoosh, установите свойство профиля пользователя $pushwoosh_user_id, используя UserID или HWID, полученные из Pushwoosh. Для получения дополнительной информации обратитесь к документации Mixpanel.

   Если у участника когорты нет Pushwoosh User ID, Pushwoosh использует вместо него distinct ID участника в Mixpanel. Участники без обоих идентификаторов пропускаются.

4. Протестируйте интеграцию

Чтобы экспортировать когорты (cohorts) Mixpanel в ваш аккаунт Pushwoosh:

1. Откройте ваши когорты: Data Management -> Cohorts.
2. Найдите когорту, которую вы хотите экспортировать. Нажмите кнопку «…» рядом с когортой, которую вы хотите экспортировать. В открывшемся контекстном меню выберите Export to -> Pushwoosh.
3. Затем укажите, должна ли когорта быть отправлена в Pushwoosh однократно или синхронизироваться динамически с заданными интервалами, обновляя сегмент Pushwoosh до самого актуального набора пользователей из Mixpanel.
4. После завершения настройки экспортированная вами когорта появится в разделе Сегменты (Фильтры) вашей панели управления Pushwoosh под именем Mixpanel_<cohort name>.

Как когорты отображаются в Pushwoosh

Pushwoosh создает по одному сегменту для каждой экспортируемой когорты и синхронизирует его следующим образом:

• Pushwoosh создает сегмент с именем Mixpanel_<cohort name>, когда впервые получает участников когорты, которых удается сопоставить. Если ни у одного из участников в синхронизации нет Pushwoosh User ID или distinct ID в Mixpanel, сегмент не создается.
• Принадлежность к когорте хранится в виде ID когорты в теге CSV import каждого сопоставленного пользователя. Для когорт Mixpanel это тег типа List, который может содержать несколько ID когорт. Сегмент выбирает пользователей, у которых тег CSV import содержит этот ID.
• При динамической синхронизации Mixpanel отправляет пользователей, которые вошли в когорту или вышли из нее, и Pushwoosh соответственно добавляет или удаляет ID когорты.
• Разовый экспорт (полная синхронизация) только добавляет пользователей. Если вы снова экспортируете когорту, пользователи, которые за это время вышли из нее, остаются в сегменте Pushwoosh. Чтобы сегмент оставался актуальным, выберите синхронизироваться динамически на шаге 3 раздела Протестируйте интеграцию.
• Pushwoosh находит сегмент по имени. Если вы переименуете когорту в Mixpanel, следующая синхронизация создаст новый сегмент Mixpanel_<new name>, а старый останется в Pushwoosh. Если старый сегмент вам не нужен, удалите его вручную. См. раздел Удалить сегмент. Удаление сегмента приостанавливает journeys, которые его используют, и отменяет запланированные для него сообщения.