Configure e use os relatórios de Cost ETL do ROI360

Os dados de custo da campanha são registrados:

• No seu bucket para visualização, transferência e carregamento de dados de custos nos seus sistemas.
• Para todos os aplicativos que você escolher incluir no Cost ETL, por dia e por versão.
• Até 4 vezes por dia (atualização dos dados: intradiário).
• Para o dia atual e nos 6 dias anteriores (referidos como 7 dias neste artigo), bem como os dias 14, 29 e 88. Leve isso em consideração no seu processo de carregamento de dados.
  • Exemplo: Para a data de 14 de outubro de 2024, o arquivo contém dados de 14 de outubro (o dia atual), 13 de outubro (1 dia atrás), 12 de outubro (2 dias atrás), 11 de outubro (3 dias atrás), 10 de outubro (4 dias atrás), 9 de outubro (5 dias atrás), 8 de outubro (6 dias atrás), 30 de setembro (14 dias atrás), 15 de setembro (29 dias atrás) e 18 de julho (88 dias atrás).
  • Os dados retroativos permitem atualizações e correções ao relatar os dados de custos.
• Para custos que correspondem a atribuição, clique ou impressão.
  Atenção:
  • Os dados relativos aos últimos 7 dias são extraídos novamente do canal de mídia. Os dados relativos aos dias 14, 29 e 88 são processados novamente.
  • Apenas os dados de custos são atualizados retroativamente; não os dados de atribuição.

Os dados registrados no serviço de nuvem ou bucket têm o diretório e a estrutura de arquivos descritos a seguir:

• Quando o Cost ETL termina de registrar em um diretório, uma flag é definida através da criação de um arquivo de sucesso. Esse é sempre o timestamp de data/hora mais recente no diretório. 
• O número de pastas/arquivos é o seguinte:
  • Resumo: Até 4 pastas de versão por dia.
    • Cada pasta de versão contém arquivos parquet com 7 dias de dados.
  • Relatório de geo ou canal: Cada relatório contém até 4 pastas de versão por dia.
    • Cada pasta de versão contém arquivos parquet que contêm dados com numeração a partir de 1.
  • [Beta fechado] Todos os custos: Com base na dimensão geo, contém até 4 arquivos por dia.

Estrutura do diretório de conexão do Data Locker

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

Estrutura do diretório de conexão do Cost ETL

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

Exemplo: Para a primeira extração de dados de 23 de junho de 2020, a estrutura do nome do diretório e do arquivo é a seguinte: /bucket-name/cost_etl/v1/dt=2020-06-23/b=1/geo/part-00001

Campos/Dimensões

Métricas

Esse procedimento de configuração deve ser feito por um usuário administrador.

Antes de começar:

A configuração do Cost ETL requer:

• Um serviço de nuvem configurado com permissão para que a AppsFlyer registre dados nele. Isso significa que você precisa configurar 1 ou mais dos seguintes serviços de nuvem:
  • Bucket da AWS
  • Bucket do GCS
  • [Beta] Azure Blob
  • [Beta] Bucket do Yandex
  • Data warehouse do BigQuery
  • Warehouse do Snowflake
• Você precisa ser administrador da conta da AppsFlyer e do acesso à interface do usuário da AppsFlyer para concluir a configuração do Cost ETL.

Para configurar o Cost ETL: 

