Como podemos ajudar?

Importação de dados de custo Premium

  • Atualizado

Resumo: o Cost Import, que faz parte do ROI360 da AppsFlyer, permite que os anunciantes tenham uma visão completa e precisa dos custos de marketing ao importar arquivos CSV por upload ou e-mail.

Visão geral

Use o Cost Import para:

  • Obter os custos de campanha de qualquer atividade de marketing (campanhas mobile, campanhas com influenciadores, CTV e muito mais) para a AppsFlyer. Isso é particularmente importante para fontes de mídia que não disponibilizam informações de custo via API ou no link de atribuição.
  • Atualize e corrija dados de custos de períodos anteriores.

Os custos são enviados em arquivos CSV, por upload ou por e-mail, para a AppsFlyer. Quando a AppsFlyer recebe o arquivo, os dados são processados e ficam disponíveis nos seus dashboards e relatórios em poucas horas. Assim, você tem uma visão completa dos custos e do ROI das suas campanhas.

Observação:

  • As ad networks podem importar arquivos de custo para seus clientes, desde que as permissões necessárias sejam concedidas.
  • As agências não podem fazer upload de dados. Elas podem preparar seus arquivos e enviá-los ao anunciante para upload.

Instruções

Para usar o Cost Import e enviar dados de custo para a AppsFlyer, você precisa:

  1. Preparar o arquivo CSV com os dados de custo a serem enviados.
  2. Enviar o arquivo para a AppsFlyer por:
    • Upload na interface da AppsFlyer.
    • E-mail. Atenção: para aplicativos em CTV, PC e console, use somente esse método.

Veja as seções abaixo para instruções detalhadas.

Prepare o arquivo CSV com dados de custo

Anunciantes, ad networks e agências podem preparar o arquivo CSV do Cost Import. Ver arquivo de exemplo

Para preparar o arquivo CSV:

  • Siga o esquema do arquivo, o formato e as regras detalhadas nas tabelas a seguir.
    Você também pode incluir os cliques e as impressões reportados pela ad network junto aos dados de custo. Atenção: se você usar o Excel ou o Google Planilhas para criar o arquivo, siga suas respectivas instruções de formatação.

Esquema CSV

Nome da coluna 

(diferenciação entre maiúsculas e minúsculas)

Formato/observação Exemplo Obrigatoriedade
date
  • A data em que o custo ocorreu
  • Formato de string
    (recomendado):
    • AAAA-MM-DD
    • AAAA/MM/DD
    • MM-DD-AAAA
    • MM/DD/AAAA 
       
  • Datas futuras não são permitidas
  • Prática recomendada: use o mesmo fuso horário definido para o seu app na AppsFlyer.
  • Atenção: você está usando o Excel/Google Planilhas para preparar o arquivo? Leia aqui. 
  • 2019-05-30
  • 2019/05/30
  • 5-30-2019
  • 5/30/2019
  • 05-30-2019
  • 05/30/2019

 

✓
app-id
  • Formato: string
  • O App ID conforme aparece na AppsFlyer.
  • Vários app IDs são permitidos em um único arquivo.
  • Todos os app IDs precisam pertencer à mesma conta de anunciante.
  • com.app.nome 
  • id12356789
✓
media-source
  • Formato: string
  • Nome da fonte de mídia exatamente como aparece na AppsFlyer. Atenção: inclua o sufixo _int se relevante.
  • É permitida apenas uma fonte de mídia por arquivo. São permitidos vários aplicativos para a mesma fonte de mídia.
network_x_int ✓
campaign
  • Formato: string
  • Nome da campanha. Se o nome da campanha aparecer na ad network, o nome informado no arquivo deverá corresponder exatamente a ele (com diferenciação entre maiúsculas e minúsculas).
  • Não use o mesmo nome de campanha para vários aplicativos.
campaign_a

✓

Atenção: se existirem dados de atribuição com nome e ID, o CSV deverá conter ambos para garantir a correspondência.

