Отчёты ROI360 Revenue ETL в Data Locker

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

Revenue ETL

Благодаря ROI360 Revenue ETL ваши данные о доходах отправляются через Data Locker в облачное хранилище для загрузки в ваши системы бизнес-аналитики.

В следующей таблице показаны доступные отчёты о доходах. Примечание: За исключением устаревших отчётов о доходах от рекламы [одна версия], для всех отчётов требуется подписка на пакет ROI360 Advanced.

Отчёт Тип интеграции Описание Актуальность данных
Устаревший доход от рекламы [одна версия]:
  • Атрибутированный доход от рекламы [одна версия x+1]
  • Органический доход от рекламы [одна версия x+1]
  • Доход от ретаргетинговой рекламы [одна версия x+1]
  • На уровне показов (через SDK)
  • На уровне устройства (через API S2S)
  • На уровне показов (через SDK) с уровнем устройств (через S2S API)
  • Содержит данные о доходах от рекламы.
  • Одна версия (без дальнейших обновлений данных).
  • Если имеются интеграции и API, и SDK, отчёты содержат только данные API.
Доход от рекламы [по версиям]:
  • Атрибутированный доход от рекламы [по версиям]
  • Органический доход от рекламы [по версиям]
  • Доход от рекламы в рамках ретаргетинга [по версиям]
  • На уровне показов (через SDK)
  • На уровне устройства (через API S2S)
  • На уровне показов (через SDK) с уровнем устройств (через S2S API)
  • Содержит самые актуальные данные о доходах от рекламы.
  • По версиям
  • В течение дня. Узнать больше
  • Данные обновляются в течение периода от 4 часов до 14 дней после показа рекламы.
Доход от рекламы [SDK, на уровне показов]
  • На уровне показов (через SDK)
  • На уровне показов (через SDK) с уровнем устройств (через S2S API)
  • Содержит данные SDK по доходам от рекламы.
  • Обеспечивает максимальную актуальность и детализацию данных.
 Ежечасно. Узнать больше
Доходы магазина на уровне транзакций Интеграция доходов от покупок внутри приложения (IAP) и подписки ROI360
  • Содержит проверенные ROI360 сырые данные о покупках в приложении и подписках на уровне транзакций.
  • Обеспечивает максимальную актуальность и детализацию данных.
  • Включает уникальные данные о монетизации ROI360 и чистом доходе.
 Ежечасно
Доходы магазина на уровне устройств [по версиям] Интеграция доходов от покупок внутри приложения (IAP) и подписки ROI360
  • Содержит проверенные ROI360 сырые данные о покупках в приложении и подписках на уровне устройств.
  • Включает уникальные данные о чистом доходе ROI360.
 Каждые 8 часов

Отчёты

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

[Устарело] Доход от рекламы (одна версия)

В отчёте представлена одна версия данных о доходах от рекламы за один день, агрегированных на уровне устройств. Отчёт доступен в день X+1 (X — день совершения события дохода). 

Примечание. Отдельные отчёты содержат данные по органическому доходу и доходу от ретаргетинга. Эти отчёты идентичны по структуре и доступности.

Загрузите образец данных единой версии отчёта о доходах от рекламы.

Источники данных

В зависимости от типа интеграции вашего партнёра по доходам от рекламы данные отчёта могут быть получены из следующих источников:

  • SDK: Полезные данные уровня показов, отправляемые коннектором SDK для дохода о рекламы ROI360.
  • S2S: Отчёты на уровне устройств, получаемые по API-запросу от партнёров (сетей посредничества или монетизации).

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

Поток данных

  1. Импорт данных: Отчёт может быть получен из коннектора SDK доходов от рекламы или запроса S2S API (см. раздел выше).

  2. Обработка данных: AppsFlyer ROI360 выполняет следующие действия:

    1. Нормализация данных,
    2. Атрибуция к медиа-источнику установки и обогащение данных,
    3. Генерирование событий дохода от рекламы,
    4. События агрегируются до уровня устройства.

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

  3. Доставка данных: Данные на уровне устройства записываются в одну версию отчёта.

Когда будут доступны данные отчёта?

Тип интеграции Дата версии (X = день возникновения события дохода) Версия доступна в Версия включает в себя события дохода, происходящие между
SDK День X+1 20:00 00:00 – 24:00
SDK + S2S День X+1 17:00 00:00 – 24:00

Как подписаться на отчёт?

  1. В AppsFlyer в боковом меню выберите Отчёт > Data Locker.
  2. На панели содержимого Data Locker прокрутите вниз до плитки ROI360 RevenueETL.
  3. Выберите Атрибутированный доход [одна версия].

Примечание. Вы также можете выбрать один и тот же отчёт для ретаргетинга и органического показа (Ретаргетинг/Органический доход от рекламы [одна версия]).

Как получить доступ к отчёту в вашей корзине?

Путь к отчёту состоит из следующей иерархии папок:

В следующем формате: /t=attributed_ad_revenue/dt=

/h=23/

Иерархия папок с отчётами

Пример иерархии папок с отчётами об атрибутированном доходе от рекламы в корзине рекламодателя:

bucket
|
└── t=attributed_ad_revenue
    |
    ├── dt=2023-06-02
    |   |
    |   └── h=23
    |        |
    |        ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |        |
    |        ├── part-00001-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |        │
    |        └── part-00002-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |
    ├── dt=2023-06-01
    |   |
    |   └── h=23
    |        |
    |        ├── part-00000-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
    |        |
    |        ├── part-00001-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
    |        │
    |        └── part-00002-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
    |
    ├── dt=2023-05-31
    |   |
    .   . 
    .   .

Условные обозначения:

  • dt: Дата, когда произошли события дохода, включённые в отчёт.
  • t: тип отчёта.
  • h: час создания отдельной версии

Доход от рекламы (по версиям)

В отчёте отображаются несколько версий данных о доходах на одну дату. Например, выручка, полученная 21 июня, отражается 21 июня, 22 июня, 23 июня, 24 июня, 28 июня и 5 июля.

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

Примечание. Отдельные отчёты содержат данные по органическому доходу и доходу от ретаргетинга. Эти отчёты идентичны по структуре и доступности.

Загрузите образец данных в отчёте о доходах от рекламы по версиям.

Источники данных

В зависимости от типа интеграции вашего партнёра данные отчёта могут быть получены из следующих источников:

  • SDK: Полезные данные уровня показов, отправляемые коннектором SDK для дохода о рекламы ROI360.
  • S2S: Отчёты на уровне устройств, получаемые по API-запросу от партнёров (сетей посредничества или монетизации).
  • S2S + SDK: Полезные нагрузки, исходящие как от SDK, так и от S2S.

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

Поток данных

  1. Импорт данных: Отчёт может быть получен из SDK или API-запроса к S2S (см. раздел выше).

  2. Обработка данных: AppsFlyer ROI360 выполняет следующие действия:

    1. Нормализация данных,
    2. Атрибуция к медиа-источнику установки и обогащение данных,
    3. Генерирование событий дохода от рекламы,
    4. События агрегируются до уровня устройства.

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

  3. Доставка данных: Данные на уровне устройства записываются в несколько версий отчётов в соответствии с заранее определённым графиком (указанным ниже).

Когда будут доступны версии отчётов?

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

Тип интеграции Дата версии (X = день возникновения события дохода) Версия доступна в Версия включает в себя события дохода, происходящие между
SDK День X 03:00 – 04:00 00:00 – 03:00
SDK День X 07:00 – 08:00 00:00 – 07:00
SDK День X 11:00 – 12:00 00:00 – 11:00
SDK День X 15:00 – 16:00 00:00 – 15:00
SDK День X 19:00 – 20:00 00:00 – 19:00
SDK День X 23:00 – 24:00 00:00 – 23:00
SDK День X+1 04:00 – 05:00 00:00 – 24:00
S2S День X+1 12:00 – 13:00 00:00 – 24:00
S2S День X+1 18:00 – 19:00 00:00 – 24:00
S2S День X+2 00:00 – 01:00 00:00 – 24:00
S2S День X+2 13:00 – 14:00 00:00 – 24:00
S2S День X+3 06:00 – 07:00 00:00 – 24:00
S2S День X+7 08:00 – 09:00 00:00 – 24:00
S2S День X+14 10:00 – 11:00 00:00 – 24:00
SDK + S2S Все версии SDK и S2S выше    

Примечание. Некоторые версии, созданные с помощью S2S, могут быть не созданы. Если данные от партнёра(ов) не изменились с момента последнего извлечения, новая версия НЕ будет создана.

