Revenue ETL
Com o Revenue ETL do ROI360, seus dados de receita são enviados via Data Locker para armazenamento na nuvem para envio aos seus sistemas de BI.
A tabela a seguir mostra os relatórios de receita disponíveis. Atenção: Com exceção dos relatórios de Legacy ad revenue [versão única], todos os relatórios exigem uma assinatura do ROI360 Advanced.
| Relatório | Tipo de integração | Descrição | Atualização dos dados |
|---|---|---|---|
Legacy ad revenue [versão única]:
|
|
|
|
Receita de anúncios (versionada)
|
|
|
|
| Receita de anúncios [Nível de impressão SDK] |
|
|
Por hora. Saiba mais |
| Relatório de receita da loja a nível de transação | Integração da receita de assinaturas e de compras in-app no ROI360 |
|
Por hora |
| Receita da loja a nível de dispositivo [versionada] | Integração da receita de assinaturas e de compras in-app no ROI360 |
|
A cada 8 horas |
Relatórios
Os detalhes sobre os diferentes relatórios — como funcionam, como assiná-los e como acessá-los — podem ser encontrados nas seções a seguir.
[Legado] Receita de anúncios (versão única)
O relatório mostra uma única versão dos dados de receita de anúncios de um dia, agregados a nível de dispositivo. O relatório está disponível no dia X+1 (X é o dia da ocorrência do evento de receita).
Atenção: Relatórios separados fornecem os dados orgânicos e de receita de retargeting. Esses relatórios são idênticos em estrutura e disponibilidade.
Baixe a amostra de dados do relatório de receita de anúncios em versão única.
Fontes de dados
Dependendo do tipo de parceiro de receita de anúncios, os dados do relatório podem ser enviados via:
- SDK: Cargas de dados a nível de impressão, enviadas pelo conector ROI360 Ad Revenue SDK.
- S2S: Relatórios a nível de dispositivo obtidos por uma solicitação da API de parceiros (redes de mediação ou monetização).
Para saber como definir o tipo de integração, consulte: Conectar-se a parceiros integrados de receita de anúncios.
Fluxo de dados
- Ingestão de dados: O relatório pode se originar do conector de ad revenue SDK ou da solicitação da API S2S (consulte a seção acima).
-
Processamento de dados: O ROI360 Ad Revenue da AppsFlyer realiza o seguinte:
- Normalização de dados,
- Atribuição à fonte de instalação e enriquecimento de dados,
- Geração de eventos de receita de anúncios,
- Os eventos são agregados a nível de dispositivo
Atenção: Um relatório pode ter mais de uma agregação a nível de dispositivo para o mesmo dispositivo. Isso pode acontecer porque a agregação a nível de dispositivo se baseia nas dimensões relacionadas à monetização, como rede de monetização, posição e tipo de anúncio. Por exemplo, se o aplicativo exibir anúncios em dois canais diferentes, os eventos de receita de cada canal serão agregados separadamente no nível do dispositivo.
- Entrega de dados: Os dados a nível de dispositivo são registrados na versão única do relatório.
Quando os dados do relatório ficam disponíveis?
| Tipo de integração | Dia da versão (X = dia de ocorrência do evento de receita) | Versão disponível em | A versão inclui eventos de receita que ocorrem entre |
|---|---|---|---|
| SDK | Dia X+1 | 20:00 | 00:00 – 24:00 |
| SDK + S2S | Dia X+1 | 17:00 | 00:00 – 24:00 |
Como assinar o relatório?
- Na AppsFlyer, no menu lateral, selecione Relatório > Data Locker.
- No dashboard de conteúdos do Data Locker, vá até o bloco ROI360 RevenueETL.
- Selecione Receita atribuída [versão única].
Atenção: Você também pode selecionar o mesmo relatório para retargeting e orgânico (Retargeting/Receita de anúncios orgânica [versão única]).
Como acessar o relatório no seu bucket?
O caminho (path) para o relatório consiste na seguinte hierarquia de pastas:
Com o seguinte formato:
Hierarquia de pastas de relatório
Exemplo da hierarquia da pastas de relatórios de versão única de receita de anúncios atribuída no bucket do anunciante:
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
| |
. .
. .
Legenda:
- dt: data em que ocorreram os eventos de receita incluídos no relatório.
- t: tipo de relatório.
- h: hora de criação da versão única
Receita de anúncios (versionada)
O relatório mostra várias versões dos dados de receita de uma única data. Por exemplo, a receita obtida em 21 de junho é reportada em 21 de junho, 22 de junho, 23 de junho, 24 de junho, 28 de junho e 5 de julho.
O objetivo de coletar várias versões do mesmo dia é capturar as variações do cálculo da receita decorrentes de condições que dependem do tempo. Por exemplo, impressões que tiveram valor de receita em tempo real podem ter um valor diferente um dia depois.
Atenção: Relatórios separados fornecem os dados orgânicos e de receita de retargeting. Esses relatórios são idênticos em estrutura e disponibilidade.
Baixe a amostra de dados do relatório versionado.
Fontes de dados
Dependendo do tipo de integração do seu parceiro, os dados do relatório podem se originar via:
- SDK: Cargas de dados a nível de impressão, enviadas pelo conector ROI360 Ad Revenue SDK.
- S2S: Relatórios a nível de dispositivo obtidos por uma solicitação da API de parceiros (redes de mediação ou monetização).
- S2S + SDK: Cargas úteis originadas do SDK e do S2S.
Para saber como definir o tipo de integração, consulte: Conectar-se a parceiros integrados de receita de anúncios.
Fluxo de dados
- Ingestão de dados: O relatório pode se originar ou do SDK ou da solicitação da API S2S (veja seção acima).
-
Processamento de dados: O ROI360 Ad Revenue da AppsFlyer realiza o seguinte:
- Normalização de dados,
- Atribuição à fonte de instalação e enriquecimento de dados,
- Geração de eventos de receita de anúncios,
- Os eventos são agregados a nível de dispositivo
Atenção: Um relatório pode ter mais de uma agregação a nível de dispositivo para o mesmo dispositivo. Isso pode acontecer porque a agregação a nível de dispositivo se baseia nas dimensões relacionadas à monetização, como rede de monetização, posição e tipo de anúncio. Por exemplo, se o aplicativo exibir anúncios em dois canais diferentes, os eventos de receita de cada canal serão agregados separadamente no nível do dispositivo.
- Entrega de dados: Os dados a nível de dispositivo são registrados em várias versões do relatório de acordo com um cronograma predeterminado (especificado abaixo).
Quando as versões do relatório estão disponíveis?
A tabela fornecida abaixo descreve os cronogramas de geração para as versões S2S e SDK. Os clientes que se beneficiam do ROI360 Ad Revenue Freshness to Accuracy receberão as duas versões, garantindo a melhor precisão e informações atualizadas.
| Tipo de integração | Dia da versão (X = dia de ocorrência do evento de receita) | Versão disponível em | A versão inclui eventos de receita que ocorrem entre |
|---|---|---|---|
| SDK | Dia X | 03:00-04:00 | 00:00 – 03:00 |
| SDK | Dia X | 07:00-08:00 | 00:00 – 07:00 |
| SDK | Dia X | 11:00-12:00 | 00:00 – 11:00 |
| SDK | Dia X | 15:00-16:00 | 00:00 – 15:00 |
| SDK | Dia X | 19:00-20:00 | 00:00 – 19:00 |
| SDK | Dia X | 23:00-24:00 | 00:00 – 23:00 |
| SDK | Dia X+1 | 04:00-05:00 | 00:00 – 24:00 |
| S2S | Dia X+1 | 12:00-13:00 | 00:00 – 24:00 |
| S2S | Dia X+1 | 18:00-19:00 | 00:00 – 24:00 |
| S2S | Dia X+2 | 00:00-01:00 | 00:00 – 24:00 |
| S2S | Dia X+2 | 13:00-14:00 | 00:00 – 24:00 |
| S2S | Dia X+3 | 06:00-07:00 | 00:00 – 24:00 |
| S2S | Dia X+7 | 08:00-09:00 | 00:00 – 24:00 |
| S2S | Dia X+14 | 10:00-11:00 | 00:00 – 24:00 |
| SDK + S2S | Todas as versões do SDK e S2S acima |
Atenção: Algumas versões originadas pelo S2S podem não ser criadas. Se os dados do(s) parceiro(s) não mudaram desde a última extração, uma nova versão NÃO será gerada.
Como assinar o relatório?
- Na AppsFlyer, no menu lateral, selecione Relatório > Data Locker.
- No dashboard de conteúdos do Data Locker, vá até o bloco ROI360 RevenueETL.
- Selecione Receita de anúncios atribuída [versionada].
Atenção: Você também pode selecionar o mesmo relatório para retargeting e orgânico (Retargeting/Receita de anúncios orgânica [versionada]).
Como acessar o relatório no seu bucket?
O caminho (path) para o relatório consiste na seguinte hierarquia de pastas:
Hierarquia de pastas de relatório
Um exemplo da árvore de relatórios no bucket do anunciante:
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
.
.
.
-
Legenda:
- t: tipo de relatório
- dt: data em que ocorreram os eventos de receita incluídos no relatório.
- version: o nome da versão é o timestamp da data e hora de criação da versão, por exemplo, version=1685588879.
- A origem da versão, seja S2S ou SDK, pode ser exibida no momento da criação da versão. As primeiras versões do SDK são originadas do SDK. As outros são originadas via S2S.
Receita de anúncios (Nível de impressão no SDK)
O relatório mostra dados a nível de impressão divididos em pastas por hora de ocorrência. Cada pasta contém somente impressões que ocorreram durante aquela hora.
Faça o download da amostra de dados do relatório a nível de impressão de receita de anúncios
Fonte de dados
Os dados do relatório se originam de dados a nível de impressão enviados pelo conector ROI360 Ad Revenue SDK e exigem uma integração do tipo SDK.
Para saber como definir o tipo de integração, consulte: Conectar-se a parceiros integrados de receita de anúncios.
Fluxo de dados
- Ingestão de dados: Os dados do relatório se originam de dados a nível de impressão enviados pelo conector ROI360 Ad Revenue SDK e exigem uma integração do tipo SDK.
-
Processamento de dados: O ROI360 Ad Revenue da AppsFlyer realiza o seguinte:
- Normalização de dados,
- Atribuição à fonte de instalação e enriquecimento de dados,
- Geração de eventos de receita de anúncios a nível de impressão.
- Entrega de dados: Os eventos de impressão são gravados em arquivos divididos por pastas de acordo com a hora da ocorrência. Cada pasta contém somente impressões que ocorreram durante aquela hora.
Quando os dados do relatório ficam disponíveis?
| Tipo de integração | Dia da versão (X = dia de ocorrência do evento de receita) | Versão disponível em |
|---|---|---|
| SDK | Dia X | No final de cada hora reportada |
Como assinar o relatório?
- Na AppsFlyer, no menu lateral, selecione Relatório > Data Locker.
- No dashboard de conteúdos do Data Locker, vá até o bloco ROI360 RevenueETL.
- Selecione Receita de anúncios [Nível de impressão SDK].
Como acessar o relatório no seu bucket?
O caminho (path) para o relatório consiste na seguinte hierarquia de pastas:
Hierarquia de pastas de relatório
Um exemplo da árvore de relatórios no bucket do anunciante:
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
. .
. .
Legenda:
- t: tipo de relatório
- dt: data em que ocorreram os eventos de receita incluídos no relatório.
- h: pasta por hora, que contém um arquivo CSV com as impressões que ocorreram durante aquela determinada hora.
Relatório de receita da loja a nível de transação
Esse relatório apresenta dados brutos diários a nível de transação, divididos em pastas por hora, que contêm somente as transações relevantes para aquela hora.
Faça o download da amostra de dados do relatório a nível de transação
Fontes de dados
Os dados do relatório se originam de transações coletadas por meio do conector ROI360 SDK Purchase e de notificações de armazenamento S2S.
Fluxo de dados
- Os dados do relatório se originam de transações coletadas por meio do conector ROI360 SDK Purchase ou das notificações das lojas S2S.
- O ROI360 VIAP/Subscriptions da AppsFlyer processa os dados, os atribui e cria eventos e valores a nível de transação.
- Os eventos a nível de transação são registrados no relatório, separados em pastas por hora.
Quando os dados do relatório ficam disponíveis?
| Dia da versão (X = dia de ocorrência do evento de receita) | Versão disponível em |
|---|---|
| Dia X | No final de cada hora reportada |
Como assinar o relatório?
- Na AppsFlyer, no menu lateral, selecione Relatório > Data Locker.
- No dashboard de conteúdos do Data Locker, vá até o bloco ROI360 RevenueETL.
- Selecione Relatório de receita da loja a nível de transação.
Como acessar o relatório no seu bucket?
O caminho (path) para o relatório consiste na seguinte hierarquia de pastas:
Hierarquia de pastas de relatório
Um exemplo da árvore de relatórios no bucket do anunciante:
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
. .
. .
Legenda:
- t: tipo de relatório.
- dt: data em que ocorreram os eventos de receita incluídos no relatório.
- h: Pasta por hora contendo o arquivo CSV com as transações que ocorreram durante aquela determinada hora.
Relatório de receitas da loja a nível de dispositivo (versionado)
O relatório de receitas da loja a nível de dispositivo especifica eventos in-app de compras e assinaturas com renovação automática capturados pelos produtos do ROI360. Esses eventos incluem dimensões exclusivas relacionadas à monetização no ROI360. Eventos in-app emitidos pelo cliente não são incluídos nesse relatório.
Faça o download da amostra de dados do relatório de receitas da loja a nível de dispositivo
Fontes de dados
Os dados do relatório se originam de transações coletadas via:
- Conector ROI360 SDK Purchase.
- Lojas (por exemplo, a App Store e a Google Play Store) por meio de notificações S2S.
Fluxo de dados
- Os dados do relatório se originam de transações coletadas por meio do conector ROI360 SDK Purchase ou das notificações das lojas S2S.
- O ROI360 VIAP/Subscriptions da AppsFlyer processa os dados, os atribui e cria eventos in-app.
- Os eventos in-app são agregados a nível de dispositivo e registrados em uma versão do relatório a cada quatro horas.
Quando as versões do relatório estão disponíveis?
| Dia da versão (X = dia de ocorrência do evento de receita) | Versão disponível em | A versão inclui eventos de receita que ocorrem entre |
|---|---|---|
| Dia X | 04:00 - 05:00 | 00:00 – 04:00 |
| Dia X | 12:00 - 13:00 | 00:00 – 12:00 |
| Dia X | 20:00 - 21:00 | 00:00 – 20:00 |
| Dia X+1 | 05:00 - 06:00 | 00:00 – 24:00 |
Como assinar o relatório?
- Na AppsFlyer, no menu lateral, selecione Relatório > Data Locker.
- No dashboard de conteúdos do Data Locker, vá até o bloco ROI360 RevenueETL.
- Selecione Relatório de receitas da loja a nível de dispositivo [versionado].
Como acessar o relatório no seu bucket?
O caminho (path) para o relatório consiste na seguinte hierarquia de pastas:
Hierarquia de pastas de relatório
Um exemplo da árvore de relatórios no bucket do anunciante:
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
.
.
.
Legenda:
- t: tipo de relatório.
- dt: data em que ocorreram os eventos de receita incluídos no relatório.
- version: o nome da versão é o timestamp da data e hora de criação da versão, por exemplo, version=1685588879.