Краткий обзор: отчеты с сырыми данными PBA доступны через Data Locker.
Отчеты с сырыми данными PBA
Используйте отчеты с сырыми данными PBA для анализа путей и действий пользователей.
Описание отчетов
Темы отчетов с сырыми данными PBA
Тема отчета с сырыми данными | Описание |
---|---|
Посещения сайта |
|
|
|
|
|
|
Поля отчета с сырыми данными
Посещения сайта и события на сайте
Примеры отчетов
Поля в отчетах с сырыми данными частично заполняются на основе данных из ссылки атрибуции пользователей мобильного приложения и события установки приложения.
Скачать список полей в формате CSV
Список полей в отчетах «Посещения сайта» и «События на сайте»:
Имя поля | Описание | Формат | Пример |
---|---|---|---|
advertising_id | Рекламный идентификатор (GAID) | Строка | 7fzzz3fa-8bad-46c9-bb03-fffffffffffffffffffffffff |
af_web_id | Идентификатор файла cookie, отправляемый из веб-SDK | Строка | 68972980-58f9-4ca6-8743-c0d633364b6d |
amazon_aid | Рекламный идентификатор Amazon Fire TV | Строка | df07c7dc-cea7-4a89-b328-810ff5acb15d |
android_id | Идентификатор устройства Android | Строка | 68999980-58f9-4ca6-8743-c0d633364b6d |
app_id | Идентификатор последнего установленного приложения | Строка | id123456789 |
app_name | Последнее название приложения | Строка | Мое приложение |
app_version | Последняя версия приложения | Строка | 6.32 |
appsflyer_id | Идентификатор AppsFlyer (установка) | Строка | 1594825729709-5655157112349378588 |
attributed_touch_time | Для посещений сайта: метка времени посещения сайта. Для веб-событий: метка времени атрибутированного посещения сайта. | гггг-мм-дд чч:мм:сс | 9/17/2020 0:09:25 |
attributed_touch_type | Тип точки взаимодействия. На данный момент всегда задается как посещение сайта. | Строка | Посещение сайта |
bundle_id | Идентификатор пакета PBA | Строка | 048db9bf-97r7-4m2f-919b-607b7kk806d0 |
campaign | Атрибутируется посещению сайта | Строка | Летняя кампания |
campaign_id | Атрибутируется посещению сайта | Строка | 12343425 |
city | Определено по IP-адресу | Строка | Спринг Вэлли |
country_code | Определено по IP-адресу | Строка | США |
customer_user_id | Идентификатор клиента (CUID) | Строка | 5a8771ecbb986ABC |
device_type | Тип устройства | Строка | Десктоп |
dma | Определено по IP-адресу | Строка | 501 |
event_name | В отчете о посещениях сайта: всегда посещение сайта. В отчете о посещениях сайта: eventName, отправленное из веб-SDK. | Строка | покупка |
event_revenue | Сумма дохода от события в валюте покупки | Строка | 199.99 |
event_revenue_currency | 3-символьный код валюты event_revenue | Строка | USD, ZAR, EUR |
event_revenue_usd | event_revenue в долларах США | Строка | 57.46 |
event_source | Веб-SDK или сервер-сервер | Строка | веб-SDK, S2S |
event_time | Посещения сайта: время посещения. События на сайте: время события. | гггг-мм-дд чч:мм:сс | 9/17/2020 0:09:25 |
event_type | Следующие: стандартное событие, событие конверсии, посещение сайта | Строка | событие конверсии |
event_url | URL-адрес веб-страницы, на которой произошло событие (соответствует исходному URL-адресу в посещениях сайта) | Строка | http://www.brandpit.com/checkout |
event_value | События на сайте: сведения о значении события, содержащиеся в JSON. Посещения сайта: всегда null. | JSON | {"sku": "ABC123", “color": "blue", "unit_price":3.99,"currency": "USD"} |
idfa | Рекламный идентификатор | Строка | A56B9887-FEBA-458C-BEFC-C891F9DF7681 |
idfv | Рекламный идентификатор | Строка | EBC2F523-B1E5-4484-A4C8-ADC32DC7C23D |
imei | Идентификатор устройства | Строка | 3532211234 |
install_time | Последнее время установки приложения | гггг-мм-дд чч:мм:сс | 9/17/2020 0:09:25 |
ip | IP-адрес посетителя | Строка | 24.7.104.115 |
language | Переданный user agent | Строка | English |
media_channel | Атрибутируется посещению сайта | Строка | Реклама |
media_source | Атрибутируется посещению сайта | Строка | googleadwords_int |
media_type | Атрибутируется посещению сайта | Строка | Платный |
oaid | Рекламный идентификатор | Строка | df07c7dc-cea7-4a89-b328-810ff5acb15d |
original_url | URL-адрес, перенаправивший пользователя на сайт при атрибутированном посещении сайта | Строка | https://www.brandpitt.com/signin?utm_source=Googleg&utm_term=shoes&utm_campaign=cool&c=summer&af_siteid=publisher&af_sub1=helloworld |
platform | Платформа | Строка | macOS |
postal_code | Определено по IP-адресу | Строка | 10977 |
query_params | Параметры запроса в URL-адресе перенаправления (после ?) Пример: https://www.brandpitt.com/signin?utm_source=Google&utm_term=shoes&utm_campaign=cool&c=summer&af_siteid=publisher&af_sub1=helloworld&af_keyword=shoes Если в URL-адресе нет параметров запроса, это поле имеет значение null | JSON | {"c":"summer",af_siteid":"publisher",af_sub1":helloworld",af_keywords":"shoes","utm_source":"Google","utm_campaign":"cool","utm_term":"shoes"} |
Referrer | HTTP-реферер атрибутированного посещения сайта | Строка | https://www.google.com/ |
Регион | Определено по IP-адресу | Строка | Северная Америка |
Состояние | Определено по IP-адресу | Строка | Нью-Йорк |
Установки, дополнительным источником которых является сайт
Структура записей в отчете
- Поля записей сгруппированы следующим образом:
- Событие: событие конверсии в установку.
- Точка взаимодействия: точки взаимодействия, предшествовавшие конверсии в установку.
- Конверсия в установку включает одну или несколько точек взаимодействия. По каждой точке взаимодействия есть запись в сырых данных. Точки взаимодействия, относящиеся к одной установке, группируются по install_id.
Пример отчета Web-to-App
Установки, дополнительным источником которых является сайт
Группа полей | Имя поля | Описание |
---|---|---|
Событие | bundle_name | Имя пакета бренда, настроенное на странице пакета бренда |
Событие | bundle_id | Идентификатор пакета бренда |
Событие | app_id |
Идентификатор приложения |
Событие | install_id | Уникальный идентификатор установки группирует точки взаимодействия в пути пользователя. Рассчитывается как bundle_id + appsflyer_id + install_time |
Событие | appsflyer_id | AppsFlyer ID, присвоенный мобильному устройству при установке приложения |
Событие | install_time | Время установки |
Событие | install_name |
установка, повторная установка (т.е. пользователь сначала установил приложение, потом удалил его и установил снова) вне зависимости от ее причины. |
Событие | install_type |
Тип установки: organic_install (органическая), custom_link_install (по настраиваемой ссылке), smart_banner_install (по смарт-баннеру), non-organic_install (неорганическая) |
Событие | final_data |
True или false. Если значение true (истина), строка является окончательной. Пример: Установка произошла 1 января. В течение следующих 7 дней строки отчета, связанные с этой установкой, содержат значение false в столбце final_data. 8 января данные о конверсии становятся окончательными, и значение меняется на true. Отчеты с 9 января уже не содержат установку. |
Событие | mobile_media_source | Последний мобильный медиа-источник, с которым пользователь взаимодействовал перед установкой |
Событие | mobile_campaign | Последняя кампания, с которой пользователь взаимодействовал перед установкой |
Событие | mobile_campaign_id |
Идентификатор последней кампании, с которой пользователь взаимодействовал перед установкой |
Событие | mobile_device_category |
Тип используемого устройства: телефон, планшет |
Точка взаимодействия | touchpoint_contirubtion |
Это поле заменяет устаревшее path_touch_type. |
Событие | mobile_platform |
Операционная система устройства: Android, iOS |
Событие | mobile_country | Страна установки по IP-адресу устройства |
Точка взаимодействия | web_timestamp |
Время точки взаимодействия в вебе |
Точка взаимодействия | web_media_source | Точка взаимодействия с веб медиа-источником |
Точка взаимодействия | web_campaign | Точка взаимодействия с веб-кампанией |
Точка взаимодействия | web_campaign_id | Идентификатор точки взаимодействия с веб-кампанией |
Точка взаимодействия | web_media_type | |
Точка взаимодействия | web_media_channel | |
Точка взаимодействия | web_device_category |
Значение точки взаимодействия: desktop (компьютер), other (другое), smartphone (смартфон), tv (телевизор), tablet (планшет) |
Точка взаимодействия | web_platform |
Операционная система устройства, использованного в точке взаимодействия: Android, iOS, Windows, macOS, Chrome OS, Linux |
Точка взаимодействия | web_country | Страна точки взаимодействия |
Точка взаимодействия | web_pid | Значение UTM для посещений сайта |
Точка взаимодействия | web_utm_source |
Значение UTM для посещений сайта |
Точка взаимодействия | web_utm_medium |
Значение UTM для посещений сайта |
Точка взаимодействия | web_utm_campaign |
Значение UTM для посещений сайта |
Точка взаимодействия | web_utm_content |
Значение UTM для посещений сайта |
Точка взаимодействия | web_utm_term |
Параметр UTM term (ключевые слова) в точке взаимодействия |
Точка взаимодействия | web_referrer |
HTTP-реферер посещения сайта, которому атрибутирована установка. |
Точка взаимодействия | web_googleads_campaign_id |
Идентификатор кампании, полученный через интеграцию с Google Ads (доступен с 6 августа 2020 г.) |
Точка взаимодействия | web_googleads_campaign_name |
Имя кампании, полученное через интеграцию с Google Ads (доступно с 6 августа 2020 г.) |
Точка взаимодействия | web_utm_id |
Значение UTM для посещений сайта |
Событие | customer_user_id | Идентификатор клиента, заданный веб-SDK |
Точка взаимодействия | idfa |
Идентификатор устройства, на который было установлено приложение |
Точка взаимодействия | idfv | Идентификатор устройства, на который было установлено приложение |
Точка взаимодействия | android_id | Идентификатор устройства, на который было установлено приложение |
Точка взаимодействия | advertising_id | Идентификатор устройства, на который было установлено приложение |
Точка взаимодействия | amazon_fire_id | Идентификатор устройства, на который было установлено приложение |
Точка взаимодействия | imei | Идентификатор устройства, на который было установлено приложение |
Путь конверсии
Структура записей в отчете
- Поля сгруппированы следующим образом:
- Событие: событие конверсии и связанная с ним информация.
- Точка взаимодействия: сведения о точке взаимодействия на пути к конверсии.
- Путь к конверсии включает одну или несколько точек взаимодействия. В файле каждой точке взаимодействия соответствует отдельная запись.
Пример отчета «Пути конверсии»
Conversion_paths_example_oct20.csv
Поля пути к конверсии
Группа полей | Имя поля | Описание |
---|---|---|
Событие | conversion_id | Уникальный идентификатор конверсии для группировки точек взаимодействия одной конверсии. Рассчитывается как bundle_id + appsflyer_id + conversion_time |
Событие | bundle_name |
Имя пакета бренда, заданное на странице пакета бренда
|
Событие | bundle_id | Идентификатор пакета бренда |
Событие | final_data |
True или false. Если значение true (истина), строка является окончательной. Пример: Конверсия произошла 1 января. В течение следующих 7 дней строки отчета, связанные с этой конверсией, содержат значение false в столбце final_data. 8 января данные о конверсии становятся окончательными, и значение меняется на true. Отчеты с 9 января уже не содержат конверсию. |
Событие | conversion_type | mobile_conversion (мобильная конверия), web_converson (веб-конверсия), install (установка) |
Событие | app_id | Идентификатор приложения |
Событие | appsflyer_id |
Идентификатор, присваиваемый мобильному устройству, когда пользователь устанавливает приложение
|
Событие | conversion_time | - |
Событие | conversion_name | Отправляется веб-SDK или веб-S2S, либо это имя внутреннего события приложения, отправляемое мобильным устройством / мобильным S2S. |
Событие | conversion_media_source | Атрибутированный медиа-источник |
Событие | conversion_campaign | Атрибутированная кампания |
Событие | conversion_campaign_id |
Идентификатор атрибутированной кампании
|
Событие | conversion_media_type |
Тип атрибутированного медиа-канала: paid (платный), owned (собственный), earned (заработанный)
|
Событие | conversion_media_channel |
Атрибутированный медиа-канал: прямой запрос, органический поиск, социальные сети, электронная почта, реклама, реферал
|
Событие | conversion_device_category | Категория устройства: телефон, планшет, компьютер |
Событие | conversion_platform | Платформа, например, MacOS, Windows |
Событие | conversion_country | Местоположение пользователя |
Событие | conversion_url |
Веб-конверсии: страница, на которой произошла конверсия.
Мобильные: null |
Точка взаимодействия | touchpoint_time | - |
Точка взаимодействия | touchpoint_type | Посещение сайта, мобильный клик, мобильный показ |
Точка взаимодействия | touchpoint_media_source | - |
Точка взаимодействия | touchpoint_campaign | - |
Точка взаимодействия | touchpoint_campaign_id | - |
Точка взаимодействия | touchpoint_media_type | Платный (paid), собственный (owned), заработанный (earned) |
Точка взаимодействия | touchpoint_media_channel |
Прямой трафик, органический поиск, соцсети, электронная почта, реклама, реферал
|
Точка взаимодействия | touchpoint_device_category | Телефон, планшет |
Точка взаимодействия | touchpoint_platform | Android, iOS |
Точка взаимодействия | touchpoint_country | Код страны |
Точка взаимодействия | touchpoint_utm_source | Значения UTM для посещений сайта |
Точка взаимодействия | touchpoint_utm_medium | Значения UTM для посещений сайта |
Точка взаимодействия | touchpoint_utm_campaign | Значения UTM для посещений сайта |
Точка взаимодействия | touchpoint_utm_content | Значения UTM для посещений сайта |
Точка взаимодействия | touchpoint_utm_term | Значения UTM для посещений сайта |
Точка взаимодействия | touchpoint_utm_id | Значения UTM для посещений сайта |
Точка взаимодействия | touchpoint_referrer | URL-адрес, с которого пользователь перешел на сайт этой точки взаимодействия. Если точка взаимодействия мобильная, этот параметр имеет значение null. |
Точка взаимодействия | web_googleads_campaign_id |
Идентификатор кампании, полученный через интеграцию с Google Ads. (Доступно с 6 августа 2020 г.) |
Точка взаимодействия | web_googleads_campaign_name |
Имя кампании, полученное через интеграцию с Google Ads. (Доступно с 6 августа 2020 г.) |
Событие | customer_user_id | Идентификатор пользователя, пришедший с событием |
Событие | idfa | Идентификатор устройства, используемого во время конверсии |
Событие | idfv | Идентификатор устройства, используемого во время конверсии |
Событие | android_id | Идентификатор устройства, используемого во время конверсии |
Событие | advertising_id | Идентификатор устройства, используемого во время конверсии |
Событие | amazon_fire_id | Идентификатор устройства, используемого во время конверсии |
Событие | imei | Идентификатор устройства, используемого во время конверсии |
Поля: примечания к выпуску
Дата | Отчет | Изменение |
---|---|---|
17.01.2020 | Установки, дополнительным источником которых является сайт (Website-Assisted Installs) |
Изменено название отчета в Data Locker. |
18.11.2020 |
События на сайте Посещения сайта |
Изменены названия и структура отчетов:
|
04.10.2020 | Web-to-app |
Добавлены поля:
|
04.10.2020 | Путь конверсии |
Добавлены поля:
|
Процедура
Настройка отчетов PBA в Data Locker
- Отчеты PBA записываются в Data Locker ежедневно в папку h=23 по событиям, произошедшим за данный день.
- Данные не могут быть записаны задним числом.
Чтобы включить отчеты PBA, администратор аккаунта должен настроить Data Locker:
- Перейдите в раздел Интеграция > Data Locker.
- Выберите все отчеты в разделе «Атрибуция People-Based».
- Нажмите Сохранить конфигурацию.
Как скачивать отчеты, читайте в разделе Доступ к отчетам Data Locker.
В Data Locker отчеты с сырыми данными PBA доступны в папке h=23.
Example: t=website_events/dt=2020-11-26/h=23
Объединение данных PBA и данных по мобильным устройствам
Эти данные показывают, какие пользователи с наибольшей вероятностью будут взаимодействовать и с мобильным приложением, и с сайтом.
Объедините данные по мобильному приложению и сайту.
Решение:
- Объединение отчетов по идентификатору клиента (CUID)
- Используйте один и тот же CUID для мобильных приложений и веба, чтобы использовать его как ключ для объединения отчетов.
- Затем объедините отчеты по полю CUID.
- PBA: идентификация пользователя на нескольких платформах:
- PBA позволяет определить, что пользователь веба и мобильного приложения — один и тот же человек.
- Если это так, то веб-отчеты с PBA содержат идентификатор мобильной рекламы: рекламный идентификатор Android, iOS IDFA, OAID или рекламный идентификатор Amazon.
- Затем объедините мобильный и веб-отчеты по идентификатору мобильной рекламы.
Примеры использования PBA и данных по мобильным устройствам
Объедините данные по мобильному приложению и вебу, чтобы увидеть активность пользователя на различных платформах и устройствах. На их основе вы сможете:
- Проследить путь пользователя по цифровым ресурсам бренда.
- Проанализировать поведение пользователя на каждой платформе.
- Выяснить, на какой платформе вовлечение пользователей выше.
- Понять, на какой платформе происходит больше всего конверсий.
- Измерить эффективность своих усилий по переводу пользователей из веба в мобильное приложение.
Примечание по применению: скачивание и объединение файлов Data Locker
Сырые данные PBA доступны в Data Locker. Данные по конкретному отчету находятся в папке h=23 для соответствующего типа отчетов и в виде нескольких сжатых файлов.
Используйте эту процедуру, чтобы:
- Скопировать файлы из Data Locker с помощью Cyber Duck или любого другого инструмента для копирования файлов S3.
- Соедините файлы в один файл CSV с помощью Q.
Копирование данных PBA из Data Locker
Прежде чем начать:
Чтобы скопировать данные с помощью Cyber Duck:
- Откройте Cyberduck
Отобразится список доступных типов данных.
-
Дважды щелкните тип отчета PBA и выберите web_events, web_to_app или web_touch_points.
На экране появится список дат, за которые доступны отчеты. - Правой кнопкой мыши щелкните нужную дату.
- Выберите Download to a specific location (Скачать в определенное расположение) и укажите его.
Начнется скачивание файлов. - Повторите предыдущие шаги, чтобы копировать данные из отчетов других типов. Данные по каждому типу отчета и дате должны храниться в отдельных папках на вашем компьютере.
Создание объединенного файла CSV:
Прежде чем начать:
Установите Q на свой компьютер.
Чтобы объединить данные в файл CSV с помощью Q:
- Используя командную строку / терминал Mac, перейдите в каталог с данными.
- Используйте следующую команду, чтобы объединить сжатые файлы в один файл с именем pbadata.csv.
Примечание. Символом «~» обозначается путь/домашняя папка, в которой на вашем компьютере выполнится команда Q. Для вызова команды иногда требуется указать полный путь.
~q "SELECT * from part*.gz" -d , -H -z -O >pbadata.csv
- Откройте файл с помощью Excel или другого инструмента.