Чем мы можем помочь?

Платформа для совместной работы с данными (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
тип_взаимодействия Позволяет различать клики и показы Да Нет 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: