Краткий обзор. Cost ETL, в составе AppsFlyer ROI360, предоставляет рекламодателям данные о затратах на кампанию с максимальной детализацией по медиа-источникам. Данные, обновляемые 4 раза в день, доставляются в вашу корзину AWS S3 или GCS и готовы к загрузке в BI-системы рекламодателей.
Принципы 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 пакетные папки в день.
- Обзор: 4 пакетные папки в день.
Пример структуры каталогов
Структура каталога
/<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 |
Показатель данных:
|
file_name |
|
Номер файла Parquet |
|
Структура имени файла
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 |
Операционная система устройства. Возможные значения:
|
Да |
Строка |
- |
agency (агентство) |
Агентство, ответственное за размещение рекламы |
Нет |
Строка |
- |
campaign (кампания) |
Компонент рекламной иерархии |
Нет |
Строка |
- |
campaign_id (идентификатор кампании) |
Компонент рекламной иерархии |
Нет |
Строка |
- |
adset (группа объявлений) |
Компонент рекламной иерархии |
Нет |
Строка |
- |
adset_id (идентификатор группы объявлений) |
Компонент рекламной иерархии |
Нет |
Строка |
- |
ad (объявление) |
Компонент рекламной иерархии |
Нет |
Строка |
- |
ad_id (идентификатор объявления) |
Компонент рекламной иерархии |
Нет |
Строка |
- |
ad_account |
|
Нет |
Строка |
- |
currency (валюта) |
Валюта расходов рекламодателя, определенная для приложения в AppsFlyer |
Да |
Строка из 3 символов, соответствующая стандарту ISO-4217 |
✓ |
original_currency |
Валюта расходов, указанная сетью до каких-либо конверсий |
Да |
Строка из 3 символов, соответствующая стандарту ISO-4217 |
- |
timezone (часовой пояс) |
|
Да |
Строка |
- |
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 (показы) |
|
Да. Если для конкретной метрики нет значений, в ней проставляется 0. |
Целое число |
✓ |
clicks (клики) |
|
Целое число |
✓ |
|
reported_impressions (переданные показы) |
Подсчитываются медиа-источником |
Целое число |
✓ |
|
reported_clicks (переданные клики) |
Подсчитываются медиа-источником |
Целое число |
✓ |
|
installs (установки) |
Подсчитываются AppsFlyer |
Целое число |
✓ |
|
reported_conversions (переданные конверсии) |
Подсчитываются медиа-источником |
Целое число |
|
|
re_engagements |
Подсчитываются AppsFlyer |
Целое число |
✓ |
|
re_attributions (реатрибуция) |
Подсчитываются AppsFlyer |
Целое число |
✓ |
|
cost (затраты) |
Сумма расходов (включая сборы агентства, если есть) |
Значение |
✓ |
|
original_cost |
Стоимость, указанная сетью, в валюте, указанной сетью, до конвертации валют (с добавлением сборов агентства, рассчитанных AppsFlyer, если они есть) |
Значение |
- |
|
impressions_discrepancy (расхождение в количестве показов) |
|
Целое число |
- |
|
clicks_discrepancy (расхождение в количестве кликов) |
|
Целое число |
- |
|
installs_discrepancy (расхождение в установках) |
|
Целое число |
- |
|
fees (комиссия) |
Сборы, взимаемые агентством в дополнение к обычной стоимости рекламы. Подсчитываются AppsFlyer |
Да |
Целое число |
- |
cost_without_fees (затраты без комиссий) |
Затраты за вычетом сборов агентства. Подсчитываются AppsFlyer |
Да |
Целое число |
- |
original_cost_without_fees |
Изначальные затраты, указанные рекламной сетью, без сборов агентства. |
Да |
Целое число |
- |
CTR |
|
Нет |
Целое число |
- |
CVR |
|
Целое число |
- |
|
ecpm |
|
Целое число |
- |
|
cpi |
|
Целое число |
- |
|
ccvr |
|
Целое число |
- |
|
cvvr |
|
Целое число |
- |
|
reported_cvr |
|
Целое число |
- |
|
ecpc |
|
Целое число |
- |
|
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 в настоящее время находится в бета-версии.
Чтобы настроить корзину AWS и Cost ETL:
- Войдите в консоль AWS.
- Откройте сервис S3.
- Создайте корзину:
- Нажмите Создать корзину.
- Заполните имя корзины следующим образом: Начните с обязательного префикса
af-xpend-cost-etl-acc-
, а затем добавьте суффикс в виде свободного текста.- - Ваш
af-account-id
можно найти в пользовательском интерфейсе AppsFlyer, как указано в следующих шагах 7-9. - См. требования к названию корзины Amazon S3.
- Ваш
- Нажмите Создать корзину.
- В AppsFlyer в боковом меню выберите Экспорт > Cost ETL.
- Включите Cost ETL.
- В разделе Расписание отчетов выберите, когда вы хотите получить первый отчет. Последующие отчеты поступают с интервалом примерно в 6 часов.
- Перейдите к настройкам Amazon S3.
- Выберите регион корзины S3 из выпадающего списка.
Если ваш регион не отображается, обратитесь к своему менеджеру. - Введите имя корзины Amazon S3.
- Нажмите Далее.
Отобразится фрагмент кода политики корзины.
- Скопируйте фрагмент кода и вставьте его в настройки AWS.
- В AWS выберите корзину, которое вы создали для Cost ETL.
- Перейдите на вкладку Разрешения.
- В разделе Политика корзины нажмите Редактировать.
- Откроется окно политики корзины.
- Вставьте фрагмент политики корзины в окно.
- В настройках AppsFlyer Cost ETL нажмите кнопку Далее.
На экране отобразится шаг Подтвердите корзину. - Нажмите Подтвердить.
Убедитесь, что на экране отображается надпись Подтверждение успешно. - Нажмите Далее.
- Выберите одно, несколько или все приложения. Выберите все, чтобы автоматически включать приложения, которые вы добавите в будущем.
- Нажмите Применить.
- Выберите хотя бы один гарантированный показатель: канал и/или гео.
- Выберите хотя бы один дополнительный показатель.
- Выберите хотя бы одну метрику, которая будет включена в отчеты.
- Нажмите Применить.
Настройка Cost ETL для GCS
Эта процедура настройки должна выполняться пользователем-администратором.
Прежде чем начать:
- Настройка Cost ETL состоит из настройки вашей корзины GCS (и предоставления AppsFlyer разрешения на запись данных в нее) и настройки Cost ETL в AppsFlyer.
- Чтобы завершить настройку Cost ETL, вам понадобятся права администратора GCS и доступ к пользовательскому интерфейсу AppsFlyer.
- Во время настройки держите открытыми вкладки GCS и AppsFlyer.
Чтобы настроить корзину GCS и Cost ETL:
- Войдите в консоль GCS.
- Создайте корзину.
Назовите корзину следующим образом:- Начните с обязательного префикса
af-xpend-cost-etl-acc-
, а затем добавьте суффикс в виде свободного текста.- - Ваш
af-account-id
можно найти в пользовательском интерфейсе AppsFlyer, как указано в следующих шагах 6-8. - См. требования к названиям корзин GCS.
- Начните с обязательного префикса
- В AppsFlyer в боковом меню выберите Экспорт > Cost ETL.
- Включите Cost ETL.
- В разделе Расписание отчетов выберите, когда вы хотите получить первый отчет. Последующие отчеты поступают с интервалом примерно в 6 часов.
- Перейдите к пункту назначения данных и выберите .
- Введите название вашей корзины GCS.
- Нажмите Далее.
Отобразится аккаунт службы AppsFlyer, который будет использоваться для установки разрешений GCS. - В консоли GCS установите разрешения IAM для корзины:
-
Добавьте аккаунт службы AppsFlyer как основной в корзину Cost ETL.
- Назначьте роль «Администратор объекта хранилища».
-
- В настройках AppsFlyer Cost ETL нажмите кнопку Далее.
На экране отобразится шаг Подтвердите корзину. - Нажмите Подтвердить.
Убедитесь, что на экране отображается надпись Подтверждение успешно. - Нажмите Далее.
- Выберите одно, несколько или все приложения. Выберите все, чтобы автоматически включать приложения, которые вы добавите в будущем.
- Нажмите Применить.
- Выберите хотя бы один гарантированный показатель: канал и/или гео.
- Выберите хотя бы один дополнительный показатель.
- Выберите хотя бы одну метрику, которая будет включена в отчеты.
- Нажмите Применить.
Владение объектами AWS
В AWS по умолчанию, когда AppsFlyer записывает объекты в вашу корзину, владельцем объекта является AppsFlyer. В зависимости от процесса загрузки данных вам, возможно, придется изменить владельца по умолчанию на вас как владельца корзины.
Чтобы изменить права собственности на объекты в вашей корзине:
-
Войдите в консоль управления AWS Management Console и откройте консоль Amazon S3 по адресу https://console.aws.amazon.com/s3/.
-
В списке Корзины выберите имя корзины, для которой нужно включить S3 Object Ownership (владение объектами S3).
-
Перейдите на вкладку Разрешения.
-
В разделе Владение объектом нажмите Редактировать.
-
ВыберитеПредпочтительно владелец корзины.
-
Нажмите Сохранить.
Практические рекомендации
Переопределение данных
При извлечении и анализе данных рекомендуется извлекать данные за определенную дату и определенный пакет, или перезаписывать предыдущие данные за те дни, за которые предоставляет текущий пакет. В противном случае вы можете увидеть повторение одних и тех же данных.
Например, пакет 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, который может составлять от нескольких КБ до нескольких ГБ. |