Платформа для совместной работы с данными (DCP) – совместные измерения

Краткий обзор: Узнайте, как создавать источники данных измерений и как предоставить к ним доступ таким образом, чтобы они могли быть применены и обработаны в процессе атрибуции.

Обзор

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

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

Подготовка внутренних событий приложения

Вы можете отправлять данные о конверсии и вовлечённости через внутренние события приложения, отправляемые 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: