Настройка и использование отчетов ROI360 cost ETL

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

• В облачный сервис или корзину — для просмотра, передачи и загрузки данных о затратах в ваши системы.
• Для всех приложений, которые вы решите включить в Cost ETL, по дням и версиям.
• До 4 раз в день (обновление данных: внутренний день).
• Для текущего дня и предыдущих 6 дней (в данной статье они обозначаются как 7 дней), а также для дней 14, 29 и 88. Учитывайте это в процессе загрузки данных. 
  • Пример: Файл содержит данные за 14 октября 2024 года (текущий день), 13 октября (1 день назад), 12 октября (2 дня назад), 11 октября (3 дня назад), 10 октября (4 дня назад), 9 октября (5 дней назад), 8 октября (6 дней назад), 30 сентября (14 дней назад), 15 сентября (29 дней назад) и 18 июля (88 дней назад).
  • Ретроспективные данные позволяют обновлять и исправлять отчетность по затратам.
• Для затрат, сопоставленных с атрибуцией, кликом или показом.
  Примечание:
  • Данные за последние 7 дней извлекаются заново из медиа-источников. Данные за дни 14, 29 и 88 обрабатываются повторно.
  • Ретроспективно обновляются только данные о затратах, но не данные об атрибуции.

Данные, записанные в облачный сервис или корзину, имеют описанную структуру каталогов и файлов:

• Когда Cost ETL завершает запись в директорию, устанавливается флаг путем создания файла успешного завершения success. Это всегда самая последняя временная метка в директории.
• Количество папок/файлов следующее:
  • Резюме: До 4 папок версии в день.
    • Каждая пакетная папка содержит файлы parquet с данными за 7 дней.
  • Отчет по гео или каналу: Каждый отчет содержит до 4 папок с версиями в день.
    • Каждая папка содержит файлы parquet, содержащие данные с нумерацией, начиная с 1.
  • [Закрытая бета-версия] Все затраты: На основе географического измерения содержит до 4 файлов в день.

Структура каталога подключений Data Locker

///t=/dt=/v=<1/2/3/4>/

Структура каталога подключений Cost ETL

/cost_etl/version/dt=/b=//

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

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

Метрики

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

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

Для настройки Cost ETL требуется:

• Облачный сервис, созданный с разрешения AppsFlyer на запись в него данных. Это означает, что вам нужно настроить один или несколько из следующих облачных сервисов:
  • Корзина AWS
  • Корзина GCS
  • [Бета] Azure Blob
  • [Бета-версия] Корзина на Яндекс
  • Локальное хранилище данных BigQuery
  • Локальное хранилище данных Snowflake
• Чтобы завершить настройку Cost ETL, вам понадобятся права администратора AppsFlyer и доступ к пользовательскому интерфейсу AppsFlyer.

To set up Cost ETL: 

1. В AppsFlyer в боковом меню выберите Экспорт > Cost ETL.
2. Выберите или настройте соединение данных:
   • Если подключения к данным уже настроены, в раскрывающемся списке Connection выберите нужные для Cost ETL.
     
   • Если у вас еще нет подключения к данным, нажмите + Новое подключение в Data Locker и создайте там подключение:
     
     1. Дайте название подключению.
        
     2. Выберите, куда в облачном сервисе должны записываться данные. Выполните одно из следующих действий:
        • Выберите S3.
          
          1. Введите название своей корзины AWS S3. Префикс af-af-af- является обязательным и должен быть введен вручную.
          2. Нажмите Тестировать подключение.
          3. Убедитесь в отсутствии сообщения об ошибке, указывающего на неверный путь к корзине.
          4. Выберите, нужно ли сделать это подключение совместимым с Adobe Experience Platform.
          5. Нажмите Сохранить.
          6. В меню Cost ETL в раскрывающемся списке Connection выберите созданный облачный сервис.
        • Выберите GCS.
          
          1. Введите название вашей корзины GCS.
          2. Нажмите Тестировать подключение.
          3. Убедитесь в отсутствии сообщения об ошибке, указывающего на неверный путь к корзине.
          4. Выберите, нужно ли сделать это подключение совместимым с Adobe Experience Platform.
          5. Нажмите Сохранить.
          6. В меню Cost ETL в раскрывающемся списке Connection выберите созданный облачный сервис.
        • [Бета] Выберите Azure.
          
          1. Введите имя подключения, имя аккаунта хранилища и ключ.
          2. Убедитесь в отсутствии сообщения об ошибке, указывающего на неверный путь к корзине.
          3. Выберите, нужно ли сделать это подключение совместимым с Adobe Experience Platform.
          4. Нажмите Сохранить.
          5. В меню Cost ETL в раскрывающемся списке Connection выберите созданный облачный сервис.
        • [Бета-версия] Выберите Яндекс.
          
          1. Введите Название корзины, Ключ доступа и Секретный ключ.
          2. Убедитесь в отсутствии сообщения об ошибке, указывающего на неверный путь к корзине.
          3. Выберите, нужно ли сделать это подключение совместимым с Adobe Experience Platform.
          4. Нажмите Сохранить.
          5. В меню Cost ETL в раскрывающемся списке Connection выберите созданный облачный сервис.
        • Выберите BigQuery.
          
          1. Введите идентификатор проекта BigQuery и имя набора данных.
          2. Нажмите Тестировать подключение.
          3. Убедитесь в отсутствии сообщения об ошибке, указывающего на неверный путь к корзине.
          4. Нажмите Сохранить.
          5. В меню Cost ETL в раскрывающемся списке Connection выберите созданный облачный сервис.
        • Выберите Snowflake.
          
          1. Введите свой регион Snowflake и идентификатор аккаунта.
          2. Нажмите Тестировать подключение.
          3. Убедитесь в отсутствии сообщения об ошибке, указывающего на неверный путь к корзине.
          4. Нажмите Сохранить.
          5. В меню Cost ETL в раскрывающемся списке Connection выберите созданный облачный сервис.
3. Нажмите Далее.
   
4. Задайте расписание версий (UTC):
   
   1. Выберите, сколько отчётов вы хотите получать каждый день (1, 2, 3 или 4).
   2. Выберите, в какое время вам удобнее получать отчёты. Подробнее
   3. Нажмите Далее.
5. Настройте сведения в отчёте:
   1. Выберите одно или несколько приложений, данные которых нужно включить в отчёты. Выберите Добавить все будущие приложения, чтобы автоматически включать приложения, которые вы добавите в будущем.
      
   2. Выберите отчёты, наиболее соответствующие потребностям вашего анализа. См. описания в разделе Типы отчётов.
      • Сводный отчет выбран по умолчанию.
      • Для получения отчета «Все затраты» необходимо выбрать Отчёт по данным регионов.
        
   3. Выберите параметры для включения в отчёты. Примечание: Если вам необходим отчёт по регионам, региональные параметры включаются по умолчанию. Если вам необходим отчёт по каналам, параметр канала включаются по умолчанию. 
      
   4. Выберите параметры для включения в отчёты. 
      
6. Нажмите Применить.

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

Примечание: После переключения на существующее подключение вы не сможете вернуться к предыдущему подключению Cost ETL.

Редактировать подключение

Как вносить изменения в детали подключения:

1. В AppsFlyer в боковом меню выберите Экспорт > Cost ETL.
2. В разделе подключения данных:
   • Для подключений Data Locker в раскрывающемся списке Подключения наведите курсор на подключение, которое вы хотите изменить. Отображение деталей подключения. Нажмите Редактировать в Data Locker.
     
   • Чтобы узнать о подключениях Cost ETL, нажмите раскрывающееся меню Сведения о подключении. Отображение деталей подключения.
     
3. Следуйте инструкциям на экране, чтобы изменить детали подключения.
4. Нажмите Сохранить изменения или Применить по запросу.

Изменить подключение к Data Locker

Чтобы перейти от одного подключения к Data Locker к другому:

1. В AppsFlyer в боковом меню выберите Экспорт > Cost ETL.
2. В разделе подключения данных:
   • Если нужные вам подключения к Data Locker уже настроены, в раскрывающемся списке Connection выберите нужные для Cost ETL.
     
   • Если у вас ещё не настроено нужное вам подключение к Data Locker, нажмите + Новое подключение в Data Locker и создайте там подключение. Затем вернитесь к настройкам Cost ETL и выберите их из выпадающего меню Подключение.
     
3. Нажмите Сохранить изменения.

Переход от Cost ETL к подключению Data Locker

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

• Учитывайте, что после перехода на подключение к Data Locker вы не сможете вернуться к предыдущему подключению Cost ETL.
• Обратите внимание, что при переходе на подключение к Data Locker структура пути к папке меняется на следующий формат, при этом данные в отчёте остаются без изменений:

  ///t=/dt=/v=<1/2/3/4>/

Чтобы перейти от устаревшего подключения к Cost ETL к подключению к Data Locker:

1. В AppsFlyer в боковом меню выберите Экспорт > Cost ETL.
2. В разделе Подключение к данным нажмите Подключения к Data Locker.
   
3. Чтобы настроить подключение к Data Locker, выполните одно из следующих действий:
   • Если у вас уже настроены нужные вам подключения, в раскрывающемся списке Подключение выберите нужные для Cost ETL.
     
   • Если у вас ещё не настроено нужное вам подключение, нажмите + Новое подключение в Data Locker и создайте там подключение. Затем вернитесь к настройкам Cost ETL и выберите их из выпадающего меню Подключение.
     
4. Нажмите Сохранить изменения.

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

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

1. Войдите в консоль управления AWS Management Console и откройте консоль Amazon S3 по адресу https://console.aws.amazon.com/s3/.
2. В списке Корзины выберите имя корзины, для которой нужно включить S3 Object Ownership (владение объектами S3).
3. Перейдите на вкладку Разрешения.
4. В разделе Владение объектом нажмите Редактировать.
5. ВыберитеПредпочтительно владелец корзины.
6. Нажмите Сохранить.

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

При выборе расписания отчётов: 

• Выберите время получения отчёта как можно ближе к моменту начала обработки данных в вашей BI-системе.
• Если какие-либо рекламные сети предоставляют вам данные за вчерашний день позже других, задайте дополнительный отчёт в момент готовности этих данных рекламной сети.

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

Например, пакет 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. Узнайте больше о доступности данных о затратах

Чтобы получить полные данные о затратах, связанные с атрибуцией для Google, Meta, TikTok (мобайл и др.) и других медиаисточников (только для мобайла), используйте следующий запрос:

with etl as (
    select *
    from etl
    where media_source = 'Facebook Ads'
      and date = '2025-07-16'
),

allcost as (
    select *
    from allcost
    where media_source = 'Facebook Ads'
      and date = '2025-07-16'
),

main as (
    select
        case when etl.date is null then 'all cost' else 'cost etl' end as report,
        coalesce(etl.date, allcost.date) as date,
        coalesce(etl.app_id, allcost.app_id) as app_id,
        etl.os,
        allcost.platform,
        coalesce(etl.media_source, allcost.media_source) as media_source,
        coalesce(etl.agency, allcost.agency) as agency,
        coalesce(etl.campaign_id, allcost.campaign_id) as campaign_id,
        coalesce(etl.campaign, allcost.campaign) as campaign,
        coalesce(etl.adset_id, allcost.adset_id) as adset_id,
        coalesce(etl.adset, allcost.adset) as adset,
        coalesce(etl.ad_id, allcost.ad_id) as ad_id,
        coalesce(etl.ad, allcost.ad) as ad,
        coalesce(etl.geo, allcost.geo) as geo,
        coalesce(etl.channel, allcost.channel) as channel,
        coalesce(etl.site_id, allcost.site_id) as site_id,
        coalesce(etl.ad_account, allcost.ad_account) as ad_account,
        coalesce(etl.keyword_id, allcost.keyword_id) as keyword_id,
        coalesce(etl.keywords, allcost.keywords) as keywords,
        coalesce(etl.campaign_objective, allcost.campaign_objective) as campaign_objective,
        coalesce(etl.af_cost_model, allcost.af_cost_model) as af_cost_model,
        coalesce(etl.bid_strategy, allcost.bid_strategy) as bid_strategy,
        coalesce(etl.af_bid_strategy, allcost.af_bid_strategy) as af_bid_strategy,
        coalesce(etl.currency, allcost.currency) as currency,
        coalesce(etl.cost, allcost.cost) as cost,
        coalesce(etl.impressions, allcost.impressions) as impressions,
        coalesce(etl.clicks, allcost.clicks) as clicks,
        coalesce(etl.installs, allcost.installs) as installs,
        coalesce(etl.re_attributions, allcost.re_attributions) as re_attributions,
        coalesce(etl.re_engagements, allcost.re_engagements) as re_engagements,
        coalesce(etl.original_cost, allcost.original_cost) as original_cost,
        coalesce(etl.reported_impressions, allcost.reported_impressions) as reported_impressions,
        coalesce(etl.reported_clicks, allcost.reported_clicks) as reported_clicks,
        coalesce(etl.reported_conversions, allcost.reported_conversions) as reported_conversions,
        coalesce(etl.ctr, allcost.ctr) as ctr,
        coalesce(etl.cvr, allcost.cvr) as cvr,
        coalesce(etl.ecpm, allcost.ecpm) as ecpm,
        coalesce(etl.cpi, allcost.cpi) as cpi,
        coalesce(etl.ccvr, allcost.ccvr) as ccvr,
        coalesce(etl.cvvr, allcost.cvvr) as cvvr,
        coalesce(etl.reported_cvr, allcost.reported_cvr) as reported_cvr,
        coalesce(etl.install_diff, allcost.install_diff) as install_diff,
        coalesce(etl.click_diff, allcost.click_diff) as click_diff,
        coalesce(etl.impression_diff, allcost.impression_diff) as impression_diff,
        coalesce(etl.ecpc, allcost.ecpc) as ecpc,
        coalesce(etl.video_25p_views, allcost.video_25p_views) as video_25p_views,
        coalesce(etl.video_50p_views, allcost.video_50p_views) as video_50p_views,
        coalesce(etl.video_75p_views, allcost.video_75p_views) as video_75p_views,
        coalesce(etl.video_completions, allcost.video_completions) as video_completions
    from etl
    full join allcost
        on etl.date = allcost.date
        and etl.app_id = allcost.app_id
        and etl.media_source = allcost.media_source
        and etl.campaign_id = allcost.campaign_id
        and etl.adset_id = allcost.adset_id
        and etl.ad_id = allcost.ad_id
        and etl.channel = allcost.channel
        and etl.geo = allcost.geo
        and etl.agency = allcost.agency
        and etl.site_id = allcost.site_id
        and etl.keyword_id = allcost.keyword_id
),

dedup as (
    select *,
           row_number() over (
               partition by date, media_source, agency, campaign_id, adset_id, ad_id, geo, channel, site_id, keyword_id
               order by report desc, cost desc
           ) as rank_for_dedup
    from main
)

select *
from dedup
where rank_for_dedup = 1;

Рассмотрите возможность объединения отчетов Cost ETL с агрегированными расширенными когортными отчетами (или обычными когортными отчетами через Data Locker) в вашей системе бизнес-аналитики. Вместе они дают полную картину эффективности маркетинга со свежими и точными данными, включая клики, показы, затраты, доход, события в приложении и т. д.). И вы можете использовать эти объединенные данные для получения ROAS, CPA и т. д. Подробнее