Настройка 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 requires its Visitor ID to link the initial install with subsequent in-app events. To accomplish this, you’ll need to send Piano Analytics' Visitor ID as an SDK Global Partner Parameter with the exact name PAVisitorId. For more details on attaching global partner parameters, please refer to our documentations:
Here’s an example of the code to implement for 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} | Название сети (как прописано в трекере) |