Cost Import: guia

O formato, esquema e as regras de validação do do arquivo CSV estão detalhados aqui. Se você usar o Excel ou Google Sheets para criar o arquivo, consulte as instruções de formatação do Excel . 

Ver arquivo de amostra

Antes de continuar lendo, observe os erros mais comuns cometidos na preparação do arquivo CSV, conforme mostrado na captura de tela a seguir.  

O formato do arquivo CSV de gastos com anúncios, o esquema e as regras de validação são detalhados nas seções a seguir. Se você usar o Excel ou Google Sheets para criar o arquivo, consulte as instruções de formatação do Excel .

Regras de conteúdo e esquema de arquivos CSV

Esquema do CSV de Ad Spend

O token de Ad Spend é usado para verificar se o remetente do e-mail está autorizado a enviar o arquivo de 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 recuperar o token de Ad Spend
• Token da ad network:
  • O mesmo token é usado para todos os anunciantes. 
  • Além disso, o anunciante precisa conceder permissão à ad network para enviar arquivos de ingestão. 

Para obter o token de ad spend:

1. Na AppsFlyer, no menu lateral, selecione Configurações > Cost Import.
2. No canto superior direito da página, clique em Visualizar token de Ad Spend.
   O token de Ad Spend é exibido.  
3. Copie e salve o token.

Para conceder a permissão de Cost Import:

1. Na AppsFlyer, o anunciante precisa acessar menu lateral e selecionar Colaborar > Integrações ativas. 
   A página de Parceiros Integrados é exibida.
2. Selecione o parceiro em questão.
3. Acesse a aba de permissões. 
   
4. Ative Permissões da ad network, se ainda não o tiver feito.
5. (opcional) Adicione usuários da conta.
6. Ativar Permitir importação de gastos.
   

Pré-requisitos do e-mail:

• Anunciantes:
  • O token de Ad Spend é obrigatório. 
  • O e-mail do remetente deve ser um usuário registrado da AppsFlyer.
• Ad networks:
  
  • O token de Ad Spend é obrigatório. 
  • O e-mail do remetente deve ser um usuário registrado da AppsFlyer.
  • O anunciante precisa conceder ao parceiro (ad network) permissão de Cost Import. 

Para enviar o arquivo de ad spend por e-mail:

1. Preencha os campos de endereço de e-mail:  
   • Para:adspend-upload@appsflyer.com
   • CC: Usuários que devem receber uma cópia automática das respostas ao e-mail
   • Assunto: Cole o token de A Spend no campo de assunto. 
   • Anexar: Arquivo CSV com os dados.
2. Envie o e-mail.
   • Após a conclusão do processamento, um e-mail de status é enviado resumindo o upload e detalhando problemas ou erros encontrados durante o processo. O e-mail é enviado a todos que fazem parte do e-mail de envio e ao anunciante administrador. Quando forem identificados erros, você deverá tomar medidas corretivas. Observação: se o e-mail de status não foi recebido, veja aqui.
   • Você pode ver o status dos arquivos enviados na página de Cost Import

Para fazer o upload do arquivo de ad spend:

1. Na AppsFlyer, no menu lateral, selecione Configurações > Cost Import.
   A página de Cost Import é exibida. 
2. Clique em + importar arquivo de Ad spend
   A janela de importar Ad spend é exibida.
   
3. Arraste o arquivo CSV para a janela Importar arquivo de Ad spend.
   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 é exibida.

   

6. Siga um dos procedimentos abaixo:
   • Para cancelar o upload e clique em Cancelar ingestão.  
   • Para concluir o processo de ingestão, clique em importar arquivo.
     A mensagem "Tudo pronto!" aparece.
7. Clique em importar outro arquivo ou em Concluído.

Para ver o status no nível do arquivo:

• Na AppsFlyer, no menu lateral, selecione Configurações > Cost Import.
  A página Cost Import exibe a lista de arquivos enviados.
• Se você tiver permissões de aplicativo para todos os aplicativos contidos no arquivo, use o comando Ação para
  
  • Baixar o arquivo CSV: essa é uma cópia do arquivo enviado.
  • Baixar o relatório sem correspondência para todos os aplicativos no arquivo.

Para ver o status no nível do aplicativo:

• Selecione o arquivo.
  A página no nível do aplicativo é exibida. A lista de aplicativos no arquivo de ad spend é exibida.

  

• Execute ações no nível do arquivo ou do aplicativo conforme descritas aqui.
• Nível do arquivo: se você tiver as permissões de aplicativo para todos os aplicativos contidos no arquivo, você poderá usar os controles no canto superior direito da página para:  
  • Reverter (cancelar) o Cost Import para todos os aplicativos no arquivo. 
  • Baixar uma cópia do arquivo CSV que foi enviado.  
• Nível do app: se você tiver a permissão de aplicativo para um aplicativo específico, você poderá usar o comando Ação para:
  • Baixar os dados do aplicativo.
  • Baixar um relatório sem correspondência para o aplicativo
  • Reverter (cancelar) o Cost Import para o aplicativo selecionado. 

A correspondência de linhas é o processo no qual o mecanismo de importação faz a correspondência entre as linhas de ad spend e os dados de atribuição registados no dashboard. Isso é feito utilizando todas as dimensões disponíveis no esquema do arquivo, como canal de mídia, campanha, adset, anúncio, etc. Se todas as linhas corresponderem, elas serão designadas como is-matching=TRUE.  