Как подписаться на отчёт?

  1. В AppsFlyer в боковом меню выберите Отчёт > Data Locker.
  2. На панели содержимого Data Locker прокрутите вниз до плитки ROI360 RevenueETL.
  3. Выберите Атрибутированный доход от рекламы [по версиям].

Примечание. Вы также можете выбрать один и тот же отчёт для ретаргетинга и органического показа (Ретаргетинг/Органический доход от рекламы [одна версия]).

Как получить доступ к отчёту в вашей корзине?

Путь к отчёту состоит из следующей иерархии папок:

/t=attributed_ad_revenue_v2/dt=

/version=<9999999>/

Иерархия папок с отчётами

Пример дерева отчётов в корзине рекламодателя:

bucket
|
└── t=attributed_ad_revenue_v2
    |
    └── dt=2023-06-01
        |
        ├── version=1685588879
        |   |
        │   ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
        |   |
        │   ├── part-00001-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
        |   │
        |   └── part-00002-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
        |
        ├── version=1685603326
        |   |
        │   ├── part-00000-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
        |   |
        │   ├── part-00001-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
        |   │
        |   └── part-00002-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
        |
        ├── version=1685617877
        .
                .
                .
  • Условные обозначения:
    • t: Тип отчёта
    • dt: Дата, когда произошли события дохода, включённые в отчёт.
    • version: Название версии – это временная метка Unix для даты и времени создания версии, например, version=1685588879.
  • Происхождение версии (S2S или SDK) можно узнать по времени создания версии. Первые версии SDK происходят из SDK. Остальные – S2S.

Доход от рекламы (SDK, на уровне показов)

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

Загрузите пример данных отчёта о доходах от рекламы на уровне показов

Источник данных

Данные отчёта берутся из данных на уровне показов, отправляемых коннектором SDK для дохода от рекламы ROI360, и требуют интеграции типа SDK.

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

Поток данных

  1. Импорт данных: Данные отчёта берутся из данных на уровне показов, отправляемых коннектором SDK для дохода от рекламы ROI360, и требуют интеграции типа SDK. 
  2. Обработка данных: AppsFlyer ROI360 выполняет следующие действия:
    1. Нормализация данных,
    2. Атрибуция к медиа-источнику установки и обогащение данных,
    3. Генерация события дохода от рекламы на уровне показов.
  3. Доставка данных: События показов записываются в файлы, разделённые по папкам в соответствии с часом возникновения. Каждая папка содержит только показы, произошедшие в течение этого часа.

Когда будут доступны данные отчёта?

Тип интеграции Дата версии (X = день возникновения события дохода) Версия доступна в
SDK День X В конце каждого отчётного часа

Как подписаться на отчёт?

  1. В AppsFlyer в боковом меню выберите Отчёт > Data Locker.
  2. На панели содержимого Data Locker прокрутите вниз до плитки ROI360 RevenueETL.
  3. Выберите Доход от рекламы [SDK, на уровне показа ].

Как получить доступ к отчёту в вашей корзине?

Путь к отчёту состоит из следующей иерархии папок:

/t=attributed_adrevenue_sdk_impression_level/dt=

/h=

Иерархия папок с отчётами

Пример дерева отчётов в корзине рекламодателя:

bucket
|
└── t=attributed_adrevenue_sdk_impression_level/
    |
    ├── dt=2023-06-01
    |   |
    |   ├── h=0
    |   |   |
    |   │   ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   ├── h=1
    |   |   |
    |   │   ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   ├── h=2
    |   .   |
    |   .   ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   .   .
    |   ├── h=23
    |   |   |
    |   │   ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   └── h=24
    |       |
    |       └── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |    
    ├── dt=2023-06-02
    |   |  
    |   ├── h=0
        .   .
        .   .

Условные обозначения:

  • t: Тип отчёта
  • dt: Дата, когда произошли события дохода, включённые в отчёт.
  • h: Почасовая папка, содержащая CSV-файл с показами, произошедшими в течение определённого часа.

Доходы магазина на уровне транзакций

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

Загрузите образец данных отчёта о магазинах на уровне транзакций

Источники данных

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

