Cost ETL — Детализация затрат на кампанию в корзине

Премиум

Краткий обзор. Cost ETL, в составе AppsFlyer ROI360, предоставляет рекламодателям данные о затратах на кампанию с максимальной детализацией по медиа-источникам. Данные, обновляемые 4 раза в день, доставляются в вашу корзину AWS S3 или GCS и готовы к загрузке в BI-системы рекламодателей.

5896_CostETL_graphic__2_.png

Принципы Cost ETL

Данные о затратах на кампанию записываются:

  • В корзину — для просмотра, передачи и загрузки данных о затратах в ваши системы.
  • В корзину четыре раза в день (актуальность данных: в течение дня).
  • Для текущего дня и предыдущих 6 дней (в данной статье они обозначаются как 7 дней), а также для дней 14, 29 и 88. Ретроспективные данные позволяют обновлять и исправлять отчетность по затратам.
  • Для затрат, сопоставленных с атрибуцией, кликом или показом.
    Примечание.
    • Данные за последние 7 дней извлекаются заново из медиа-источников. Данные за дни 14, 29 и 88 обрабатываются повторно.
    • Ретроспективно обновляются только данные о затратах, но не данные об атрибуции.

Данные предоставляются с гарантированными первичными показателями:

  • Гео: разбивка по странам
  • Канал: канал медиа-источника, например, в случае Google — YouTube

Вы можете настроить другие показатели и метрики, включенные в отчеты, в соответствии с вашими потребностями.

Посмотрите файл-образец. Примечание. Предоставленный пример — это файл Excel с разбивкой данных по каналам; файлы Cost ETL отправляются в вашу корзину в виде файлов parquet. 

Реализация

Параметры отчета

  • Отчеты предназначены для всех приложений, включенных в Cost ETL, за день, за пакет. 
  • Каждый раз, когда данные записываются в корзину, то есть 4 раза в день, записываются все доступные данные, включая историю, обновления и исправления за предыдущие 6 дней, а также за дни 14, 29 и 88. Учитывайте это в процессе загрузки данных. 
  • Структуры отчетов подробно описаны в таблице полей файла. Это следующие структуры:
    • Краткий отчет: Менее детализированный (подробный), чтобы обеспечить более простое и быстрое представление данных.
    • Отчеты по показателям: Содержат основной показатель, который гарантированно измерен. Это означает, что показатель доступен для всех медиа-источников, содержащихся в данном отчете. И напротив, если медиа-источник не предоставляет первичные данные о показателе, эти данные не включаются в отчет по конкретному показателю. Вторичные показатели указываются при наличии. Они не гарантированы.
    • Доступны следующие основные (гарантированные) показатели:
      • Геоданные: Данные сгруппированы по странам
      • Канал: Канал медиа-источника, например, YouTube в случае Google и Instagram в случае Meta ads.
    • Вам следует использовать те показатели и метрики, которые лучше всего соответствуют потребностям вашего бизнеса. Они могут отличаться в зависимости от медиа-источника.
    • [Закрытая бета-версия] Отчет о всех затратах: На основе показателя гео. Включает данные о затратах на все маркетинговые активности на всех платформах, в том числе для приложений/платформ, не добавленных в AppsFlyer (в этих случаях идентификатор приложения помечается как неизвестный).

Структура директории и имен файлов

  • Данные, записанные в корзину, имеют описанную структуру каталогов и файлов. Посмотрите файл-образецПримечание. Предоставленный пример — это файл Excel с разбивкой данных по каналам; файлы Cost ETL отправляются в вашу корзину в виде файлов parquet.
  • Когда Cost ETL завершает запись в каталог, устанавливается флаг путем создания файла success. Это всегда самая последняя временная метка в каталоге. 
  • Каждый раз, когда записываются данные, они включают в себя данные за текущий день и предыдущие 6 дней (в этой статье они обозначаются как 7 дней), а также за дни 14, 29 и 88.
  • Количество папок/файлов следующее:
    • Обзор: 4 пакетные папки в день.
      • Каждая пакетная папка содержит файлы parquet с данными за 7 дней.
    • Показатели: Каждый гарантированный показатель содержит 4 папки в день.
      • Каждая папка содержит файлы parquet, содержащие данные с нумерацией, начиная с 1.
    • [Закрытая бета-версия] Все затраты: На основе показателя гео содержит 4 пакетные папки в день.

