Интеграция с Piano Analytics

Piano Analytics — это инструмент, который помогает компаниям понять, как люди взаимодействуют с их сайтами и приложениями. Он собирает данные о поведении пользователей и предоставляет инсайты в виде отчетов и визуализаций. Эта информация помогает компаниям принимать более обоснованные решения по улучшению своих цифровых продуктов и маркетинговых активностей.

Интеграция Piano Analytics и Pushwoosh позволяет получать подробную информацию о поведении пользователей для создания точных сегментов и отправки узкоцелевых push-уведомлений, email-сообщений и in-app сообщений нужным пользователям в нужное время.

• Получатель: Данные отправляются из Piano Analytics в Pushwoosh.
• Источник: Данные отправляются из Pushwoosh в Piano Analytics.

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

При интеграции Pushwoosh и Piano Analytics названия некоторых сущностей могут различаться на двух платформах. Ниже приведено соответствие между Pushwoosh и Piano Analytics:

Источник

• События
• Статистика по push-уведомлениям
• Теги (в качестве атрибутов событий)

Получатель

• Сегменты

Единая аналитика

Объедините данные о вовлеченности из Pushwoosh с данными Piano Analytics для всестороннего анализа пользователей. Это позволит вам получить целостное представление о поведении и взаимодействиях пользователей в разных точках касания.

Сегментация

Создавайте целевые сегменты пользователей в Pushwoosh на основе данных из Piano Analytics. Используйте эту расширенную сегментацию для проведения персонализированных и эффективных маркетинговых кампаний.

Мониторинг эффективности

Отслеживайте эффективность кампаний и взаимодействие с пользователями на разных платформах.

1. Настройка: Настройте параметры интеграции в аккаунтах Pushwoosh и Piano Analytics.
2. Сопоставление событий: Сопоставьте события Pushwoosh с событиями Piano (например, PostEvent.EventName с PianoEvent.Name).
3. Передача данных: Pushwoosh отправляет события (Post Events и Tracking Log Events) в Piano Analytics.
4. Импорт сегментов: Piano Analytics отправляет данные о сегментах в Pushwoosh для сегментации аудитории.

1. Post-события
   • Pushwoosh отправляет данные о событиях в Piano Analytics.
   • Атрибуты сопоставляются следующим образом:
     • UserID (Pushwoosh) -> PushwooshID (Piano)
     • CampaignID (Pushwoosh) -> SrcMedium (Piano)
     • PlatformID (Pushwoosh) -> DeviceType (Piano)
2. События из лога отслеживания:
   • Pushwoosh отправляет данные отслеживания (например, Push Sent, Push Delivered) в Piano Analytics.
   • Эти данные обогащают Piano Analytics метриками доставки и вовлеченности.
3. Интеграция Piano VisitorID:
   • При необходимости интегрируйте Piano VisitorID с Pushwoosh для единой аналитики по всем SDK.

Чтобы настроить интеграцию, перейдите в Настройки > Сторонние интеграции (Settings > 3rd Party Integrations) в вашем аккаунте Pushwoosh и найдите Piano. Нажмите Настроить (Configure).

В открывшемся окне укажите следующие учетные данные:

1. ID сайта

Чтобы найти ID сайта, войдите в свой аккаунт Piano и перейдите в Analytics > Data Collection Portal > Dashboard. Найдите нужный сайт и скопируйте его ID.

2. Домен для сбора данных

Чтобы найти домен для сбора данных, перейдите в Tagging > Collection Domains. Скопируйте ID домена. Убедитесь, что вы вводите домен в формате ****.pa-cd.com без префикса https://.

3. Ключи доступа и секретный ключ API Piano

Чтобы получить ключи:

• В вашем аккаунте Piano нажмите на See profile под именем вашего аккаунта.

• Перейдите на вкладку API Keys и создайте новый ключ с понятным названием и описанием. Затем нажмите OK.

• В открывшемся окне скопируйте ваш ключ доступа (Access Key) и секретный ключ (Secret Key).

• В поле Ключ API (API key) в Pushwoosh введите ключ доступа (Access Key) и секретный ключ (Secret Key), разделив их символом подчеркивания. Например: accesskey_secretkey.

Чтобы отслеживать в Piano события, отправленные из Pushwoosh, вам необходимо вручную создать соответствующие события в Piano.

Вот как это сделать в вашем аккаунте Piano:

1. Перейдите в Settings > Data management > Data model.
2. Выберите Events и нажмите на иконку «плюс», чтобы создать новое событие.
3. В открывшемся окне укажите название и описание события, например, “pw_siteopened”.

4. В поле Type выберите On-site.
5. В поле Categories выберите Events.
6. Нажмите Save.

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

Чтобы изменить часовой пояс в Piano, перейдите в Dashboard и нажмите на строку с информацией о вашем сайте. Во всплывающем окне нажмите Edit и выберите нужный часовой пояс. Затем нажмите Save.

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

Вот как создать свойство:

1. В Piano перейдите в Settings > Data Management > Properties.
2. Нажмите Create Property.
3. В поле Name введите pushwooshid.
4. В поле Property Key введите pushwooshid.
5. Установите Type в значение String.
6. Нажмите Save.

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