1. Na AppsFlyer, no menu lateral, selecione Exportar > Cost ETL.
2. Selecione ou configure uma conexão de dados:
   • Se você já tiver conexões de dados configuradas, no menu suspenso de Conexão, selecione as conexões desejadas para o Cost ETL.
     
   • Se você ainda não tiver uma conexão de dados, clique em + Nova conexão no Data Locker e crie uma conexão lá:
     
     1. Dê um nome à sua conexão.
        
     2. Selecione um destino para os dados no seu cloud service. Faça uma das seguintes opções:
        • Selecione S3.
          
          1. Insira o nome do seu bucket S3 da AWS. O prefixo af-af-af- é obrigatório e deve ser inserido manualmente.
          2. Clique em Testar conexão.
          3. Verifique se uma mensagem de erro indicando que o bucket path é inválido é exibida.
          4. Selecione se deseja tornar essa conexão compatível com a Adobe Experience Platform.
          5. Clique em Salvar.
          6. Na configuração do Cost ETL, no menu suspenso de Conexão, selecione o serviço de nuvem que você criou.
        • Selecione GCS.
          
          1. Insira o nome do bucket do GCS.
          2. Clique em Testar conexão.
          3. Verifique se uma mensagem de erro indicando que o bucket path é inválido é exibida.
          4. Selecione se deseja tornar essa conexão compatível com a Adobe Experience Platform.
          5. Clique em Salvar.
          6. Na configuração do Cost ETL, no menu suspenso de Conexão, selecione o serviço de nuvem que você criou.
        • [Beta] Selecione Azure.
          
          1. Insira seu Nome de conexão, Nome da conta de armazenamento e Chave.
          2. Verifique se uma mensagem de erro indicando que o bucket path é inválido é exibida.
          3. Selecione se deseja tornar essa conexão compatível com a Adobe Experience Platform.
          4. Clique em Save.
          5. Na configuração do Cost ETL, no menu suspenso de Conexão, selecione o serviço de nuvem que você criou.
        • [Beta] Selecione Yandex.
          
          1. Insira o nome do bucket, a chave de acessoe a chave secreta.
          2. Verifique se uma mensagem de erro indicando que o bucket path é inválido é exibida.
          3. Selecione se deseja tornar essa conexão compatível com a Adobe Experience Platform.
          4. Clique em Save.
          5. Na configuração do Cost ETL, no menu suspenso de Conexão, selecione o serviço de nuvem que você criou.
        • Selecione BigQuery.
          
          1. Insira o project ID do BigQuery e o nome do conjunto de dados.
          2. Clique em Testar conexão.
          3. Verifique se uma mensagem de erro indicando que o bucket path é inválido é exibida.
          4. Clique em Save.
          5. Na configuração do Cost ETL, no menu suspenso de Conexão, selecione o serviço de nuvem que você criou.
        • Selecione Snowflake.
          
          1. Insira sua região e o ID da conta do Snowflake.
          2. Clique em Testar conexão.
          3. Verifique se uma mensagem de erro indicando que o bucket path é inválido é exibida.
          4. Clique em Save.
          5. Na configuração do Cost ETL, no menu suspenso de Conexão, selecione o serviço de nuvem que você criou.
3. Clique em Próximo.
   
4. Configure o relatório Version schedule (UTC):
   
   1. Selecione quantos relatórios receber por dia (1, 2, 3 ou 4).
   2. Selecione a hora em que deseja receber os relatórios. Saiba mais
   3. Clique em Próximo.
5. Configure os detalhes do relatório:
   1. Selecione 1 ou mais aplicativos para incluir nos relatórios. Selecione Adicionar todos os aplicativos futuros para incluir automaticamente os apps que você adicionar no futuro.
      
   2. Selecione os relatórios que melhor atendem às suas necessidades de análise. Consulte as descrições na seção Tipos de relatório.
      • O Summary report é selecionado por padrão.
      • Para receber um relatório de All cost, é necessário selecionar o Geo report.
        
   3. Selecione as dimensões a serem incluídas nos relatórios. Atenção: Se você optar por receber o relatório Geo, a dimensão de geo será incluída por padrão. Se você optar por receber o relatório Canal, a dimensão do canal será incluída por padrão. 
      
   4. Selecione as métricas a serem incluídas nos relatórios. 
      
6. Clique em Aplicar.

Você pode editar ou alterar conexões para obter dados enviados para locais diferentes (ou adicionais). 

Atenção: Depois de mudar para uma conexão existente, você não poderá reverter para a sua conexão anterior do Cost ETL.

Editar conexão

Para os editar detalhes de conexão:

1. Na AppsFlyer, no menu lateral, selecione Exportar > Cost ETL.
2. Na seção Conexão de dados:
   • Para conexões do Data Locker, no menu suspenso Conexão, passe o mouse sobre a conexão que você deseja editar. Os detalhes da conexão são exibidos. Clique em Editar no Data Locker.
     
   • Para conexões de Cost ETL, clique no menu suspenso detalhes de conexão. Os detalhes da conexão são exibidos.
     
3. Siga as instruções na tela para editar seus detalhes de conexão.
4. Clique em Salvar alterações ou em Aplicar conforme solicitado.

Alterar conexão do Data Locker

Para mudar de uma conexão para outra:

1. Na AppsFlyer, no menu lateral, selecione Exportar > Cost ETL.
2. Na seção Conexão de dados:
   • Se você já tiver as conexões do Data Locker que deseja configurar, no menu suspenso de Conexão, selecione as conexões desejadas para Cost ETL.
     
   • Se você ainda não tiver uma conexão do Data Locker que deseja configurar, clique em + Nova conexão no Data Locker e crie uma conexão lá. Em seguida, volte para as configurações de Cost ETL e selecione-a no menu suspenso de Conexão.
     
3. Clique em Salvar alterações.

Mudar a conexão do Cost ETL para Data Locker

Antes de começar:

• Depois de alternar para uma conexão Data Locker, você não poderá voltar para sua conexão de Cost ETL anterior.
• Ao alternar para uma conexão Data Locker, a estrutura de folder path muda para o seguinte formato, sem afetar os dados do relatório:

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

Para mudar de uma conexão de Cost ETL para uma conexão Data Locker:

1. Na AppsFlyer, no menu lateral, selecione Exportar > Cost ETL.
2. Em Conexão de dados, clique em Conexões do Data Locker.
   
3. Siga um desses procedimentos para configurar a conexão do Data Locker:
   • Se você já tiver as conexões de dados que deseja configurar, no menu suspenso de Conexão, selecione as conexões desejadas para o Cost ETL.
     
   • Se você ainda não tiver a conexão de dados que deseja configurar, clique em + Nova conexão no Data Locker e crie uma conexão lá. Em seguida, volte para as configurações de Cost ETL e selecione-a no menu suspenso de Conexão.
     
4. Clique em Salvar alterações.

No AWS, por padrão, quando a AppsFlyer registra objetos no seu bucket, o proprietário do objeto é a AppsFlyer. Dependendo do seu processo de envio de dados, talvez você precise alterar a propriedade predefinida para você - o proprietário do bucket.  

Para alterar a propriedade dos objetos no seu bucket:

1. Entre no AWS Management Console e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.
2. Na lista Buckets, escolha o nome do bucket para o qual você deseja ativar o Object Ownership S3.
3. Acesse a aba de Permissions.
4. Em Object Ownership, clique em Edit.
5. Selecione o propietário do bucket desejado.
6. Clique em Save.

As configurações de cronograma de relatório permitem que você acesse os dados mais atualizados quando precisar. 

Ao escolher seu cronograma de relatório: 

• Selecione a hora em que o relatório será exibido - o mais próximo possível da hora em que você começa a processar dados em seu sistema de BI.
• Se você tiver qualquer ad network que forneça os dados do dia anterior mais tarde do que os outras, configure um relatório adicional no momento em que os dados dessa ad network estiverem prontos.

Ao extrair e analisar os seus dados, recomendamos extrair dados para uma data e um lote específicos, ou que substitua todos os dados anteriores para os dias que o lote atual fornece. Caso contrário, você poderá ver os mesmos dados repetidos.

Por exemplo, o lote 1 em 20 de fevereiro contém dados de 14 a 20 de fevereiro. Mas os lotes registrados em 19 de fevereiro também continham dados de 14 a 19 de fevereiro. Substitua os dados dos dias anteriores recebidos em 19 de fevereiro pelos dados recebidos no lote mais recente de 20 de fevereiro.

Nem todas as ad networks fornecem dados para todas as dimensões em conjunto. Os dados de geo e de canal no Meta ads são os exemplos mais comuns. É por isso que são fornecidos dois conjuntos de dados separados. É garantido que o conjunto de dados de geo contém dados geográficos e que o conjunto de dados de canais contém dados de canais.

Em muitos casos e para muitos canais de mídia, os dados nos conjuntos geo e de canais serão idênticos. Como tal, consuma um dos conjuntos de dados (geo ou canal), de acordo com o que melhor se adequa às suas necessidades.

Se o acordo de integração com um determinado canal de mídia não incluir o canal, fazendo com que esse canal fique em branco, tratamos esses dados como se contivessem o canal. 

O Cost ETL fornece dados flexíveis e granulares tão detalhados quanto podem ser extraídos da ad network. Para extrair informações úteis de quantidades tão grandes de dados, recomenda-se a agregação dos dados da forma que melhor se adapte às necessidades da sua empresa. Por exemplo, se você precisar compreender os dados de custos a nível da campanha e de país, use essas dimensões.

Nem todas as ad networks fornecem dados com a mesma granularidade. Por exemplo, o Meta Ads não fornece dados de site ID cost, enquanto o X Ads não fornece dados geo cost. Preste atenção nesses casos quando for agregar dados no Cost ETL e certifique-se de analisar dados parecidos ao comparar ad networks.

O Cost ETL fornece informações sobre todos os seus dados de custos. Algumas campanhas fornecidas no Cost ETL não aparecem em alguns dashboards da AppsFlyer - por exemplo, dados de campanhas inativas, ou seja, campanhas sem nenhuma instalação registrada. Para comparar os dados, procure um campaign ID específico no dashboard de visão geral e compare-o com os seus dados de custo no Cost ETL. Saiba mais sobre a disponibilidade dos dados de custos

Para obter dados de custo completos relacionados à atribuição para Google, Meta, TikTok (mobile e não mobile) e outras fontes de mídia (somente mobile), use a seguinte consulta:

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;

Você pode combinar relatórios de Cost ETL custo com relatórios agregados de Cohort (ou relatórios padrão de Cohort via Data Locker) em seu sistema de BI. Juntos, eles oferecem uma visão mais completa da sua performance de marketing com dados atualizados e precisos (incluindo cliques, impressões, custo, receita, eventos in-app, etc). Você pode usar esses dados combinados para acessar seu ROAS, CPA, etc. Saiba mais