Пример структуры каталогов

cost_etl_structure_4.jpg

Структура каталога

/<advertiser bucket name>/cost_etl/version/dt=<yyyy-mm-dd>/b=<n>/
<dimension>/<file name>

Структура каталога

Переменная

Контент

advertiser_bucket_name

Как определено в конфигурации Cost ETL: af-xpend-cost-etl-<af-account-id>-[суффикс названия вашей корзины].

cost_etl Всегда cost_etl 
version Версия Cost ETL
date

Дата затрат

Формат: гггг-мм-дд

Batch Числа: 1-4
dimension

Показатель данных:

  • geo (гео)
  • channel (канал)
file_name
  • Обзор:
  • все расходы
Номер файла Parquet
  • Нумерация начинается с 00000
  • Пример: part-

Структура имени файла 

part-<number>

Пример

Для первого извлечения данных 23 июня 2020 года структура каталогов и имен файлов выглядит следующим образом:

/bucket-name/cost_etl/v1/dt=2020-06-23/b=1/geo/part-00001

Поля файлов

Поля/показатели

Поле

Примечания

Всегда заполнено

Формат

Включено в сводный файл

date

Дата понесенных расходов, о которых сообщил медиа-источник

Да

строка гггг-мм-дд

app_id (идентификатор приложения)

Идентификатор приложения на платформе AppsFlyer

Да

Строка

media_source (медиа-источник)

Медиа-источник, ответственный за показ объявления

Да

Строка

os

Операционная система устройства. Возможные значения:

  • Android;
  • Телефон Windows
  • iOS.

Да

Строка

-

agency (агентство)

Агентство, ответственное за размещение рекламы

Нет

Строка

-

campaign (кампания)

Компонент рекламной иерархии

Нет

Строка

-

campaign_id (идентификатор кампании)

Компонент рекламной иерархии

Нет

Строка

-

adset (группа объявлений)

Компонент рекламной иерархии

Нет

Строка

-

adset_id (идентификатор группы объявлений)

Компонент рекламной иерархии

Нет

Строка

-

ad (объявление)

Компонент рекламной иерархии

Нет

Строка

-

ad_id (идентификатор объявления)

Компонент рекламной иерархии

Нет

Строка

ad_account

  • Рекламный аккаунт, из которого были взяты данные о расходах
  • Актуально для сетей, где подключение осуществляется с использованием oAuth (вход с вашими учетными данными), например, в Google или Meta

Нет

Строка

-

currency (валюта)

Валюта расходов рекламодателя, определенная для приложения в AppsFlyer

Да

Строка из 3 символов, соответствующая стандарту ISO-4217

original_currency

Валюта расходов, указанная сетью до каких-либо конверсий

Да

Строка из 3 символов, соответствующая стандарту ISO-4217

-

timezone (часовой пояс)

  • Часовой пояс данных, хранящихся в AppsFlyer
  • Иногда сети сообщают данные в другом часовом поясе по сравнению с тем, который определен в AppsFlyer. Эта точка данных помогает объяснить расхождения в затратах между AppsFlyer и сетями

Да

Строка 

-

geo (гео)

Показатель в рекламной иерархии

Нет

Строка из 2 символов, соответствующая стандарту ISO 3166

channel (канал)

Показатель в рекламной иерархии

Нет

Строка

- 

keyword_term (поисковый запрос)

Слово(а), использованное(ые) пользователем для поиска в Интернете

Да

Строка 

-

keyword_id

Идентификатор поисковых запросов ASA

Да

Строка

-

site_id (идентификатор сайта)

Идентификатор издателя

Нет

Строка 

-

campaign_objective (цель кампании)

Компонент свойств кампании. Подробнее

Нет

Строка 

-

cost_model (модель затрат)

Компонент свойств кампании. Подробнее

Нет

Строка 

-

af_cost_model

Модель затрат сопоставляется и нормализуется AppsFlyer. Компонент свойств кампании. Подробнее

Нет

Строка 

-

bid_strategy (стратегия определения ставки)

Компонент свойств кампании. Подробнее

Нет

Строка 

-

af_bid_strategy

Стратегия ставок сопоставляется и нормализуется AppsFlyer. Компонент свойств кампании. Подробнее

Нет

Строка 

-

bid_amount (сумма ставки)

