Краткий обзор: Узнайте, как создавать источники данных измерений и как предоставить к ним доступ таким образом, чтобы они могли быть применены и обработаны в процессе атрибуции.
Обзор
Первый шаг в настройке процесса измерения включает в себя подготовку трёх типов входных данных: конверсии, вовлечённость и сопоставление кампаний. Эти входные данные должны быть подготовлены на основе опредёленной заранее схемы или структуры события, в зависимости от режима предоставления данных: внутренние события приложения или пользовательские исходные файлы.
Если в режиме предоставления данных используются пользовательские исходные файлы, процесс атрибуции запускается автоматически при загрузке необходимых папок с записями о конверсии и вовлечённости в облако. В режиме внутренних событий приложения процесс запускается при выборе соответствующих внутренних событий приложения.
Подготовка внутренних событий приложения
Вы можете отправлять данные о конверсии и вовлечённости через внутренние события приложения, отправляемые SDK от AppsFlyer, интегрированным в ваше приложение.
Примечание:
Возможно, этот вариант, будет проще, чем пользовательский исходный файл, если вы уже передаёте внутренние события приложения AppsFlyer через SDK или через межсерверные запросы.
Подготовка внутренних событий конверсии
Внутреннее событие конверсии должно содержать информацию об SKU. В следующем примере параметр af_order_info указывает информацию об SKU:
"event_value": {
"af_currency": "EUR",
"af_content": "retail",
"af_order_id": "637f7c400f0e3fddd9e5bcbc",
"af_order_info": [
{
"sku": "a",
"revenue": 1.1,
"qty": 2
},
{
"sku": "b",
"revenue": 100.5,
"qty": 1
}
]
}
Для получения информации о том, как подготовить внутренние события приложения, см. раздел «Создание внутренних событий» ниже.
Подготовка внутренних событий повторного вовлечения
Вовлечение пользователей в рамках внутренних кампаний может происходить за счёт внутренних событий приложения. Внутреннее событие вовлечения должно содержать данные атрибуции в параметре event_value. См. в качестве примера следующую JSON-структуру event_value:
"event_value": {
"media_source": "onsite",
"campaign_name": "winter_bags",
"campaign_id": "637f7c400f0e3fddsdfaafe33",
"engagement_type": "click"
}
В JSON-параметре evant_value можно использовать следующие поля:
| Поле | Описание | Обязательно | Доступно в схеме внутренних событий приложения? | Тип |
|---|---|---|---|---|
campaign_id (идентификатор кампании) |
Идентификатор кампании | Да | Нет | string |
campaign_name |
Название кампании | Нет | Нет | string |
тип_взаимодействия |
Позволяет различать клики и показы | Да | Нет | string |
медиа-источник |
Медиа-источник, атрибутированный событию или ограниченный (подробнее) | Да | Нет | string |
ad_id (идентификатор объявления) |
Идентификатор рекламы | Нет | Нет | string |
ad_name |
Название рекламы | Нет | Нет | string |
тип_рекламы |
Пример: баннер, реклама в нижней части страницы | Нет | Нет | string |
adset_id (идентификатор группы объявлений) |
Идентификатор группы объявлений, идентифицирующий группу, содержащую одно или несколько объявлений | Нет | Нет | string |
adset_name |
Название группы объявлений, идентифицирующее группу, содержащую одно или несколько объявлений | Нет | Нет | string |
Дата, когда было обнаружено мошенничество с атрибуцией. |
Канал медиа-источника. Пример: YouTube для Google, Instagram для Meta Ads. | Нет | Нет | string |
Для получения дополнительной информации о том, как подготовить внутренние события приложения, см. раздел «Создание внутренних событий» ниже.
Создание внутренних событий приложения
Чтобы предоставлять данные о конверсиях и вовлечении с помощью событий в приложении, настройте SDK от AppsFlyer, интегрированный в ваше приложение. Подробнее о создании внутренних событий приложения в следующих разделах:
Подготовка пользовательского исходного файла
Если вы проводите внутреннюю кампанию, вы можете использовать пользовательский исходный файл в качестве источника конверсий и вовлечения по схеме, описанной в таблицах ниже.
Схема источника конверсий
Чтобы создать пользовательский исходный файл по конверсиям, используйте схему в таблице, приведённой ниже:
Схема конверсии является единой для типов кампаний вне сайта и на сайте, а также для разных медиапартнеров.
Схема конверсии является единой для типов кампаний вне сайта и на сайте, а также для разных медиапартнеров.
Медиапартнёры:
G: Google
M: Meta
Цвета фона:
Обязательные поля
Рекомендуемые поля
Требуется заполнить одно из выбранных полей
Поля хешируются в соответствии с правилами, указанными в SRN.
| Категория | Параметр | Описание | Тип | CMN | Медиапартнёры | |||
|---|---|---|---|---|---|---|---|---|
| Исходная валюта дохода | Веб | |||||||
| Г | млн. | Г | млн. | |||||
| строка | Доход, связанный с SKU, в валюте, указанной в поле event_revenue_currency. |
Уникальный идентификатор для события. | string | ✓ | ✓ | ✓ | ✓ | ✓ |
| имя_события | Название или тип события (например, "purchase", "click"). | string | ✓ | ✓ | ✓ | ✓ | ✓ | |
| время_события | Временная метка момента, когда произошло событие. | дата/время | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Информация о приложении | app_id (идентификатор приложения) | Уникальный идентификатор пользователя приложения, установленный владельцем приложения. | string | ✓ | ✓ | ✓ | ||
| имя_приложения | Название приложения. | string | ✓ | ✓ | ||||
| версия_приложения | Номер версии приложения. | string | ✓ | ✓ | ||||
| Валидация данных | facebook_browser_id | Уникальный идентификатор для отслеживания в браузере Facebook. | string | ✓ | ✓ | |||
| facebook_cookie | Идентификатор клика для атрибуции рекламы Facebook. | string | ✓ | ✓ | ||||
| gbraid | Идентификатор атрибуции рекламы Google. | string | ✓ | |||||
| google_click_id | Уникальный идентификатор для отслеживания кликов по рекламе Google. | string | ✓ | ✓ | ||||
| wbraid | Веб-идентификатор атрибуции для Google. | string | ✓ | |||||
| tiktok_id | Уникальный идентификатор для отслеживания TikTok. | string | ||||||
| Данные кампаний | campaign_id (идентификатор кампании) | Уникальный идентификатор маркетинговой кампании. | string | ✓ | ||||
| install_id | Идентификатор события установки приложения. | string | ✓ | |||||
| Импорт данных о внутренних событиях приложения | sku | SKU продуктов, участвующих в конверсии. | string | ✓ | ||||
| sku_quantity | Уникальный идентификатор продукта (SKU). | целое число | ✓ | |||||
| sku_revenue | Количество приобретенных или задействованных единиц SKU. | десятичное число | ✓ | |||||
| event_revenue | Доход, полученный в результате события. | строка | ✓ | ✓ | ✓ | ✓ | ✓ | |
| event_currency | Валюта для суммы дохода. | десятичное число | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Не применимо | client_ip | IP-адрес пользователя или устройства. | string | ✓ | ✓ | |||
| client_user_agent | Строка user agent устройства/браузера пользователя. | string | ✓ | ✓ | ✓ | |||
| категория_устройства | Категория устройства пользователя (например, мобильное устройство, настольный компьютер). | string | ✓ | |||||
| платформа (os?) | Операционная система устройства пользователя (например, iOS, Android). | string | ✓ | ✓ | ||||
| os_version | Версия операционной системы устройства. | string | ✓ | |||||
| Идентификатор пользователя | рекламный_идентификатор | Уникальный идентификатор для рекламных целей (например, IDFA). | string | ✓ | ||||
| appsflyer_id | Уникальный идентификатор приложения в AppsFlyer. | string | ✓ | |||||
| android_id | Уникальный идентификатор устройства Android. | string | ✓ | ✓ | ||||
| IDFA | Устанавливается рекламодателем | string | ✓ | ✓ | ||||
| IDFV | Идентификатор поставщика, предоставленный iOS. | string | ✓ | ✓ | ||||
| client_id | Уникальный идентификатор клиента (например, сгенерированный системой). | string | ✓ | ✓ | ✓ | |||
| facebook_hashed_client_id | правила не указаны | string | ✓ | ✓ | ||||
| tiktok_hashed_client_id | обрезка пробелов, приведение к нижнему регистру | string | ||||||
| файлы сookie | Данные cookie браузера для отслеживания пользователя/сессии. | string | ||||||
| first_name | Имя пользователя. | string | ✓ | ✓ | ✓ | |||
| last_name | Фамилия пользователя. | string | ✓ | ✓ | ✓ | |||
| phone_number | Номер телефона пользователя. | строка | ✓ | ✓ | ✓ | ✓ | ||
| дата/время | Дата рождения пользователя. | дата/время | ✓ | ✓ | ||||
| пол | Пол пользователя. | string | ✓ | ✓ | ||||
| язык | Предпочитаемый язык или региональные настройки пользователя. | string | ✓ | |||||
| электронное сообщение | Адрес электронной почты пользователя. | string | ✓ | ✓ | ✓ | ✓ | ||
| tiktok_hashed_email | Удалите пробелы, преобразуйте символы в нижний регистр и удалите точки из адресов электронной почты Google. | string | ||||||
| tiktok_hashed_phone | E164 | string | ||||||
| google_hashed_email | Удалите пробелы в начале и конце строки, преобразуйте символы в нижний регистр и удалите точки из адресов электронной почты Google. | string | ✓ | ✓ | ||||
| google_hashed_phone | E164 | string | ✓ | ✓ | ||||
| google_hashed_first_name | обрезать пробелы, перевести в нижний регистр | string | ✓ | |||||
| google_hashed_last_name | обрезать пробелы, перевести в нижний регистр | string | ✓ | |||||
| facebook_хешированная_электронная_почта | обрезать пробелы, перевести в нижний регистр | string | ✓ | ✓ | ||||
| facebook_hashed_phone | пользовательский формат (без +?) | string | ✓ | ✓ | ||||
| facebook_hashed_first_name | в нижнем регистре, без знаков препинания | string | ✓ | ✓ | ||||
| facebook_hashed_last_name | в нижнем регистре, без знаков препинания | string | ✓ | ✓ | ||||
| facebook_hashed_date_of_birth | YYYYMMDD | string | ✓ | ✓ | ||||
| facebook_hashed_gender | Рекомендуется использовать f/m, но подойдёт любое хешированное значение | string | ✓ | ✓ | ||||
| Атрибуты пользователей | att_status | Статус App Tracking Transparency (ATT) для согласия пользователя на отслеживание. | string | ✓ | ✓ | |||
| Местоположение устройства | region | Географический регион пользователя. | string | ✓ | ||||
| город | Город пользователя. | string | ✓ | ✓ | ✓ | ✓ | ||
| Состояние | Штат или область пользователя. | string | ✓ | ✓ | ✓ | ✓ | ||
| код_страны | Код ISO для страны пользователя. | string | ✓ | ✓ | ✓ | ✓ | ||
| zip_code | Почтовый индекс/ZIP-код пользователя. | string | ✓ | ✓ | ✓ | |||
| улица | Уличный адрес пользователя (если доступен). | string | ✓ | |||||
| google_hashed_street | удаление пробелов по краям, в нижнем регистре | string | ✓ | |||||
| facebook_hashed_city | в нижнем регистре, без знаков препинания, без пробелов | string | ✓ | ✓ | ||||
| facebook_hashed_state | ANSI для США, строчные буквы, без знаков препинания, без пробелов | string | ✓ | ✓ | ||||
| facebook_hashed_zip_code | специальные правила для США/Великобритании, строчные буквы, без знаков препинания, без пробелов | string | ✓ | ✓ | ||||
| facebook_hashed_country_code | Код страны на основе системы ISO 3166 (альфа-2). | string | ✓ | ✓ | ||||
| Данные о рефералах/трафике | referrer_url | URL-адрес сайта, который направил пользователя на текущую страницу. | string | ✓ | ||||
| source_url | URL-адрес источника, где пользователь впервые взаимодействовал с кампанией. | string | ✓ | |||||
Подготовьте пользовательский источник вовлеченности
Используйте схему приведённую ниже, чтобы создать источник данных о вовлечении.
Примечание:
Поля для указания персональных данных, сопоставленные в схеме источника данных о вовлечении, должны иметь непустое пересечение с персональными данными, сопоставленными в схеме источника конверсии выше.
| Поле | Описание | Обязательно | Ожидаемый тип значения |
|---|---|---|---|
appsflyer_id |
Уникальный идентификатор, генерируемый SDK при установке приложения. | Необязательное поле c персональными данными. Одно из полей c персональными данными является обязательным. | string |
cuid |
Уникальный идентификатор пользователя приложения, установленный владельцем приложения. | Необязательное поле c персональными данными. Одно из полей c персональными данными является обязательным. | string |
IDFA |
Сбрасываемый рекламный идентификатор пользователя для устройств на iOS. Если недоступно, заполняется нулями. | Необязательное поле c персональными данными. Одно из полей c персональными данными является обязательным. | string |
IDFV |
Идентификатор поставщика, предоставленный iOS. | Необязательное поле c персональными данными. Одно из полей c персональными данными является обязательным. | string |
app_id (идентификатор приложения) |
Уникальный идентификатор приложения в AppsFlyer. Пример: iOS: id123456789, Android: com.appsflyer.referrersender
|
НЕОБЯЗАТЕЛЬНОЕ | string |
campaign_id (идентификатор кампании) |
Идентификатор кампании | Обязательно | string |
campaign_name |
Название кампании | НЕОБЯЗАТЕЛЬНОЕ | string |
медиа-источник |
Медиа-источник, атрибутированный событию или ограниченный (подробнее) | Обязательно | string |
тип_взаимодействия |
Позволяет различать клики и показы | Обязательно | string |
имя_события |
Устанавливается рекламодателем | Обязательно | string |
время_события |
Время события, округляется до ближайшего часа | Обязательно | дата/время |
имя_приложения |
Устанавливается рекламодателем | НЕОБЯЗАТЕЛЬНОЕ | string |
версия_приложения |
Устанавливается рекламодателем | НЕОБЯЗАТЕЛЬНОЕ | string |
ad_id (идентификатор объявления) |
Идентификатор рекламы | НЕОБЯЗАТЕЛЬНОЕ | string |
ad_name |
Название рекламы | НЕОБЯЗАТЕЛЬНОЕ | string |
тип_рекламы |
Пример: баннер, реклама в нижней части страницы | НЕОБЯЗАТЕЛЬНОЕ | string |
adset_id (идентификатор группы объявлений) |
Идентификатор группы объявлений, идентифицирующий группу, содержащую одно или несколько объявлений | НЕОБЯЗАТЕЛЬНОЕ | string |
adset_name |
Название группы объявлений, идентифицирующее группу, содержащую одно или несколько объявлений | НЕОБЯЗАТЕЛЬНОЕ | string |
Дата, когда было обнаружено мошенничество с атрибуцией. |
Канал медиа-источника. Пример: YouTube для Google, Instagram для Meta Ads. | НЕОБЯЗАТЕЛЬНОЕ | string |
platform |
Платформа устройства: iOS, Android или Windows Mobile | НЕОБЯЗАТЕЛЬНОЕ | string |
Для получения дополнительной информации о подготовке источников и загрузке их в вашу облачную службу, см. раздел «Создание и подключение пользовательских источников данных» этого документа.
Подготовка источника сопоставления кампаний
Источник ваших данных о сопоставлении кампаний – это пользовательский файл источника данных со схемой, описанной в таблице ниже.
Примечание:
Мы рекомендуем использовать один файл сопоставления для всех совместных работ, так как это проще в работе и обновлении.
Схема сопоставления кампаний
Используйте схему приведённую ниже, чтобы создать схему сопоставления кампаний.
| Тип поля | Обязательно? | Ожидаемое значение | Описание |
|---|---|---|---|
| collaborator_name | Да | string | Лицо, с которым ведётся совместная работа. |
| collaborator_id | Да | string | Уникальный идентификатор лица, с которым ведётся совместная работа. |
| campaign_id (идентификатор кампании) | Да | string | Уникальный идентификатор кампании. |
| conversion_targets | Да | массив строк | Параметр со списком целевых SKU кампании, разделённых запятыми. Например sku1, sku2 и т. д. |
| campaign_name | Ни один | string | Название кампании. |
Для получения дополнительной информации о создании файлов источников и загрузке их в вашу облачную службу, см. раздел «Создание и подключение пользовательских источников данных» этого документа.
Процесс импорта данных о задачах атрибуции
Каждое задание по атрибуции охватывает один день и выполняется после его окончания. В начале этого процесса происходит импорт соответствующих данных о конверсиях, вовлечённости и сопоставлении кампаний из облачного сервиса или из внутренних событий в приложении.
Импорт источника сопоставления кампаний
Перед каждым запуском атрибуции DCP загружает записи сопоставления кампаний из пользовательского источника. Вы можете выбрать один из двух режимов загрузки этих записей:
-
Стратегия последней даты: DCP использует самые последние записи в зависимости от даты загрузки записи.
Например, если источник содержит записи с датами загрузки 18 января, 17 января и 29 декабря, то система выберет записи от 18 января.
- Стратегия соответствия дат: DCP использует только те записи, дата загрузки которых совпадает с днём запуска атрибуции. Например, если запуск состоится 19 января в полночь, система выберет только записи кампании с датой загрузки 19 января.
Импорт источников конверсии
В конце каждого дня DCP выполняет задание атрибуции за этот день только в том случае, если у неё есть доступ к папке за этот день и записям конверсий в ней. Однако вы можете загрузить папку за определённый день и позже. Например, папку за 17 января вы можете загрузить 22 января.
- В конце каждого дня DCP выполняет задание атрибуции за этот день. Задание будет запущено только в том случае, если DCP сможет найти папку за этот день. Название папки идентично дате за этот день.
- Папка с данными за день может содержать записи о событиях, произошедших за 30 дней до даты этой папки. Например, в папке за 17 января могут обрабатываться записи с 18 декабря по 17 января.
- Если вы пропустите загрузку папки в определённый день, у вас будет 30 дней на её загрузку. Например, если вы пропустили загрузку папки за 17 января, вы можете загрузить её до 17 февраля. Однако мы рекомендуем загружать данные как можно ближе к фактической дате.
- Если DCP не найдёт папку текущего дня, она будет выполнять поиск папки каждые 10 минут в течение следующих 7 дней.
Схема источника вовлечения
Для каждой записи конверсии DCP ищет события вовлечения, которые её вызвали.
- Записи о вовлечении содержатся в папках по датам. Однако вам не нужно каждый день загружать папку с данными о вовлечении. Например, вы можете загрузить папку за 13 и 15 января, не загружая папку за 14 января. В этом примере записи за 14 января будут взяты из папки от 15 января.
- Задача по атрибуции для данной папки конверсии начнёт выполняться только в том случае, если имеется папка по вовлечению с той же датой, что и папка конверсии, либо же с более поздней датой. К примеру, задание атрибуции для папки конверсии от 17 января начнёт выполняться только в том случае, если имеется папка с данными о вовлечении за 17 января или более поздние даты, например за 18 января.
- Задание атрибуции собирает все события взаимодействия, попадающие в окно атрибуции вовлечённости.
Импорт данных о внутренних событиях приложения
Данные о конверсии и вовлечении могут поступать из внутренних событий приложения, пользовательских источников или сочетания этих двух источников. DCP позволяет выбрать, использовать ли один режим или комбинировать их, благодаря чему можно использовать конверсии из внутренних событий приложения, а вовлечение из пользовательских файлов, либо наоборот.
При настройке внутренних событий приложения для конверсий, вовлечения или и того, и другого, вам нужно указать идентификатор приложения и название события конверсии или вовлечения. В конце дня задание атрибуции выбирает все события с указанным именем и идентификатором приложения, в которых дата события совпадает с датой конверсии.
Создание и подключение пользовательских источников данных
Чтобы подключить данные через пользовательские источники, клиенту сначала необходимо выполнить действия, описанные в следующих статьях, посвящённых DCP:
- Платформа для совместной работы с данными (DCP) – настройка облачных сервисов
- Платформа для совместной работы с данными (DCP) – добавление подключений
- Платформа для совместной работы с данными (DCP) – создание источников и управление ими