Настройка Piano Analytics
Piano Analytics — партнёр по аналитике, интегрированный с Adjust. Интеграция с нашей системой позволяет Piano Analytics получать данные, отслеживаемые в Adjust, посредством автоматических колбэков. Обрабатывая эти данные при помощи своих инструментов, партнеры предоставляют вам более подробные сведения и аналитику.
Из этой статьи вы узнаете, как настроить измерение с помощью Piano Analytics для вашего приложения. Речь пойдет об интеграции и выборе данных, которые Adjust может передавать Piano Analytics.
Перед началом работы
Требования
- Доступ к администрированию, редактированию или настраиваемый доступ к редактированию в Adjust.
- Adjust SDK версии 4.0.0 и более поздних версий для сопоставления параметров SDK с параметрами Piano Analytics. Для использования этой функции следуйте приведенным ниже инструкциям.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Учетные данные
Collection Domain и Site ID
- Чтобы узнать, как найти ваши учетные данные, обратитесь к своему представителю Piano Analytics.
В панели управления Piano Analytics:
Прежде чем включить интеграцию Piano Analytics, необходимо создать следующие события в пользовательском интерфейсе Piano Analytics с точными названиями, перечисленными ниже, чтобы обеспечить правильное представление данных:
- adjust.installs
- adjust.uninstalls
- adjust.reinstalls
- adjust.reattributions
Инструкции по созданию этих событий в Piano Analytics можно найти здесь.
Выберите Piano Analytics и свое приложение в Campaign Lab
- В разделе Campaign Lab выберите Партнеры .
- Выберите Новый партнер > Piano Analytics . Выберите Далее , чтобы перейти к следующему экрану.
- На экране Выбор приложения выберите приложение, для которого вы хотите создать ссылку и включите интеграцию, чтобы поделиться данными с Piano Analytics.
- Нажмите Далее .
Включение обмена данными
Включите обмен данными, чтобы активировать интеграцию с Piano Analytics. Чтобы включить обмен данными
- Введите Collection Domain и Site ID.
После включения обмена данными с Piano Analytics, Adjust автоматически отправляет Piano Analytics следующие данные (по умолчанию).
- установка;
- удаление приложения;
- переустановка;
- реатрибуция.
Настройте параметры обмена данными
При работе с мультиплатформенными приложениями с возможностью совместного использования данных для нескольких платформ вы можете:
- Разделить параметры обмена данными на уровне платформы, выбрав Использовать настройки для определенной платформы .
- Установить одинаковые настройки обмена данными для нескольких платформ, выбрав Использовать глобальные настройки .
В разделе К чему будет предоставлен доступ? отметьте действия, которые Adjust будет передавать Piano Analytics по умолчанию:
- установка;
- удаление приложения;
- переустановка;
- реатрибуция.
Отправка дополнительных данных
Выберите объем и тип данных для передачи Piano Analytics посредством колбэков. Piano Analytics может использовать эту информацию для оптимизации производительности.
Для отправки дополнительных данных можно просмотреть и настроить следующие параметры:
Удаления или повторные установки
Передача данных об удалениях и переустановках позволяет Piano Analytics получать данные об удалениях и переустановках вашего приложения, измеренные Adjust.
Для приложений под управлением iOS можно ожидать небольшого количества удалений и/или переустановок. Дополнительные сведения см. в разделе Оценка удалений и переустановок.
Сопоставление параметров
Чтобы делиться настраиваемыми данными с Piano Analytics, обычно требуется сопоставить параметры.
Параметры партнера (доступно в Adjust SDK версии 4.0+) позволяют Adjust собирать настраиваемые наборы данных в вашем приложении и перенаправлять их непосредственно Piano Analytics. Таким образом Piano Analytics будет получать указанные сведения по каждому связанному событию.
Прежде чем добавлять новые параметры партнера в Adjust SDK, убедитесь, что ни один из ранее введенных параметров партнера не соответствует вашим требованиям.
Чтобы передавать Piano Analytics параметры партнера, выполните следующие действия.
Настройте параметры партнера в Adjust SDK.
- Проверьте раздел Начало работы для всех ссылок на платформу разработки SDK.
В разделе Выберите параметры обмена данными нажмите Параметры .
В разделе Сопоставить параметры можно указать способ отправки в сеть параметров партнера, заданных в SDK:
- Выберите Сопоставить параметр .
- В поле Параметр SDK укажите имя параметра SDK, который следует отправить в сеть.
- В поле Параметр партнера укажите параметр сети, соответствующий параметру SDK.
Примечание. Если параметры партнера настроены в Adjust SDK без настройки передачи параметров на панели управления, Adjust будет передавать эти параметры с тем же названием, что и в Adjust SDK.
Включите Piano Analytics для своего приложения
На экране Проверка настройки вы можете просмотреть выбранные варианты. Вы можете вернуться и внести изменения в следующие настройки:
- Выбранное приложение
- Параметры обмена данными
Выберите Включить партнера , чтобы включить Piano Analytics для вашего приложения. Партнеры по аналитике не работают со ссылками для кампаний. После включения наша интеграция передает данные об атрибуции и событиях в приложении посредством автоматических колбэков.
Инструкции по настройке для конкретных партнеров
Piano Analytics требует идентификатор посетителя, чтобы привязать первоначальную установку к последующим событиям в приложении. Для этого вам необходимо отправить идентификатор посетителя Piano Analytics в качестве глобального параметра партнера SDK с точным именем PAVisitorId . Более подробную информацию о назначении глобальных параметров партнера см. в нашей документации:
Пример кода для реализации на Android:
const PAVisitorId = pa.getVisitorId();
Adjust.addGlobalPartnerParameter("PAVisitorId", PAVisitorId);
Список всех параметров, передаваемых Piano Analytics
Piano Analytics требует от Adjust отправлять следующие параметры (точки данных) вместе с колбэками:
Плейсхолдер | Информация |
{session_count} | Количество сеансов, записанных текущим Adjust SDK |
{adgroup_name} | Название группы объявлений (как прописано в трекере) |
{campaign_name} | Название кампании (как прописано в трекере) |
{created_at} | Временная отметка действия |
{creative_name} | Название креатива, как прописано в трекере |
{device_manufacturer} | Название производителя устройства |
{installed_at} | Временная отметка установки (т. е. первого открытия приложения) |
{network_name} | Название сети (как прописано в трекере) |