Краткий обзор: Узнайте, как создавать источники данных измерений и как предоставить к ним доступ таким образом, чтобы они могли быть применены и обработаны в процессе атрибуции.
Обзор
Первый шаг в настройке процесса измерения включает в себя подготовку трёх типов входных данных: конверсии, вовлечённость и сопоставление кампаний. Эти входные данные должны быть подготовлены на основе опредёленной заранее схемы или структуры события, в зависимости от режима предоставления данных: внутренние события приложения или пользовательские исходные файлы.
Если в режиме предоставления данных используются пользовательские исходные файлы, процесс атрибуции запускается автоматически при загрузке необходимых папок с записями о конверсии и вовлечённости в облако. В режиме внутренних событий приложения процесс запускается при выборе соответствующих внутренних событий приложения.
Подготовка внутренних событий приложения
Вы можете отправлять данные о конверсии и вовлечённости через внутренние события приложения, отправляемые 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 |
engagement_type |
Позволяет различать клики и показы | Да | Нет | string |
media_source |
Медиа-источник, атрибутированный событию или ограниченный (подробнее) | Да | Нет | string |
ad_id |
Идентификатор рекламы | Нет | Нет | string |
ad_name |
Название рекламы | Нет | Нет | string |
ad_type |
Пример: баннер, реклама в нижней части страницы | Нет | Нет | string |
adset_id |
Идентификатор группы объявлений, идентифицирующий группу, содержащую одно или несколько объявлений | Нет | Нет | string |
adset_name |
Название группы объявлений, идентифицирующее группу, содержащую одно или несколько объявлений | Нет | Нет | string |
channel |
Канал медиа-источника. Пример: YouTube для Google, Instagram для Meta Ads. | Нет | Нет | string |
Для получения дополнительной информации о том, как подготовить внутренние события приложения, см. раздел «Создание внутренних событий» ниже.
Создание внутренних событий приложения
Чтобы предоставлять данные о конверсиях и вовлечении с помощью событий в приложении, настройте SDK от AppsFlyer, интегрированный в ваше приложение. Подробнее о создании внутренних событий приложения в следующих разделах:
Подготовка пользовательского исходного файла
Если вы проводите внутреннюю кампанию, вы можете использовать пользовательский исходный файл в качестве источника конверсий и вовлечения по схеме, описанной в таблицах ниже.
Схема источника конверсий
Чтобы создать пользовательский исходный файл по конверсиям, используйте схему в таблице, приведённой ниже:
Поле | Описание | Обязательно ли для пользовательского источника данных? | Ожидаемый тип значения | Валидация данных |
---|---|---|---|---|
appsflyer_id |
Уникальный идентификатор, генерируемый SDK при установке приложения. Он используется для атрибуции внутренних событий в приложении, получения данных о конверсии и аффилирования внутренних событий в приложении. Если приложение удалено и установлено заново, генерируется новый идентификатор. Восстановление приложения из резервной копии iCloud не считается установкой. Для CTV это поле заполняется значением custom_device_id , которое управляется рекламодателем. |
Необязательное поле c персональными данными. Одно из полей c персональными данными является обязательным. | строка | Отсутствует |
advertising_id |
Идентификатор устройства, который пользователь может сбросить, он же GAID. Для CTV это CTV ID, например, RIDA или VIDA. | Необязательное поле c персональными данными. Одно из полей c персональными данными является обязательным. | строка | Отсутствует |
cuid |
Уникальный идентификатор пользователя приложения, установленный владельцем приложения. | Необязательное поле c персональными данными. Одно из полей c персональными данными является обязательным. | строка | Отсутствует |
android_id |
Постоянный идентификатор устройства | Необязательное поле c персональными данными. Одно из полей c персональными данными является обязательным. | строка | Отсутствует |
idfa |
Сбрасываемый рекламный идентификатор пользователя на устройствах iOS. Если idfa недоступно, обычно заполняется нулями. |
Необязательное поле c персональными данными. Одно из полей c персональными данными является обязательным. | строка | Отсутствует |
idfv |
Идентификатор поставщика, предоставленный iOS. | Необязательное поле c персональными данными. Одно из полей c персональными данными является обязательным. | строка | Отсутствует |
event_name |
Тип события атрибуции или название внутреннего события приложения, отправляемого приложением. Примеры типов событий: установка, повторное вовлечение и т. д. Для Data Locker в отчётах по ретаргетингу: ретаргетинг означает повторное вовлечение, а установка означает повторную атрибуцию. Для SKAN название внутреннего события приложения настраивается в AppsFlyer или Meta Ads. | Обязательно | строка | Отсутствует |
event_time |
Время события, округляется до ближайшего часа. | Обязательно | дата/время | Отсутствует |
sku |
Идентификатор товарной позиции (SKU) для одной из позиций, включённых в событие конверсии. | Обязательно | строка | Отсутствует |
sku_quantity |
Количество единиц SKU, включённых в событие конверсии. | Обязательно | целое число | Отсутствует |
app_id |
Уникальный идентификатор приложения в AppsFlyer. Пример: iOS: id123456789, Android: com.appsflyer.referrersender | Необязательный | строка | Отсутствует |
app_name |
Устанавливается рекламодателем | Необязательный | строка | Отсутствует |
app_version |
Устанавливается рекламодателем | Необязательный | строка | Отсутствует |
city |
Наиболее детальное местоположение пользователя на основе IP-адреса устройства. Обычно содержит название города, но может также включать район или округ. | Необязательный | строка | Отсутствует |
country_code |
Код страны на основе системы ISO 3166 (альфа-2). Пример: US, CN. Примечание: Для Великобритании используется код UK, а не GB. | Необязательный | строка | Отсутствует |
device_category |
Возможные значения: phone (телефон), tablet (планшет) и т.д. | Необязательный | строка | Отсутствует |
event_currency |
Код валюты дохода от события, переданный в SDK. | Необязательный | строка | структура даты и времени в соответствии с требованиями формата DCR |
event_revenue |
Значение дохода в определённой для дохода от событий валюте Суммы, выходящие за пределы диапазона от -$10 000 до +$10 000 (или эквивалентная сумма), отображаются в сырых данных, но не в агрегированных отчётах. | Необязательный | десятичное число | Отсутствует |
platform |
Платформа устройства: iOS, Android или Windows Mobile | Необязательный | строка | Отсутствует |
region |
На основании IP адреса устройства, указанного SDK. Для SKAN определяется в соответствии с кодом страны country_code . |
Необязательный | строка | Отсутствует |
sku_revenue |
Доход, связанный с SKU, в валюте, указанной в поле event_revenue_currency . |
Необязательный | десятичное число | Отсутствует |
state |
На основании IP адреса устройства, указанного SDK. | Необязательный | строка | Отсутствует |
Схема источника вовлечения
Используйте схему приведённую ниже, чтобы создать источник данных о вовлечении.
Примечание
Поля для указания персональных данных, сопоставленные в схеме источника данных о вовлечении, должны иметь непустое пересечение с персональными данными, сопоставленными в схеме источника конверсии выше.
Поле | Описание | Обязательно? | Ожидаемый тип значения |
---|---|---|---|
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 |
media_source |
Медиа-источник, атрибутированный событию или ограниченный (подробнее) | Обязательно | string |
engagement_type |
Позволяет различать клики и показы | Обязательно | string |
event_name |
Устанавливается рекламодателем | Обязательно | string |
event_time |
Время события, округляется до ближайшего часа | Обязательно | datetime |
app_name |
Устанавливается рекламодателем | Необязательный | string |
app_version |
Устанавливается рекламодателем | Необязательный | string |
ad_id |
Идентификатор рекламы | Необязательный | string |
ad_name |
Название рекламы | Необязательный | string |
ad_type |
Пример: баннер, реклама в нижней части страницы | Необязательный | string |
adset_id |
Идентификатор группы объявлений, идентифицирующий группу, содержащую одно или несколько объявлений | Необязательный | string |
adset_name |
Название группы объявлений, идентифицирующее группу, содержащую одно или несколько объявлений | Необязательный | string |
channel |
Канал медиа-источника. Пример: YouTube для Google, Instagram для Meta Ads. | Необязательный | string |
platform |
Платформа устройства: iOS, Android или Windows Mobile | Необязательный | string |
Для получения дополнительной информации о подготовке источников и загрузке их в вашу облачную службу, см. раздел «Создание и подключение пользовательских источников данных» этого документа.
Подготовка источника сопоставления кампаний
Источник ваших данных о сопоставлении кампаний – это пользовательский файл источника данных со схемой, описанной в таблице ниже.
Примечание
Мы рекомендуем использовать один файл сопоставления для всех совместных работ, так как это проще в работе и обновлении.
Схема сопоставления кампаний
Используйте схему приведённую ниже, чтобы создать схему сопоставления кампаний.
Тип поля | Обязательно? | Ожидаемое значение | Описание |
---|---|---|---|
collaborator_name | Да | строка | Лицо, с которым ведётся совместная работа. |
collaborator_id | Да | строка | Уникальный идентификатор лица, с которым ведётся совместная работа. |
campaign_id | Да | строка | Уникальный идентификатор кампании. |
conversion_targets | Да | массив строк | Параметр со списком целевых SKU кампании, разделённых запятыми. Например sku1, sku2 и т. д. |
Для получения дополнительной информации о создании файлов источников и загрузке их в вашу облачную службу, см. раздел «Создание и подключение пользовательских источников данных» этого документа.
Процесс импорта данных о задачах атрибуции
Каждое задание по атрибуции охватывает один день и выполняется после его окончания. В начале этого процесса происходит импорт соответствующих данных о конверсиях, вовлечённости и сопоставлении кампаний из облачного сервиса или из внутренних событий в приложении.
Импорт источника сопоставления кампаний
Перед каждым запуском атрибуции 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: