Отчеты с сырыми данными PBA

Краткий обзор: отчеты с сырыми данными PBA доступны через Data Locker.

Отчеты с сырыми данными PBA

Используйте отчеты с сырыми данными PBA для анализа путей и действий пользователей.

Описание отчетов

Темы отчетов с сырыми данными PBA

Тема отчета с сырыми данными Описание
Посещения сайта
  • Посещения сайта.
  • Измеряйте воздействие кампаний по привлечению веб-трафика и взаимодействие пользователей с этими кампаниями.

События на сайте

  • Содержит действия, выполняемые посетителями сайта, такие как подписка или покупка.
  • События атрибутируются последнему за предыдущие 30 дней непрямому посещению сайта.
  • Параметры атрибуции, связанные с событием, например, медиа-источник, медиа-канал, кампания и др. 
  • Используйте эти параметры для оптимизации маркетинговых активностей.
  • Анализируйте поведение пользователей по медиа-источнику.
  • Значения этих полей определяются на основе атрибутированного посещения по правилам атрибуции медиа-источников PBA.
  • Цель: связывать события с определенным посещением сайта, а не просмотром страницы.
  • Определите по этому отчету, какие источники и кампании привлекают пользователей и какие действия эти пользователи выполняют.

Установки, дополнительным источником которых является сайт

  • В отчетах по установкам, дополнительным источником которых является сайт, указываются посещения сайта, после которых пользователь установил приложение.
  • Определите место веб медиа-источника на пути к установке: последний или вспомогательный (т.е. не последний).
  • Выясните, какая комбинация веб медиа-источников наиболее эффективно стимулирует установки.
  • Например:
    • Веб медиа-источник A и мобильный медиа-источник B часто встречаются в пути пользователя.
    • Допущение: эта комбинация может стимулировать установки.

Путь конверсии

  • Содержит точки взаимодействия, которые проходит пользователь на пути к конверсии. У каждой точки взаимодействия отдельная запись.
  • У каждой конверсии свой уникальный идентификатор. Используйте его для обозначения точек взаимодействия, которые относятся к одной и той же конверсии.
  • На дэшборде идентичные последовательные точки взаимодействия объединяются в шаги. В сырых данных у каждой точки взаимодействия отдельная запись. Так обеспечивается максимальная детализация.

Поля отчета с сырыми данными

Посещения сайта и события на сайте

Примеры отчетов

  • События сайта: CSV
  • Посещения сайта: CSV

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

Скачать список полей в формате 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

События на сайте

Посещения сайта

Изменены названия и структура отчетов:

  • Посещения сайта (Website visits) вместо «Точки взаимодействия на вебе» (Web touchpoints)
  • События на сайте (Website events) вместо «Веб-события» (Web events)
04.10.2020 Web-to-app

Добавлены поля:

  • mobile_campaign_id
  • web_campaign_id
04.10.2020 Путь конверсии

Добавлены поля: 

  • conversion_campaign_id
  • touchpoing_campaign_id

Процедура

Настройка отчетов PBA в Data Locker

  • Отчеты PBA записываются в Data Locker ежедневно в папку h=23 по событиям, произошедшим за данный день.
  • Данные не могут быть записаны задним числом.

AppsFlyerAdmin_us-en.png Чтобы включить отчеты PBA, администратор аккаунта должен настроить Data Locker:

  1. Перейдите в раздел Интеграция > Data Locker.
  2. Выберите все отчеты в разделе «Атрибуция People-Based». 
  3. Нажмите Сохранить конфигурацию.

Как скачивать отчеты, читайте в разделе Доступ к отчетам 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:

  1. Откройте Cyberduck
    Отобразится список доступных типов данных.

    Duck_us-en.jpg

  2. Дважды щелкните тип отчета PBA и выберите web_events, web_to_app или web_touch_points.
    На экране появится список дат, за которые доступны отчеты.
  3. Правой кнопкой мыши щелкните нужную дату.
  4. Выберите Download to a specific location (Скачать в определенное расположение) и укажите его.
    Начнется скачивание файлов. 
  5. Повторите предыдущие шаги, чтобы копировать данные из отчетов других типов. Данные по каждому типу отчета и дате должны храниться в отдельных папках на вашем компьютере. 

Создание объединенного файла CSV: 

Прежде чем начать:

Установите Q на свой компьютер.

Чтобы объединить данные в файл CSV с помощью Q:

  1. Используя командную строку / терминал Mac, перейдите в каталог с данными.
  2. Используйте следующую команду, чтобы объединить сжатые файлы в один файл с именем pbadata.csv.
    Примечание. Символом «~» обозначается путь/домашняя папка, в которой на вашем компьютере выполнится команда Q. Для вызова команды иногда требуется указать полный путь. 
    ~q "SELECT * from part*.gz" -d , -H -z -O >pbadata.csv
  3. Откройте файл с помощью Excel или другого инструмента.