spend
  • Custo monetário
  • Cinco dígitos permitidos após a vírgula
  • O valor 0 (zero) é permitido
  • Atenção: 
    • Não é permitido usar vírgulas como separadores de milhar. Exemplo: "2,874.12".
    • Você está usando o Excel/Google Planilhas para preparar o arquivo? Leia aqui.

2874.12345

 

 

✓
reported-clicks
  • Formato: integer
  • O número de cliques reportados pela ad network.
  • Somente números inteiros. Não use casas decimais, separadores de milhar (vírgulas), símbolos de moeda nem notação científica.
  • O valor deve ser maior ou igual a 0. O valor 0 é permitido.
1200 Não
reported-impressions
  • Formato: integer
  • O número de impressões reportadas pela ad network.
  • Somente números inteiros. Não use casas decimais, separadores de milhar (vírgulas), símbolos de moeda nem notação científica.
  • O valor deve ser maior ou igual a 0. O valor 0 é permitido.
45000 Não
geo
  • Formato: string
  • Código de duas letras do país, segundo o padrão ISO 3166. Atenção: envie dois caracteres, sem espaços em branco.
  • Para o Reino Unido, use UK, e não GB.
     

US, CN, AU

 

Não
currency
  • Formato: string
  • Código de três letras da moeda utilizada, segundo o padrão ISO 4217. Atenção: envie três caracteres, sem espaços em branco no início ou no final.
  • É permitido usar um código de moeda por aplicativo. Aplicativos distintos podem ter códigos de moeda diferentes. 
USD, GBP, EUR, JPY

Não.

Se deixado em branco, o padrão será USD.

campaign-id Formato: string abc1234def

Não.

Atenção: se existirem dados de atribuição com nome e ID, o CSV deverá conter ambos para garantir a correspondência.

adset Formato: string  my_adset_1
adset-id Formato: string id5678ghi
ad Formato: string  my_ad_name
ad-id Formato: string  id91011jkl
site-id
  • Formato: string 
  • ID exclusivo que identifica o publisher que exibe o anúncio. Saiba mais
id1213mno Não
channel Formato: string   video Não
keywords Formato: string
  • melhorar
  • melhorar seu app
  • melhorar sua presença online
Não
agency

 

  • Formato: string
  • O nome da agência. O valor no parâmetro af_prt.
  • Apenas uma agência e as campanhas gerenciadas por ela podem ser incluídas em um arquivo.
  • O nome da agência é obrigatório por linha. Não são permitidas células em branco na coluna "agency".
  • A agência deve ter acesso a todos os aplicativos incluídos no arquivo.
  • Somente anunciantes podem fazer upload do arquivo. As agências não podem fazer upload de dados. Elas podem preparar seus arquivos e enviá-los ao anunciante para upload.
  • Se os dados de custo forem reenviados para as mesmas datas e o nome da agência (af_prt) for incluído posteriormente, você terá dados de custo duplicados.
AgencyName Não
Atenção: nomes que incluem caracteres especiais (fora do alfabeto latino) devem ser codificados usando UTF-8.

Formato e regras CSV

