Краткий обзор: Создавайте отчеты по данным атрибуции, чтобы сопоставлять данные на уровне пользователя по событиям установки/ ретаргетинга с данными из ваших систем.
Создание отчета по данным атрибуции
Чтобы создать отчет по данным атрибуции, следуйте инструкциям, подробно описанным на вкладках ниже.
Примечание. Для удобства чтения необходимые шаги разделены на вкладки. Для создания отчета необходимо выполнить все шаги.
Выполните предварительные шаги
- Перейдите на вкладку Reports (Отчеты) в DCR.
- Нажмите кнопку + New report (+ Новый отчет).
- Выберите Attribution data (Данные атрибуции) в качестве типа исходных данных, затем нажмите Next (Далее) в правом нижнем углу экрана.
- Введите имя отчета.
- Это может быть любое имя, которое позволит вам идентифицировать этот отчет на платформе DCR.
- Важно! Убедитесь, что имя этого отчета отличается от имен других отчетов в вашем аккаунте, иначе вы не сможете сохранить отчет.
- Требования к имени отчета:
- Длина: 2-80 символов.
- Допустимые символы:
- буквы (A–Z, a–z)
- цифры (0–9), имя не может начинаться с цифры
- дефис (-) не может быть первым символом имени
- Недопустимые символы:
- пробелы
- все остальные символы или специальные символы
Выбор источников
Укажите данные, которые будут использоваться для отчета:
Источники данных атрибуции
- Приложения: Выберите одно или несколько приложений в своем аккаунте AppsFlyer.
-
Типы атрибуции: Выберите один или несколько типов данных атрибуции, которые будут использоваться в отчете:
Установки Установка регистрируется после того, как пользователь загрузит, установит и запустит мобильное приложение.
Повторные установки Повторная установка регистрируется, когда пользователь устанавливает приложение, затем удаляет его и снова устанавливает в пределах окна реатрибуции.
- Примечание. Продолжительность окна реатрибуции можно задать в разделе Настройки > Настройки приложения.
Повторные вовлечения Повторное вовлечение регистрируется, когда неактивный пользователь определенного приложения взаимодействует с кампанией ретаргетинга для этого приложения и впоследствии запускает его.
Реатрибуция Реатрибуция регистрируется, когда бывший пользователь определенного приложения (который удалил его) участвует в кампании ретаргетинга для этого приложения и впоследствии переустанавливает его. Органические установки Органические установки — это установки, которые не атрибутированы к конкретному медиа-источнику.
- Примечание. Включение органических установок в отчет может значительно увеличить количество отсканированных строк.
- Период времени: Выберите количество дней исторических данных, за которые DCR будет выполнять поиск событий атрибуции, сопоставленных с событиями вашего пользовательского источника (от 1 до 180 дней).
Пользовательские источники
При определении структуры отчета можно выбрать использование данных из любого из настроенных вами пользовательских источников. Необходимо выбрать хотя бы один пользовательский источник.
Объединение источников
Для сопоставления данных между источниками каждый из пользовательских источников, используемых в отчете, должен включать идентификатор, сопоставленный с ключевым идентификатором в данных атрибуции.
Что такое ключевой идентификатор?
Вы можете сопоставить любой из этих идентификаторов данных атрибуции приложения в качестве ключевого идентификатора:
-
Идентификатор AppsFlyer (af_id): Уникальный идентификатор приложения, сгенерированный AppsFlyer при установке, –
- Этот идентификатор указывается во всех событиях, записанных AppsFlyer.
- Новый идентификатор AppsFlyer генерируется в случае удаления приложения с последующей переустановкой.
-
Идентификатор клиента (CUID): Уникальный идентификатор пользователя, обычно генерируемый и устанавливаемый владельцем приложения во время регистрации пользователя.
- Для использования CUID для сопоставления данных ваше приложение должно быть настроено на отправку CUID в AppsFlyer через SDK или межсерверный API (S2S).
Важно!
Не все медиа-источники допускают сопоставление с использованием CUID. Настоятельно рекомендуется использовать идентификатор AppsFlyer.
Схемы сопоставления (прямые/косвенные)
Если отчет включает в себя более одного пользовательского источника, только один из них необходимо напрямую сопоставить с ключевым идентификатором данных атрибуции. Другие пользовательские источники могут быть сопоставлены как напрямую, так и косвенно, как показано в следующем примере:
Пример
В сценарии, показанном выше:
- Идентификатор пользовательского источника №1 AF напрямую сопоставляется с ключевым идентификатором данных атрибуции af_id.
- Пользовательский источник №2 сопоставляется косвенно: user_code --> AF --> af_id.
- Пользовательский источник №3 отображается косвенно (посредством более длинной цепочки):
user_id --> user_code --> AF --> af_id. - Идентификатор пользовательского источника №4 ID напрямую сопоставляется с ключевым идентификатором данных атрибуции af_id.
- Обратите внимание, что его можно было бы сопоставить косвенно (через идентификатор пользовательского источника №3 user_id), но любой из вариантов работает надлежащим образом.
✓ Эта схема сопоставления позволяет сопоставлять данные между всеми источниками, поскольку каждый пользовательский источник напрямую или косвенно сопоставляется с ключевым идентификатором данных атрибуции af_id.
Определение обработки нескольких совпадающих событий
Примечание
Если типы атрибуции, выбранные для этого отчета, включают только установки и/или органические установки, этот раздел не имеет значения. Перейдите к разделу Выбор параметров.
Сопоставление всех событий
Наиболее полный метод сопоставления позволяет включить в отчет все совпадающие события. Чтобы достичь этого результата, необходимо сопоставить идентификатор в одном из пользовательских источников отчета с идентификатором данных атрибуции install_time.
- Идентификатор в вашем источнике, сопоставленный с install_time, должен иметь следующий формат: гггг-мм-дд чч:мм:сс.
- Примечание. Хотя идентификатора данных атрибуции имеет имя install_time (время установки), на самом деле это означает время события, если речь идет о событиях повторной установки, повторного вовлечения или реатрибуции.
Сопоставление одного события
Если типы атрибуции, выбранные для отчета, включают повторные установки, повторные вовлечения или реатрибуцию, но вы не сопоставляете идентификатор с install_time, вы должны выбрать для использования либо последнее, либо первое совпадающее событие в отчете.
- Последнее событие: Событие атрибуции, включенное в отчет, — это последнее событие (в хронологическом порядке) в рамках заданного периода времени, которое соответствует определенному ключевому идентификатору.
- Первое событие: Событие атрибуции, включенное в отчет, — это первое событие (в хронологическом порядке) в рамках заданного периода времени, которое соответствует определенному ключевому идентификатору.
Сделайте этот выбор на основе события, которое вы считаете наиболее важным для аналитических сведений, которые вы хотите получить из отчета.
Выбор параметров
Напомним, что DCR не может предоставлять данные на уровне пользователя. Вместо этого предоставляются необходимые аналитические данные для принятия решений путем агрегирования (или группировки) данных по выбранным вами параметрам.
Параметр — это, как правило, атрибут, по которому вы классифицируете пользователей приложения (например, геоданные, дата установки, кампания и т. д.)
Выбор параметров для отчета
Параметры отчета по данным атрибуции могут включать следующее:
- Любой доступный параметр данных атрибуции
- Любое поле в пользовательских источниках отчета, которое было отнесено к категории параметров
Выбор параметров для включения в отчет:
- Выберите один или несколько параметров в списке Dimensions from sources (Параметры из источников) слева и нажмите кнопку Add (Добавить) в центральной части экрана, чтобы добавить их в список Report dimensions (Параметры для отчета).
- Для поиска параметров в списках можно использовать строку поиска.
- Чтобы удалить параметр, выберите его в спискеReport dimensions (Параметры для отчета) и нажмите кнопку Remove (Удалить), чтобы вернуть его в список Dimensions from sources (Параметры из источников).
- Повторяйте этот процесс, пока не добавите все параметры, которые хотите включить в отчет.
Примечание. По умолчанию все отчеты сгруппированы по параметру данных атрибуции media_source. Если вы не хотите использовать этот параметр в своем отчете, вы можете удалить его из списка параметров для отчета.
[Необязательно] Настройка отображаемых имен параметров
По умолчанию имена параметров отображаются в отчете под тем же именем, которое присвоено им в данных атрибуции или пользовательских источниках. При желании вы можете настроить имена параметров для своего отчета.
Настройка отображаемых имен параметров:
- В списке Report dimensions (Параметры для отчета) наведите курсор на имя параметра, отображаемое имя которого вы хотите изменить.
- Нажмите кнопку редактирования справа от параметра.
- Измените имя на отображаемое имя параметра, которое будет использоваться в отчете (до 50 символов).
- Нажмите ОК, чтобы сохранить отображаемое имя, или «X», чтобы отменить его.
Сохранение конфиденциальности при группировке по параметрам (перегруппировка)
В зависимости от размера вашего набора данных, количества выбранных параметров и других факторов отчет может включать одну или несколько групп, содержащих слишком мало пользователей для включения в отчет. Если бы данные были представлены таким образом, это нарушило бы ограничения на предоставление данных на уровне пользователя.
- Важно! Минимальное количество пользователей, необходимое для разрешения формирования отчетов, зависит от медиа-источника.
Однако вместо того, чтобы полностью удалить или скрыть данные из отчета, DCR использует механизм перегруппировки, чтобы предоставить как можно больше детальной информации, сохраняя при этом конфиденциальность пользователей.
Пример перегруппировки
Предположим, вы настроили отчет по следующим параметрам (по порядку):
-
Параметры данных атрибуции:
- media source
- campaign
- adset_name
- ad_id
-
Параметры из пользовательского источника:
- user_type
Перед перегруппировкой
После первоначального анализа данных DCR определяет, что данные будут разбиты следующим образом:
media source |
campaign | adset name |
ad id |
user type |
rev D0 |
rev D7 |
count | reportable? |
---|---|---|---|---|---|---|---|---|
media_source | UA_100 | green | kjh867 | buyer | 1 | 4 | 120 |
✓ |
media_source | UA_101 | green | jkj987 | ultra | 2 | 23 | 220 |
✓ |
media_source | UA_200 | green | lkh123 | beg | 6 | 7 | X |
X |
media_source | UA_200 | green | ilk945 | beg | 3 | 21 | X |
X |
media_source | UA_200 | green | plm654 | beg | 8 | 17 | X |
X |
В текущем виде последние 3 строки не подлежат включению в отчет, поскольку в каждой из них слишком мало пользователей. (Для включения этого медиа-источника в отчет требуется минимум y пользователей. Здесь у нас есть только x.)
Согласно логике перегруппировки, DCR сначала «исключает» последний включенный в список параметр данных атрибуции (в данном случае ad_id). Затем система снова анализирует данные, чтобы определить, какие строки подлежат включению в отчет.
После перегруппировки
После применения логики перегруппировки отчет выглядит следующим образом:
media source |
campaign | adset name |
ad id |
user type |
rev D0 |
rev D7 |
count | reportable? |
---|---|---|---|---|---|---|---|---|
media_source | UA_100 | green | kjh867 | buyer | 1 | 4 | 120 |
✓ |
media_source | UA_101 | green | jkj987 | ultra | 2 | 23 | 220 |
✓ |
media_source | UA_200 | green | RESTRICTED | beg | 17 | 45 | y (x+x+x) |
✓ |
Результаты:
- Последняя строка теперь объединяет данные, которые ранее находились в 3 строках. Теперь объединенная строка содержит количество пользователей, равное y, и может быть включена в отчет.
- Исключенный параметр теперь отмечен как RESTRICTED (ОГРАНИЧЕНО).
- Если бы все еще имелись строки, не подлежащие включению в отчет (менее y пользователей), система DCR продолжила бы анализировать данные с использованием итеративного метода, исключая один параметр за другим до достижения одного из следующих результатов:
- в отчет можно включить все строки; или
- больше нет параметров данных атрибуции для исключения
Примечание. По умолчанию DCR применяет перегруппировку только к параметрам данных атрибуции (не к параметрам из пользовательских источников). Если данные, сгруппированные по параметрам данных атрибуции, приведут к появлению строки, содержащей менее y пользователей, данные в этой строке будут отмечены как «ОГРАНИЧЕНО».
- Ниже приведена дополнительная опция, которую можно использовать для применения перегруппировки также и к параметрам из пользовательского источника.
[Необязательно] Управление приоритетом параметров
По умолчанию параметры данных атрибуции исключаются в порядке, обратном порядку их отображения в списке параметров для отчета. Однако вы можете изменить последовательность по умолчанию и/или применить перегруппировку к выбранным параметрам из пользовательского источника, чтобы сохранить наиболее важные для вас параметры.
Изменение порядка исключения параметров:
- Нажмите кнопку Manage dimension priority (Управление приоритетом параметров).
- Выберите параметр и перетащите его в нужное место в списке (или переместите его при помощи кнопок со стрелками справа).
- Если параметр отмечен как Highest priority (Наивысший приоритет) (в верхней части списка), это значит, что он будет исключен последним, если потребуется перегруппировка.
- [Необязательно] Чтобы применить перегруппировку к параметрам из пользовательского источника:
- Нажмите Use advanced options to refine regrouping (Использовать расширенные опции для оптимизации перегруппировки)
- Выберите параметры из пользовательского источника, к которым вы хотите применить перегруппировку.
- Выбранные параметры добавляются в список Manage dimension priority (Управление приоритетом параметров).
- По умолчанию эти параметры добавляются в конец списка как имеющие самый низкий приоритет при перегруппировке. Однако вы можете изменить их порядок так же, как и с параметрами данных атрибуции, как описано выше.
- Нажмите ОК, чтобы сохранить изменения.
- Список Report dimensions (Параметры для отчета) на главном экране остается в исходном порядке, но измененный порядок сохранен. (Нажмите кнопку Manage dimension priority (Управление приоритетом параметров) еще раз, чтобы просмотреть или изменить свой выбор.)
Выбор метрик
Метрики — это числовые данные, которые вы собрали в отношении пользователя приложения (примерами могут служить доход, количество открытий приложения, LTV и т. д.), и это может быть любое числовое поле данных из ваших источников, которое вы классифицировали как метрику.
Выбор метрик для включения в отчет:
- Выберите одну или несколько метрик в списке Metrics from sources (Метрики из источников) слева и нажмите кнопку Add (Добавить) в центральной части экрана, чтобы добавить их в список Report metrics (Метрики для отчета).
- Для поиска метрик в списках можно использовать строку поиска.
- Для каждой метрики в списке метрик для отчета выберите, хотите ли вы, чтобы данные были представлены в отчете как:
- сумма числовых значений; или
- количество различных значений
- Чтобы удалить метрику, выберите ее в спискеReport metrics (Метрики для отчета) и нажмите кнопку Remove (Удалить), чтобы вернуть ее в список Metrics from sources (Метрики из источников).
- Повторяйте этот процесс, пока не добавите все метрики, которые хотите включить в отчет.
[Необязательно] Настройка отображаемых имен метрик
По умолчанию имена метрик отображаются в отчете под тем же именем, которое присвоено им в данных атрибуции или пользовательских источниках. При желании вы можете настроить имена метрик для своего отчета.
Настройка отображаемых имен метрик:
- В списке Metrics from sources (Метрики для отчета) наведите курсор на имя метрики, отображаемое имя которой вы хотите изменить.
- Нажмите кнопку редактирования справа от метрики.
- Измените имя на отображаемое имя метрики, которое будет использоваться в отчете (до 50 символов).
- Нажмите ОК, чтобы сохранить отображаемое имя, или «X», чтобы отменить его.
[Необязательно] Выбор идентификаторов для подсчета
По умолчанию каждая строка отчета заканчивается столбцом, содержащим количество отдельных идентификаторов AppsFlyer, сгруппированных в данных этой строки.
Если вы хотите добавить столбцы для отдельных подсчетов других идентификаторов из ваших источников, это можно сделать так:
- Выберите один или несколько идентификаторов в списке Identifiers from sources (Идентификаторы из источников) слева и нажмите кнопку Add (Добавить) в центральной части экрана, чтобы добавить их в список Distinct count identifiers (Отдельные идентификаторы для подсчета).
- Для поиска идентификаторов в списках можно использовать строку поиска.
- Чтобы удалить идентификатор, выберите его в списке Distinct count identifiers (Отдельные идентификаторы для подсчета) и нажмите кнопку Remove (Удалить), чтобы вернуть его в список Identifiers from sources (Идентификаторы из источников).
- Повторяйте этот процесс, пока не добавите все идентификаторы, подсчет которых хотите включить в отчет.
Чтобы задать место назначения отчета и сохранить отчет:
DCR передает отчеты в выбранные вами облачные сервисы с помощью AppsFlyer Data Locker. Таким образом, указание места назначения отчета подразумевает выбор или создание соединения с Data Locker.
- Примечание. Получение отчетов DCR не требует премиум-подписки на Data Locker. Если вы заинтересованы в получении других отчетов AppsFlyer через Data Locker, свяжитесь с вашим менеджером или отправьте письмо по адресу hello@appsflyer.com.
Чтобы задать место назначения отчета и сохранить отчет:
- Выберите из списка доступных подключений Data Locker в вашем аккаунте AppsFlyer.
- Если в вашем аккаунте не определены подключения:
- В вашем браузере откроется новая вкладка (со страницей AppsFlyer Data Locker)
- Откроется окно Новое подключение. Следуйте этим инструкциям для создания подключения.
- Если у вас уже есть подключения, но вы хотите использовать новое, нажмите на кнопку :
- В вашем браузере откроется новая вкладка (со страницей AppsFlyer Data Locker)
- Откроется окно Новое подключение. Следуйте этим инструкциям для создания подключения.
- После создания подключения вернитесь на вкладку DCR в браузере и выберите только что созданное подключение из списка подключений Data Locker.
- Если в вашем аккаунте не определены подключения:
- Нажмите Save (Сохранить), чтобы сохранить отчет.
- Новый отчет теперь отображается на вкладке Reports (Отчеты) в Data Clean Room.
Когда запускается отчет?
После создания и сохранения отчета он запускается при обнаружении новых версий всех пользовательских источников, которые он использует:
- Для источников, расположенных в хранилищах данных (BigQuery и Snowflake), DCR распознает создание новой версии источника, когда обнаруживает новое значение в столбце
v
таблицы источника.- Важно! Чтобы обеспечить полноту отчета, обязательно заполняйте таблицу источника полным набором данных при каждом изменении значения столбца.
- Для источников, расположенных в облачных хранилищах (Amazon S3 и GCS), DCR распознает создание новой версии источника, когда обнаруживает, что новая версия файла источника была загружена вместе с сопутствующим файлом _SUCCESS.
AppsFlyer постоянно сканирует новые версии источников для текущей даты и 2 дней до нее.
Справочник
Доступные параметры данных атрибуции
Помимо параметров из пользовательских источников, для группировки отчетов можно использовать следующие параметры данных атрибуции:
- media_source (включен как параметр для отчета по умолчанию)
- ad
- ad_id
- ad_type
- adset_id
- adset_name
- app_id
- app_version
- attributed_touch_type
- brand
- campaign
- campaign_id
- channel (канал)
- city
- contributor_1_campaign¹
- contributor_1_engagement_type¹
- contributor_1_match_type¹
- contributor_1_media_source¹
- contributor_1_partner¹
- contributor_1_touch_type¹
- contributor_2_campaign¹
- contributor_2_engagement_type¹
- contributor_2_match_type¹
- contributor_2_media_source¹
- contributor_2_partner¹
- contributor_2_touch_type¹
- contributor_3_campaign¹
- contributor_3_engagement_type¹
- contributor_3_match_type¹
- contributor_3_media_source¹
- contributor_3_partner¹
- contributor_3_touch_type¹
- conversion_type
- country
- customer_id
- device_type
- dma
- engagement_type
- geo_region
- keywords
- match_type
- media_source
- model
- original_url
- partner
- platform
- site_id
¹ В отношении повторных вовлечений и реатрибуции в отчетах эти поля будут отображаться как пустые.