Компонент свойств кампании. Подробнее

Нет

Целое число

-

original_bid_amount

Компонент свойств кампании. Подробнее

Нет

Целое число

-

Метрики

Поле

Примечания

Всегда заполнено

Формат

Включено в сводный файл

impressions (показы)

  • Подсчитываются AppsFlyer.
  • Включает в себя как UA, так и ретаргетинг.

Да.

Если для конкретной метрики нет значений, в ней проставляется 0.

Целое число

clicks (клики)

  • Подсчитываются AppsFlyer.
  • Включает в себя как UA, так и ретаргетинг.

Целое число

reported_impressions (переданные показы)

Подсчитываются медиа-источником

Целое число

reported_clicks (переданные клики)

Подсчитываются медиа-источником

Целое число

installs (установки)

Подсчитываются AppsFlyer

Целое число

reported_conversions (переданные конверсии)

Подсчитываются медиа-источником

Целое число

 

re_engagements

Подсчитываются AppsFlyer

Целое число

re_attributions (реатрибуция)

Подсчитываются AppsFlyer

Целое число

cost (затраты)

Сумма расходов (включая сборы агентства, если есть)

Значение

original_cost

Стоимость, указанная сетью, в валюте, указанной сетью, до конвертации валют (с добавлением сборов агентства, рассчитанных AppsFlyer, если они есть)

Значение 

-

impressions_discrepancy (расхождение в количестве показов)

  • Разница между показами, как они учитываются рекламной сетью и AppsFlyer
  • Не учитывайте эту метрику, если:
    • Нет соответствия между затратами и атрибуцией.
    • Рекламная сеть не поддерживает передачу показов.
Целое число

-

clicks_discrepancy (расхождение в количестве кликов)

  • Разница между количеством кликов, как они учитываются рекламной сетью и AppsFlyer
  • Не учитывайте эту метрику, если:
    • Нет соответствия между затратами и атрибуцией.
    • Рекламная сеть не поддерживает передачу кликов.
Целое число

-

installs_discrepancy (расхождение в установках)

  • Разница между количеством установок, как они учитываются рекламной сетью и AppsFlyer
  • Не учитывайте эту метрику, если:
    • Нет соответствия между затратами и атрибуцией.
    • Рекламная сеть не поддерживает передачу конверсий.
Целое число

-

fees (комиссия)

Сборы, взимаемые агентством в дополнение к обычной стоимости рекламы. Подсчитываются AppsFlyer

Да

Целое число

-

cost_without_fees (затраты без комиссий)

Затраты за вычетом сборов агентства. Подсчитываются AppsFlyer

Да

Целое число

-

original_cost_without_fees

Изначальные затраты, указанные рекламной сетью, без сборов агентства.

Да

Целое число

-

CTR

  • Коэффициент кликабельности. Подсчитывается AppsFlyer
  • Формула: Клики / показы

 

 

 

 

Нет

Целое число

-

CVR

  • Коэффициент конверсии (%) Подсчитывается AppsFlyer
  • Формула: Установка / клики
Целое число

-

ecpm

  • Подсчитываются AppsFlyer
  • Формула: (Затраты / показы) * 1000 
Целое число

cpi

  • Подсчитываются AppsFlyer
  • Формула: Затраты / установки
Целое число

ccvr

  • Цена за конверсию
  • Формула: Затраты / (установки + реатрибуции + повторные вовлечения)

Целое число

cvvr

  • Доля полных просмотров видеоролика. Подсчитывается AppsFlyer
  • Формула: Полные просмотры видео / показы
Целое число

-

reported_cvr

  • Переданный коэффициент конверсии
  • Формула: Зарегистрированные конверсии / зарегистрированные клики
Целое число

ecpc

  • Подсчитываются AppsFlyer
  • Формула: Затраты / клики
Целое число

-

video_25p_views

Просмотры 25% видео. Сообщаются рекламной сетью

Целое число

video_50p_views

Просмотры 50% видео. Сообщаются рекламной сетью

Целое число

video_75p_views

Просмотры 75% видео. Сообщаются рекламной сетью

Целое число

video_completions

Сообщается рекламной сетью

Целое число

Настройка Cost ETL для AWS S3

Эта процедура настройки должна выполняться пользователем-администратором.