Regra Requisito
Caracteres proibidos Os campos no formato de string não podem ter =, +, - ou @ como primeiro caractere. Por exemplo, @example_campign ou =123 são proibidos.
Proprietário do aplicativo  É permitido um anunciante (proprietário do aplicativo) por arquivo. Vários aplicativos da mesma conta de anunciante são permitidos. 
Extensão do nome do arquivo Exemplo de CSV: abc123.csv
Estrutura do arquivo
  • Formato: os arquivos têm formato CSV, o que significa que cada coluna é separada por uma vírgula.
  • Linha do header: a primeira linha é uma linha de header que corresponde ao esquema
  • Linhas de dados: contêm as colunas obrigatórias. Atenção: certifique-se de que não haja espaços em branco nos seus dados. Por exemplo, [USD] (o espaço em branco após o D deve ser alterado para [USD].
  • Linhas em branco: não são permitidas.
  • Linhas duplicadas com a mesma chave: não são permitidas. A chave é derivada do uso dos campos obrigatórios.
  • Células em branco: não são permitidos valores vazios no arquivo. Se você não quiser fazer upload de determinados campos, basta não incluí-los no arquivo.
Hierarquia de anúncios 

O custo deve ser registrado no nível da campanha, enquanto as demais dimensões da hierarquia de anúncios são opcionais.

O envio de dados parciais em um nível inferior da hierarquia substituirá todos os dados existentes a partir desse nível, inclusive os da campanha.

Por exemplo: se você importar um arquivo com os custos de campanha para o adset 1 e importar separadamente outro arquivo para o adset 2 da mesma campanha, o custo total da campanha será substituído, exibindo somente os dados do adset 2. Para o custo total da campanha, o arquivo importado precisa incluir o adset 1 e o adset 2. 

Upload do arquivo

Anunciantes e ad networks podem enviar arquivos CSV do Cost Import.

Pré-requisitos: as ad networks exigem permissões do Cost Import concedidas pelo anunciante. 

Para enviar o arquivo CSV pela interface da AppsFlyer:

  1. Na AppsFlyer, no menu lateral, selecione Configurações > Cost Import.
    A página do Cost Import é exibida. 
  2. Clique em + Importar arquivo de custo
    A janela do Cost Import é aberta.
     
  3. Arraste o arquivo CSV para a janela Importar arquivo de custo.
    A mensagem "Processando arquivo" é exibida.
  4. Se uma mensagem de erro for exibida durante o upload: corrija o erro e repita as etapas necessárias. 
  5. A janela Cost Import: resumo do arquivo é aberta.
  6. Faça uma das seguintes opções:
    • Para cancelar o upload, clique em Cancelar importação. 
    • Para concluir o processo, clique em Importar arquivo.
      A mensagem "Tudo pronto!" é exibida.
    • Se uma mensagem de erro for exibida, siga as instruções dessa mensagem.
  7. Clique em Importar outro arquivo ou Concluído. 

Arquivo de e-mail

Anunciantes e ad networks podem enviar arquivos CSV do Cost Import por e-mail.

Pré-requisitos:

Para enviar o arquivo CSV por e-mail:

  1. Obtenha o token para importação por e-mail.
    1. Na AppsFlyer, no menu lateral, selecione Configurações > Cost Import. 
    2. No canto superior direito da página, clique em Token para importação por e-mail.
    3. Copie e salve o token.
  2. Preencha o e-mail com os seguintes campos: 
    • Para: adspend-upload@appsflyer.com
    • CC: usuários que devem receber uma cópia do feedback automático
    • Assunto: cole o token de importação por e-mail no campo de assunto. 
    • Anexo: arquivo CSV com os dados.
  3. Envie o e-mail.
    • Uma vez que o arquivo é recebido e processado, um e-mail de status resume os detalhes, problemas ou erros encontrados durante o processamento. O e-mail é enviado a todos que fazem parte do e-mail de envio e ao administrador. Quando erros forem identificados, siga as instruções da mensagem de erro.
    • Você pode ver o status dos arquivos enviados no dashboard do Cost Import

Dashboard

O dashboard do Cost Import permite que você faça upload de arquivos e visualize os detalhes de arquivos enviados anteriormente.

Dashboard do Cost Import

Para visualizar o dashboard do Cost Import, abra a AppsFlyer e, no menu lateral, selecione Configurações > Cost Import.

Detalhes sobre as informações disponíveis para arquivos importados anteriormente estão descritos na tabela a seguir.

Nome da coluna Descrição
Nome do arquivo CSV O nome dos arquivos de custo enviados para a AppsFlyer.
Data de upload Data em que o arquivo foi importado.
Fonte de mídia Fonte de mídia incluída no arquivo.
Intervalo de datas Primeira e última datas do arquivo em que houve investimento em anúncios.
Linhas correspondentes (%) A porcentagem de linhas no arquivo com correspondência entre o custo e a atribuição. Saiba mais. 
Status

O status do arquivo importado:

  • Success: ação concluída com sucesso. O custo é registrado e fica disponível nos dashboards e relatórios da AppsFlyer.
  • Validation error: problema no sistema da AppsFlyer. Aguarde 10 minutos e tente novamente. Se falhar novamente, entre em contato com o suporte da AppsFlyer.
  • No permissions: o token não foi aprovado para esse aplicativo.
    • Anunciantes: certifique-se de que o app ID está correto.
    • Ad networks: confirme com o anunciante se ele concedeu a permissão para usar o Cost Import.
  • Reverted: ação concluída com sucesso. O arquivo foi substituído por outros dados.
Ação
  • No nível do arquivo: se você tem permissões para todos os aplicativos contidos no arquivo, você pode:
    • Baixar o arquivo CSV: essa é uma cópia do arquivo CSV importado.
    • Baixar o relatório sem correspondência para todos os aplicativos no arquivo. Veja a seção de correspondência de linhas dessa tabela para saber mais.
  • No nível do aplicativo: se você clicar em um arquivo específico, as informações sobre o Cost Import para o aplicativo serão exibidas a partir do arquivo específico, bem como de outros arquivos. Se você tem permissão para o aplicativo, você pode:
    • Baixar os dados do aplicativo.
    • Baixar um relatório sem correspondência para o aplicativo
    • Reverter (cancelar) o Cost Import para o aplicativo selecionado.

Correspondência de linhas

A correspondência de linhas é o processo onde o custo relatado via upload é combinado com os dados de atribuição registrados na AppsFlyer. Isso é feito usando todos os nomes de dimensão (não IDs) disponíveis, como fonte de mídia, campanha, conjunto de anúncios, anúncio, etc. Se todas as linhas corresponderem, elas serão designadas como is-matching=TRUE.

O custo é registrado e fica disponível nos dashboards e relatórios da AppsFlyer, independentemente do status de correspondência.

A porcentagem de linhas correspondentes é exibida no dashboard do Cost Import. Se linhas não correspondentes forem inesperadas ou o número de linhas correspondentes (%) for maior do que o esperado:

  • Baixe o relatório "Unmatched" para investigar a causa. O relatório "Unmatched" contém uma coluna "is-matched", que pode ter um valor de linhas TRUE (com correspondência) ou FALSE (sem correspondência).
  • Se necessário, cancele a importação.
  • Veja a seção "Ação" dessa tabela para mais detalhes.

Informações adicionais

Usar o Excel ou o Google Planilhas para preparar o arquivo CSV

Ao usar o Excel/Google Planilhas para criar um arquivo CSV, as colunas de data e investimento precisam ser formatadas corretamente antes de salvar o arquivo como CSV. Após salvar o arquivo, verifique se o conteúdo está formatado corretamente. Use as seguintes diretrizes para:

  • Formatar as células de data.
  • Formatar as células de investimento.
  • Verificar o formato do conteúdo.

Formatar células de data

Para formatar células de data no Excel com o formato AAAA-MM-DD:

  1. Selecione as células a serem formatadas.
  2. Clique com o botão direito e selecione Formatar células.
    A janela de formatação de células é aberta.
    Formatdate..png
  3. Selecione Personalizada.
  4. No campo "Tipo", insira AAAA-MM-DD
  5. Clique em OK.
    A data é formatada.

Formatando células de investimento

O Excel geralmente formata células de valor com vírgula para separar os milhares, conforme mostrado na figura. Esse formato não é adequado para arquivos do Cost Import. 

mceclip1.png

Para formatar células de investimento sem uma vírgula que separa os milhares: 

  1. Selecione as células a serem formatadas.
  2. Clique com o botão direito e selecione Formatar células.
    A janela de formatação de células é aberta.
  3. Selecione Número.
    Formatnumbers.png
  4. Desmarque Usar separador de 1000 (,).
  5. (Opcional) Defina o número de Casas decimais. O padrão é 2. O máximo permitido é 5.
  6. Clique em OK.
    As células estão formatadas corretamente.

Verifique o formato do conteúdo

Para verificar o formato do conteúdo:

  1. Use um editor para visualizar o arquivo.
    • Windows: Notepad, Notepad++
    • macOS: TextEdit
  2. Preste atenção em:
    • Espaços em branco: certifique-se de que não há espaços em branco à esquerda ou à direita antes ou depois das vírgulas que separam os campos. No Excel, use o comando @trim para remover espaços em branco.
    • Data: certifique-se de que as células de data tenham o formato AAAA-MM-DD.
    • Investimento: certifique-se de que não haja vírgulas nas células de investimento.
    • Delimitadores: devem ser vírgulas. Se forem ponto e vírgula:
      • Isso ocorre quando as configurações do seu computador estão definidas para um idioma/região região diferente do inglês, especialmente o alemão.
      • A solução varia de acordo com o sistema operacional do seu computador (macOS ou Windows).
      • Para resolver esse problema, procure as orientações mais recentes da Microsoft ou de outros fóruns. Use os seguintes termos de pesquisa: alterar o delimitador de arquivos CSV no Excel (macOS ou Windows).

Veja a captura de tela abaixo com um exemplo de arquivo CSV exibido em um editor.

mceclip1.png

Token para importação de e-mail

O token para importação de e-mail é usado para verificar se o remetente está autorizado a enviar o arquivo do Cost Import.

Os tokens do anunciante e da ad network são diferentes:

  • Token do anunciante:
    • O mesmo token é usado para todos os aplicativos da conta.
    • Qualquer usuário da conta pode obter o token.
  • Token da ad network:
    • O mesmo token é usado para todos os anunciantes.

Anunciantes e ad networks não devem compartilhar seus tokens entre si!

Permissões do Cost Import para ad networks

As ad networks exigem a permissão do anunciante por aplicativo para acessar o Cost Import.

Para conceder a permissão do Cost Import:

  1. Na AppsFlyer, o anunciante precisa acessar o menu lateral e selecionar Colaborar > Integrações ativas. 
    A página "Parceiros integrados" é exibida.
  2. Escolha o parceiro integrado.
  3. Acesse a aba de Permissões.
  4. Ative Permissões da ad network, se ainda não fez isso.
  5. (Opcional) Adicione os usuários da conta.
  6. Ative Usar Cost Import.
  7. Clique emSalvar permissões.

Solução de problemas, características e limitações

Mensagens de erro e soluções

A tabela abaixo lista todas as mensagens de erro possíveis do Cost Import e suas respectivas soluções. 

Mensagem de erro Descrição Solução
Nenhum dos app IDs fornecidos no arquivo existe na AppsFlyer. Verifique a precisão dos app IDs. O app ID não existe na conta. Altere o app ID e reenvie-o.
A linha [nome da linha] possui o número errado de colunas. [Número] colunas esperadas, [número] colunas recebidas. Todas as colunas do arquivo devem ter um valor. Altere os valores preenchidos no arquivo com base nos headers definidos.
Falta "media-source" no header do arquivo.
  • Falta o header do arquivo "media-source".
  • O nome da coluna precisa ser exatamente como está no esquema.
Adicione "media-source" como nome do header.
O arquivo pode conter apenas uma fonte de mídia. Várias fontes de mídia encontradas no arquivo: [número de fontes de mídia].  O arquivo contém mais de uma fonte de mídia. No CSV, linhas vazias ocultas ou linhas inválidas também podem acionar esse erro, mesmo que não estejam visíveis no Excel. Abra o arquivo em um editor de texto, como o Notepad++, e remova quaisquer linhas vazias ou inválidas. Salve o arquivo e faça upload novamente. Se o arquivo tiver mais de uma fonte de mídia, crie um arquivo para cada uma.
O valor fornecido [valor] para [campo] não é válido para esta coluna. O formato dos dados na coluna está incorreto. Por exemplo, a data é dd-mm-aa em vez de aaaa-mm-dd. Corrija o formato e reenvie. 
Várias moedas identificadas para o aplicativo. Use uma moeda única para cada aplicativo no arquivo. Moedas encontradas: %number of currencies%. Apenas uma moeda pode ser usada para um aplicativo. Use uma moeda no upload e reenvie.
As seguintes colunas no header do arquivo não são compatíveis: [file headers] O header do arquivo não corresponde ao esquema. Ou seja, o nome da coluna precisa ser exatamente como está no esquema. Remova as colunas incompatíveis e reenvie.
Colunas obrigatórias ausentes no header do arquivo: [file headers] Falta uma coluna obrigatória no header do arquivo. Adicione a coluna ausente e seus valores e reenvie.
O aplicativo contém uma data futura: [date] Datas futuras não são permitidas. Corrija a data para o dia de hoje ou uma data anterior e reenvie.
O arquivo está vazio. Não há dados para processar. O arquivo está vazio. Preencha os dados no arquivo e reenvie.
As duas linhas a seguir apresentam conflito porque têm dimensões idênticas. Forneça uma única linha de investimento por conjunto de dimensões. [conflicting rows] Existe mais de uma linha com os mesmos campos principais (obrigatórios). Remova as linhas duplicadas e reenvie.
O arquivo pode conter dados somente de uma única conta de anunciante. Diferentes anunciantes encontrados no arquivo: [advertiser names] O upload de um parceiro não pode ser feito para mais de um anunciante. Faça upload de um arquivo por anunciante.
O aplicativo [app ID] não existe na conta. Verifique o app ID. O app ID não existe. Corrija o app ID e reenvie.
O código de geolocalização (país) não foi encontrado para o aplicativo [app ID]. Use um código ISO 3166 de 2 letras A geolocalização não existe. Corrija a geolocalização e reenvie.
O código da moeda não foi encontrado para o aplicativo [app ID]. Use um código ISO 4217 de 3 letras. A moeda não existe Altere a moeda para uma moeda válida e reenvie.
Ocorreram erros de validação para um ou mais aplicativos no arquivo. Revise as informações do arquivo para obter mais detalhes. Há mais de um erro no arquivo. Baixe o arquivo e verifique se há erros.
Ocorreu um erro interno ao processar o arquivo. Tente carregá-lo novamente.
  • Problema de backend ao processar o arquivo.
  • Esse problema costuma ser temporário.
Aguarde 1 hora e faça upload novamente.

Características e limitações

Caraterística Observações 
Ad networks

Compatíveis.

Exceções:

  • Meta Ads
  • X Ads
  • ASA
Agências
  • As agências não podem fazer upload de dados. Elas podem preparar seus arquivos e enviá-los ao anunciante para upload.
  • Para isso, os arquivos CSV devem conter uma coluna "Agência" com o nome da agência (que é o valor do parâmetro af_prt). Ver esquema CSV
Transparência das agências Indisponível
Fuso horário específico do aplicativo Disponível
Moeda específica do aplicativo  Disponível. Os custos da campanha são convertidos para a moeda específica do aplicativo.
Nome da campanha O mesmo nome de campanha não pode ser usado para vários aplicativos, ou o custo de um aplicativo será aplicado a ambos.
Nomes dos campos

Se os nomes dos campos na hierarquia da campanha não corresponderem aos nomes dos campos conforme aparecem nos dados de atribuição, eles serão contabilizados separadamente. 

Por exemplo, se os nomes das campanhas não corresponderem, elas serão consideradas campanhas diferentes, mesmo que tenham os mesmos IDs.

Tamanho do arquivo

Ao enviar um arquivo CSV de Cost Import, o limite de tamanho é:

  • Dashboard da AppsFlyer: 2 MB
  • E-mail: 5 MB por arquivo
Dados orgânicos Disponíveis
Dados não orgânicos Disponíveis
Atualização dos dados Ad spend
Dados históricos Disponíveis. Os custos reportados podem ser revertidos e os dados corrigidos podem ser enviados em até 90 dias.
Retargeting Indisponível.
Acesso do usuário à conta Indisponível para usuários com restrições de geolocalização ou fonte de mídia.