Поток данных

  1. Данные отчёта берутся из транзакций, собранных с помощью коннектора SDK для покупок ROI360 или от межсерверных уведомлений магазина.
  2. Функция AppsFlyer ROI360 VIAP/Subscriptions обрабатывает данные, атрибутирует их и создаёт события и значения на уровне транзакций.
  3. События на уровне транзакций записываются в отчёт, разделённый на почасовые папки.

Когда будут доступны данные отчёта?

Дата версии (X = день возникновения события дохода) Версия доступна в
День X В конце каждого отчётного часа

Как подписаться на отчёт?

  1. В AppsFlyer в боковом меню выберите Отчёт > Data Locker.
  2. На панели содержимого Data Locker прокрутите вниз до плитки ROI360 RevenueETL.
  3. Выберите Отчёт о доходах магазинов на уровне транзакций.

Как получить доступ к отчёту в вашей корзине?

Путь к отчёту состоит из следующей иерархии папок:

/t=stores_rawdata/dt=

/h=

Иерархия папок с отчётами

Пример дерева отчётов в корзине рекламодателя:

bucket
|
└── t=stores_rawdata
    |
    ├── dt=2023-06-01
    |   |
    |   ├── h=0
    |   |   |
    |   │   ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   ├── h=1
    |   |   |
    |   │   ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   ├── h=2
    |   .   |
    |   .   ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   .   .
    |   ├── h=23
    |   |   |
    |   │   ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |   └── h=24
    |       |
    |       └── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
    |    
    ├── dt=2023-06-02
    |   |  
    |   ├── h=0
        .   .
        .   .

Условные обозначения:

  • t: тип отчёта.
  • dt: Дата, когда произошли события дохода, включённые в отчёт.
  • h: Почасовая папка, содержащая CSV-файл с транзакциями, произошедшими в течение определённого часа.

Доходы магазина на уровне устройств (по версиям)

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

Загрузите пример данных отчёта о доходах магазина на уровне устройств

Источники данных

Данные отчёта получены из транзакций, собранных с помощью:

  1. Коннектор SDK для покупок ROI360.
  2. Магазины (например, App Store и Google Play) посредством межсерверных уведомлений.

Поток данных

  1. Данные отчёта берутся из транзакций, собранных с помощью коннектора SDK для покупок ROI360 или от межсерверных уведомлений магазина.
  2. Функция AppsFlyer ROI360 VIAP/Subscriptions обрабатывает данные, атрибутирует их и создаёт события в приложении.
  3. События в приложении агрегируются на уровне устройства и записываются в версию отчёта каждые четыре часа.

Когда будут доступны версии отчётов?

Дата версии (X = день возникновения события дохода) Версия доступна в Версия включает в себя события дохода, происходящие между
День X 04:00 – 05:00 00:00 – 04:00
День X 12:00 – 13:00 00:00 – 12:00
День X 20:00 – 21:00 00:00 – 20:00
День X+1 05:00 – 06:00 00:00 – 24:00

Как подписаться на отчёт?

  1. В AppsFlyer в боковом меню выберите Отчёт > Data Locker.
  2. На панели содержимого Data Locker прокрутите вниз до плитки ROI360 RevenueETL.
  3. Выберите Отчёт о доходах магазина на уровне устройств [по версиям]

Как получить доступ к отчёту в вашей корзине?

Путь к отчёту состоит из следующей иерархии папок:

/t=stores_devicedata/dt=

/version=<999999999>

Иерархия папок с отчётами

Пример дерева отчётов в корзине рекламодателя:

bucket
|
└── t=stores_devicedata
    |
    └── dt=2023-06-01
        |
        ├── version=1685588879
        |   |
        │   ├── part-00000-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
        |   |
        │   ├── part-00001-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
        |   │
        |   └── part-00002-4762858-d62a-446e-b499-dd05f2d5434d-c000.csv.gz
        |
        ├── version=1685603326
        |   |
        │   ├── part-00000-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
        |   |
        │   ├── part-00001-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
        |   │
        |   └── part-00002-1d295376-d024-4321-8d34-1fbb37cbb58d-c000.csv.gz
        |
        ├── version=1685617877
        .
                .
                .

Условные обозначения:

  • t: тип отчёта.
  • dt: Дата, когда произошли события дохода, включённые в отчёт.
  • version: Название версии – это временная метка Unix для даты и времени создания версии, например, version=1685588879.