Прежде чем начать:

  • Настройка Cost ETL состоит из настройки вашей корзины AWS (и предоставления AppsFlyer разрешения на запись данных в нее) и настройки Cost ETL в AppsFlyer.
  • Для завершения настройки Cost ETL вам понадобятся права администратора AWS и доступ к пользовательскому интерфейсу AppsFlyer.
  • Во время настройки держите открытыми вкладки AWS и AppsFlyer. 
  • Примечание: Поддержка шифрования корзин KMS в настоящее время находится в бета-версии.

AppsFlyerAdmin_us-en.png Чтобы настроить корзину AWS и Cost ETL:

  1. Войдите в консоль AWS.
  2. Откройте сервис S3.
  3. Создайте корзину:
    1. Нажмите Создать корзину.
    2. Заполните имя корзины следующим образом: Начните с обязательного префикса af-xpend-cost-etl-acc--, а затем добавьте суффикс в виде свободного текста.
    3. Нажмите Создать корзину.
  4. В AppsFlyer в боковом меню выберите Экспорт > Cost ETL.
  5. Включите Cost ETL.
  6. В разделе Расписание отчетов выберите, когда вы хотите получить первый отчет. Последующие отчеты поступают с интервалом примерно в 6 часов.
  7. Перейдите к настройкам Amazon S3.

  8. Выберите регион корзины S3 из выпадающего списка.
    Если ваш регион не отображается, обратитесь к своему менеджеру. 
  9. Введите имя корзины Amazon S3.
  10. Нажмите Далее.
    Отобразится фрагмент кода политики корзины.

  11. Скопируйте фрагмент кода и вставьте его в настройки AWS.
    1. В AWS выберите корзину, которое вы создали для Cost ETL. 
    2. Перейдите на вкладку Разрешения.
    3. В разделе Политика корзины нажмите Редактировать.
    4. Откроется окно политики корзины.
    5. Вставьте фрагмент политики корзины в окно.
  12. В настройках AppsFlyer Cost ETL нажмите кнопку Далее.
    На экране отобразится шаг Подтвердите корзину
  13. Нажмите Подтвердить.
    Убедитесь, что на экране отображается надпись Подтверждение успешно
  14. Нажмите Далее.
  15. Выберите одно, несколько или все приложения. Выберите все, чтобы автоматически включать приложения, которые вы добавите в будущем.
  16. Нажмите Применить
  17. Выберите хотя бы один гарантированный показатель: канал и/или гео.
  18. Выберите хотя бы один дополнительный показатель.

  19. Выберите хотя бы одну метрику, которая будет включена в отчеты. 

  20. Нажмите Применить.

Настройка Cost ETL для GCS

Эта процедура настройки должна выполняться пользователем-администратором.

Прежде чем начать:

  • Настройка Cost ETL состоит из настройки вашей корзины GCS (и предоставления AppsFlyer разрешения на запись данных в нее) и настройки Cost ETL в AppsFlyer.
  • Чтобы завершить настройку Cost ETL, вам понадобятся права администратора GCS и доступ к пользовательскому интерфейсу AppsFlyer.
  • Во время настройки держите открытыми вкладки GCS и AppsFlyer. 

AppsFlyerAdmin_us-en.png Чтобы настроить корзину GCS и Cost ETL:

  1. Войдите в консоль GCS.
  2. Создайте корзину.
    Назовите корзину следующим образом:
    • Начните с обязательного префикса af-xpend-cost-etl-acc--, а затем добавьте суффикс в виде свободного текста.
    • Ваш af-account-id можно найти в пользовательском интерфейсе AppsFlyer, как указано в следующих шагах 6-8. 
    • См. требования к названиям корзин GCS.
  3. В AppsFlyer в боковом меню выберите Экспорт > Cost ETL.
  4. Включите Cost ETL
  5. В разделе Расписание отчетов выберите, когда вы хотите получить первый отчет. Последующие отчеты поступают с интервалом примерно в 6 часов.
  6. Перейдите к пункту назначения данных и выберите .
  7. Введите название вашей корзины GCS.
  8. Нажмите Далее.
    Отобразится аккаунт службы AppsFlyer, который будет использоваться для установки разрешений GCS.
  9. В консоли GCS установите разрешения IAM для корзины:
    1. Добавьте аккаунт службы AppsFlyer как основной в корзину Cost ETL.

    2. Назначьте роль «Администратор объекта хранилища».
  10. В настройках AppsFlyer Cost ETL нажмите кнопку Далее.
    На экране отобразится шаг Подтвердите корзину
  11. Нажмите Подтвердить.
    Убедитесь, что на экране отображается надпись Подтверждение успешно
  12. Нажмите Далее.
  13. Выберите одно, несколько или все приложения. Выберите все, чтобы автоматически включать приложения, которые вы добавите в будущем.
  14. Нажмите Применить
  15. Выберите хотя бы один гарантированный показатель: канал и/или гео.
  16. Выберите хотя бы один дополнительный показатель.

  17. Выберите хотя бы одну метрику, которая будет включена в отчеты. 

  18. Нажмите Применить.