Nomes vs. IDs

O Cost Import identifica uma dimensão, como campanha, adset ou anúncio, de acordo com o seu nome, sem o ID. Atualmente, o Cost Import não possui suporte para relatórios de gastos usando somente IDs.

Observação: independentemente do status de correspondência, o gasto é registrado.

A porcentagem de linhas pareadas é apresentada na página de importação.

Se você não espera encontrar linhas sem correspondência, baixe o relatório sem correspondência para investigar a causa. Se necessário, cancele a importação.

O relatório sem correspondência contém uma coluna, com correspondência, que pode ter um valor de linhas TRUE (com correspondência) ou FALSE (sem correspondência).

Página do Cost Import que apresenta a porcentagem de linhas pareadas

O ad spend ingeridos anteriormente pode ser substituído usando arquivos CSV que contêm dados com a mesma chave dos dados ingeridos anteriormente.

A chave é formada a partir dos campos data, canal de mídia e campanha. Se as chaves coincidirem, os dados importados por último substituem os dados importados anteriormente.

Os exemplos a seguir ilustram a substituição do ad spend.

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

Sintoma 1: os dados de custos não são exibidos após uma importação bem-sucedida

1. No dashboard, verifique se o nome da campanha foi exibido mais de uma vez.
2. Nesse caso, localize a linha onde o ID da campanha está em branco.
   A linha com o ID da campanha em branco contém o custo.  

Sintoma 2: O custo importado é exibido em uma linha separada (linha adicional) sem dados de performance (instalações). O ID da campanha na linha está em branco.

Causa: quando o ID e o nome da campanha existem nos dados de atribuição, o CSV deve conter ambos para que a AppsFlyer faça a correspondência correta com os dados de custo e evite itens de linha separados.

Ao usar o Excel/Google Sheets para criar um arquivo CSV, as colunas de data e gastos precisam ser formatadas corretamente antes de salvar o arquivo como um arquivo CSV. Siga os procedimentos a seguir para formatar corretamente os campos de data e gastos.  

Após salvar o arquivo CSV, verifique se o conteúdo está formatado corretamente. Observação: não use o Excel para fazer a verificação, use um editor.  

Formatando células de data no Excel

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 formatar células é aberta.
   

   

3. Selecione Personalizada.
4. No campo Tipo, insira AAAA-MM-DD
5. Clique em OK.
   A data está formatada.

Formatando células de gastos no Excel

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 de importação de Ad Spend. 

Você pode corrigir isso formatando as células no Excel.  

Para formatar os valores gastos sem um separador de 1000:  

1. Selecione as células a serem formatadas.
2. Clique com o botão direito e selecione Formatar células.
   A janela formatar células é aberta.
3. Selecione Número.
   

   

1. Desmarque Usar separador de 1000 (,). 
2. (Opcional) Defina o número de Casas decimais. O padrão é 2.  O máximo permitido é 5. 
3. Clique em OK.
   As células estão formatadas corretamente.

Para examinar o conteúdo do arquivo CSV, use um editor para visualizar o arquivo.  

• Windows: Notepad, Notepad++
• macOS: TextEdit

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

Visualização do editor

Usando um editor, examine o arquivo CSV. 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 o campo de data tenha o formato AAAA-MM-DD.  
• Gastos: certifique-se de que não haja vírgula no campo gastos.
  

   

Se o Excel criar um arquivo CSV com ponto e vírgula ";" ou outro caractere como delimitador, mas não como vírgula:

• Isso ocorre quando as configurações regionais do seu computador estão definidas para um idioma/região que não é o inglês.
• Esse problema é particularmente prevalente quando o alemão é selecionado nos contextos regionais.
• A solução difere dependendo do 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: Operating system (macOS or Windows) Excel change delimiter for CSV files.

Provavelmente isso significa que o arquivo de ad spend não foi processado. Isso pode acontecer por vários motivos:

Conteúdo incorreto

A AppsFlyer processa apenas mensagens com o content-type multipart/mixed. Outros tipos não são processados e, consequentemente, nenhum e-mail de status é gerado e enviado. Normalmente, e-mails enviados com anexos são automaticamente definidos como multipart/mixed.

Para garantir que o tipo de conteúdo da mensagem seja multipart/mixed, visualize o valor do content-type no header do e-mail.

• Para visualizar o cabeçalho da mensagem de email no Gmail, siga a documentação do Gmail.
• Para visualizar o header do e-mail no Outlook, siga a documentação do Outlook.

O HTML da mensagem de e-mail não está formatado corretamente

Erros de HTML podem impedir o processamento correto do e-mail. Por exemplo, a tag está vazia ou ausente. Verifique seu script em busca de erros de HTML.

Os anunciantes e as agências podem preparar arquivos CSV para enviar e importar dados de custos. 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

Considere o seguinte:

• Apenas uma agência pode ser incluída em um arquivo. Além disso, apenas campanhas gerenciadas por essa agência podem ser incluídas no arquivo.
• O nome da agência é obrigatório por linha. Não são permitidas células em branco na coluna agência.
• A agência deve ter permissão para todos os aplicativos incluídos no arquivo.
• Somente anunciantes podem fazer o 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.