1. В вашем аккаунте Piano перейдите в Explorer > Audience > Overall Traffic.
2. Создайте сегмент на основе событий, у которых свойство pushwooshid не является пустым.

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

Для более детального просмотра событий, отправленных из Pushwoosh, перейдите в Content > Events. В этом разделе представлена подробная разбивка всех событий, отправленных из Pushwoosh, включая количество раз, когда каждое событие произошло.

После завершения настройки интеграции вы можете начать анализировать события, отправленные из Pushwoosh, в интерфейсе Piano. Чтобы получить доступ к этим событиям, перейдите в Explorer > Content > Events в вашем аккаунте Piano.

Затем создайте сегменты, используя эти события. При создании сегментов выберите созданное ранее свойство pushwooshid для фильтрации событий.

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

Чтобы Pushwoosh мог получать сегменты из Piano, предоставьте Pushwoosh созданный вами SegmentKey. Чтобы найти SegmentKey для сегмента, перейдите в Analysis > Library > Segments. Нажмите на нужный сегмент и скопируйте Segment Key.

В разделе интеграций Pushwoosh найдите Piano и нажмите Импортировать сегмент (Import Segment). Затем введите скопированный ключ сегмента.

Если импорт пройдет успешно, вы увидите сообщение с подтверждением.

Вы можете получить доступ к импортированным сегментам в Pushwoosh. После завершения импорта они будут перечислены в разделе Аудитория > Сегменты (Audience > Segments) вашего аккаунта Pushwoosh.

Если клиенту необходимо собирать аналитику одновременно из Pushwoosh SDK и Piano Analytics SDK, Pushwoosh должен сопоставить Piano VisitorID с UserID/HWID из Pushwoosh. Решение заключается в отправке тега с Piano VisitorID в Pushwoosh для пользователя/устройства.

Для этого выполните следующие действия:

1. Создайте тег с названием ‘Piano Visitor ID’ на стороне Pushwoosh для вашего приложения. Примечание: название тега должно быть в точности таким, как указано.
2. В клиентском приложении получите Piano Visitor ID с помощью метода getVisitorId из Piano SDK.
3. В клиентском приложении вызовите запрос setTags из Pushwoosh SDK, передав ему значение тега.

Если значение тега (Piano Visitor ID) существует для пользователя/устройства, Pushwoosh автоматически включит его в качестве Client ID в запросы к Piano Analytics. На стороне Piano Analytics это значение будет преобразовано в уникальный ID посетителя.

Pushwoosh.push(function(api) {
// Установить теги для пользователя
api.setTags({
'Piano Visitor ID': pa.getVisitorID(),
});

String value1 = PianoAnalytics.getInstance().visitorId();
TagsBundle pianoTag = new TagsBundle.Builder()
    .putString("Piano Visitor ID", value1)
    .build();
Pushwoosh.getInstance().setTags(pianoTag);

var pianoId: String = pa.getVisitorId(completionHandler: { visitorId in
Pushwoosh.sharedInstance().setTags([
 "Piano Visitor ID": visitorId
 ])
})

__block NSString *pianoId;
[pa getVisitorIdWithCompletionHandler:^(NSString *visitorId) {
    Piano Visitor ID = visitorId;
    [[Pushwoosh sharedInstance] setTags:@{@"Piano Visitor ID": visitorId}];
}];

В целом Pushwoosh использует теги устройств для передачи информации об устройстве и других данных в Piano Analytics с каждым запросом. Вот список часто используемых тегов:

• Страна
• Модель устройства
• Версия ОС
• Тип браузера (в некоторых случаях)

Есть два простых способа обнаружить события, которые были отправлены в Piano Analytics:

1. Войдите в ваш аккаунт Piano Analytics.
2. Перейдите в Settings -> Data Collection Portal -> Tools -> Stream Inspector.
3. Выберите подключенный сайт, который вы хотите проверить.
4. Выберите события, которые вы хотите проверить, и начните сессию.
5. Убедитесь, что события были получены Piano Analytics.

1. Войдите в ваш аккаунт Piano Analytics.
2. Перейдите в Settings -> Explorer -> Audience -> Overall Traffic.
3. Выберите сайт и диапазон дат в меню ниже.

Чтобы проверить интеграцию на стороне получателя:

• Импортируйте сегмент из Piano.
• Вы должны увидеть новый сегмент (фильтр) с названием, сформированным как segment_key (Piano Autogenerated).
• Пересчитайте сегмент, чтобы получить актуальную информацию о текущих устройствах.

Решение: Используйте Stream Inspector или проверьте раздел Overall Traffic в Piano Analytics, чтобы отслеживать входящие события из Pushwoosh.

Решение: Убедитесь, что ключ сегмента (Segment Key) из Piano соответствует настройкам в Pushwoosh. Проверьте, нет ли ошибок при расчете размера сегмента или получении данных.

Решение: Да, настроив специальный тег в Pushwoosh и используя SDK от Piano для получения VisitorID, вы можете синхронизировать ID пользователей между платформами.

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