Владение объектами AWS

В AWS по умолчанию, когда AppsFlyer записывает объекты в вашу корзину, владельцем объекта является AppsFlyer. В зависимости от процесса загрузки данных вам, возможно, придется изменить владельца по умолчанию на вас как владельца корзины.  

Чтобы изменить права собственности на объекты в вашей корзине:

  1. Войдите в консоль управления AWS Management Console и откройте консоль Amazon S3 по адресу https://console.aws.amazon.com/s3/.

  2. В списке Корзины выберите имя корзины, для которой нужно включить S3 Object Ownership (владение объектами S3).

  3. Перейдите на вкладку Разрешения.

  4. В разделе Владение объектом нажмите Редактировать

  5. ВыберитеПредпочтительно владелец корзины.

  6. Нажмите Сохранить.

Практические рекомендации

Переопределение данных

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

Например, пакет 1 от 20 февраля содержит данные за 14-20 февраля. Но пакеты, записанные 19 февраля, также содержали данные за период с 14 по 19 февраля. Перезапишите данные предыдущих дней, полученные 19 февраля, данными, полученными в последнем пакете от 20 февраля.

Геоданные и канал

Не все сети предоставляют данные по всем показателям вместе. Наиболее распространенными примерами являются геоданные и канал в Meta ads. Именно поэтому представлены два отдельных набора данных. Набор геоданных гарантированно содержит геоданные, а набор данных канала гарантированно содержит данные канала.

Во многих случаях и для многих медиа-источников данные в наборах гео и каналов будут идентичны. Поэтому используйте один из наборов данных (гео или канал) в зависимости от того, что больше всего соответствует вашим потребностям.

Если в соглашении об интеграции с данным медиа-источником не указан канал, и он пуст, мы рассматриваем эти данные так, как будто они содержат канал. 

Агрегированные данные

Cost ETL обеспечивает гибкость и детальность данных, которые можно извлечь из рекламной сети. Чтобы извлечь полезную информацию из таких потенциально огромных объемов данных, рекомендуется агрегировать их таким образом, чтобы они наилучшим образом соответствовали потребностям вашего бизнеса. Например, если вам нужно понять данные о затратах на уровне кампании и страны, используйте эти показатели.

Стандартизация в сетях

Не все сети предоставляют данные с одинаковой детализацией. Например, Meta ads не предоставляет данные о затратах по идентификатору сайта, а X Ads не предоставляет данные о затратам по геолокации. Помните о таких случаях, когда вы агрегируете данные Cost ETL, и обязательно смотрите на сходные данные, когда сравниваете сети.

Сравнение данных

Cost ETL предоставляет информацию обо всех данных о затратах. Некоторые кампании, представленные в Cost ETL, не отображаются в некоторых дэшбордах AppsFlyer, например, данные неактивных кампаний, то есть кампаний, в которых не было зафиксировано ни одной установки. Чтобы сравнить данные, найдите идентификатор конкретной кампании на обзорном дэшборде и сравните его с данными о затратах в Cost ETL. Узнайте больше о доступности данных о затратах

Дополнительные сведения

Ограничения и особенности

Специфика Примечания
Часовой пояс

При изменении часового пояса данные о расходах дублируются в день и на следующий день после изменения. Подробнее

Актуальность данных

В течение дня. Во время настройки Cost ETL вы устанавливаете расписание отчетов, то есть время, когда вы хотите получать отчеты. Примечание. После того как данные о затратах попадают в вашу корзину, дальнейшая передача данных в BI-системы может сильно различаться в зависимости от отчета и размера файла parquet, который может составлять от нескольких КБ до нескольких ГБ.