Guia Ingestão de gastos com anúncios

O formato do arquivo CSV de gastos com anúncios, o esquema e as regras de validação são detalhados aqui. Se você usar planilhas do Excel ou do Google para criar o arquivo, deverá consultar 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 planilhas do Excel ou do Google para criar o arquivo, deverá consultar as instruções de formatação do Excel .

Regras de conteúdo e esquema de arquivos CSV de gastos com anúncios.

Esquema CSV de gastos com anúncios

O token de gastos com anúncios é usado para verificar se o remetente do e-mail está autorizado a enviar o arquivo de ingestão de gastos com anúncios. 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 gastos com publicidade
• 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 gasto com anúncios:

1. Na AppsFlyer, acesse ROI360 > Ingestão de gastos com anúncios. 
2. No canto superior direito da página, clique em Visualizar token de gasto com anúncios.
   O token de gasto com anúncios é exibido. 
3. Copie e salve o token de gastos com anúncios.

Para conceder permissão de ingestão de gastos com anúncios à ad network:

1. Na AppsFlyer, o anunciante precisa acessar Configuração > Integrações ativas. 
   A página Parceiro integrado é exibida.
2. Selecione o parceiro integrado.
3. Acesse a aba Permissões. 
   
4. Ative Permissões da ad network, se ainda não o tiver feito.
5. (opcional) Adicione usuários da conta.
6. Ative Permitir ingestão de gastos.
   

Pré-requisitos do e-mail:

• Anunciantes: o token de gasto com anúncios é obrigatório.
• Ad networks:
  
  • O token de gasto com anúncios é obrigatório. 
  • O anunciante precisa conceder ao parceiro (ad network) permissão de ingestão de gastos com anúncios. 

Para enviar o arquivo de gastos com anúncios 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 do feedback automático
   • Assunto: cole o token Gasto com anúncios no campo de assunto. 
   • Anexo: 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 processamento. O e-mail é enviado a todos que fazem parte do e-mail de envio e ao administrador do anunciante. 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 visualizar o status dos arquivos enviados na página Ingestão de gastos com anúncios

Para fazer upload do arquivo de gastos com anúncios:

1. Na AppsFlyer, acesse ROI360 > Ingestão de gastos com anúncios.
   A página Ingestão de gastos com anúncios é exibida. 
2. Clique em + Arquivo de ingestão de gastos com anúncios
   A janela Ingerir gastos com anúncios é aberta.
   
3. Arraste o arquivo CSV para a janela Arquivo de ingestão de gastos com anúncios .
   A mensagem Processando arquivo é exibida.
4. Se uma mensagem de erro for exibida durante o upload: corrija o erro e repita as etapas relevantes. 
5. A janela Ingestão de gastos com anúncios: resumo do arquivo é aberta.

   

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

Para visualizar o status de ingestão no nível do arquivo:

• Vá para ROI360 > Ingestão de gastos com anúncios.
  A página Ingestão de gastos com anúncios 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 arquivo CSV: é uma cópia do arquivo CSV que foi carregado.
  • Baixar o relatório incomparável para todos os aplicativos no arquivo.

Para visualizar o status de ingestão no nível do aplicativo:

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

  

• Execute ações no nível do arquivo ou do aplicativo conforme descrito aqui.
• Nível de arquivo: se você tiver permissões de aplicativo para todos os aplicativos contidos no arquivo, poderá usar os controles no canto superior direito da página para: 
  • Reverter (cancelar) a Ingestão de gastos com anúncios para todos os aplicativos no arquivo. 
  • Baixar uma cópia do arquivo CSV que foi enviado. 
• Nível do aplicativo: se você tiver permissão de aplicativo para um aplicativo específico, poderá fazê-lo usando o comando Ação:
  • Download de dados do aplicativo.
  • Baixar relatório incomparável para o aplicativo
  • Reverter (cancelar) a Ingestão de gastos com anúncios do aplicativo selecionado. 

A correspondência de linhas é o processo em que o mecanismo de ingestão combina as linhas de gastos com anúncios relatadas pela ingestão com os dados de atribuição registrados no painel. Isso é feito utilizando todas as dimensões disponíveis no esquema do arquivo, como fonte de mídia, campanha, conjunto de anúncios, anúncio, etc. Se todas corresponderem, as linhas serão designadas como is-matching=TRUE. 

Nomes versus IDs

A Ingestão de gastos com anúncios identifica uma dimensão, como campanha, conjunto de anúncios ou anúncio pelo nome, sem o ID. Atualmente, a Ingestão de gastos com anúncios não é compatível com relatórios de gastos usando apenas IDs.

Observação: independentemente do status correspondente, o gasto é registrado.

A porcentagem de linhas correspondentes é exibida na página de ingestão.

Se as linhas sem correspondência forem inesperadas, baixe o relatório sem correspondência para investigar a causa. Se necessário, cancele a ingestão revertendo-a.

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 Ingestão de gastos com anúncios exibindo a porcentagem de linhas correspondentes

Os gastos com anúncios ingeridos anteriormente podem ser substituídos usando arquivos CSV que contêm dados com a mesma chave dos dados ingeridos anteriormente.

A chave é formada a partir dos campos data, fonte de mídia e campanha. Se as chaves corresponderem, os dados ingeridos por último substituirão os dados ingeridos anteriormente.

Os exemplos a seguir ilustram a substituição de gastos com publicidade.

A tabela a seguir lista todas as possíveis mensagens de erro de ingestão de gastos com anúncios e as soluções correspondentes. 

Sintoma 1: os dados de custo não são exibidos após a ingestão bem-sucedida

1. No painel, verifique se o nome da campanha é 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 ingerido é exibido em uma linha separada (linha adicional) sem dados de desempenho (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 corresponda corretamente aos dados de custo e evite itens de linha separados.

Ao usar planilhas Excel/Google para criar um arquivo CSV, as colunas de data e gastos precisam ser formatadas corretamente antes de salvar o arquivo como um arquivo CSV. Use 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 para formatar células é aberta.
   

   

3. Selecione Personalizado.
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. Este formato não é adequado para arquivos de ingestão de gastos com anúncios. 

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

Para formatar os valores gastos sem um separador de 1.000: 

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: Bloco de Notas, Bloco de Notas++
• macOS: TextEdit

A seguir está uma captura de tela do arquivo CSV de exemplo exibido em um editor. 

Visualização do editor

Ao usar um editor, examine o arquivo CSV. Preste atenção especial ao seguinte:

• 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 para resolver. Use os seguintes termos de pesquisa: Sistema operacional (macOS ou Windows) Delimitador de alterações do Excel para arquivos CSV.

Provavelmente isso significa que o arquivo de gastos com anúncios não foi processado. Isso pode acontecer por vários motivos:

Tipo de conteúdo incorreto

A AppsFlyer processa apenas mensagens com o tipo de conteúdo multipart/mixed Outros tipos não são processados e, consequentemente, nenhum email de status é gerado e enviado de volta. No caso normal, os e-mails com anexo são automaticamente definidos como multipart/mixed pelo cliente de e-mail.

Para garantir que o tipo de conteúdo da mensagem de e-mail seja multipart/mixed, visualize o valor do tipo de conteúdo no cabeçalho do e-mail.

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

O HTML da mensagem de email não está formatado corretamente

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

Anunciantes e agências podem preparar arquivos CSV para carregar e ingerir dados de custos. Para isso, os arquivos CSV devem conter uma coluna Agência com o nome da agência (o nome da agência é o valor do parâmetro af_prt). Consulte o esquema CSV

Considere o seguinte:

• Apenas uma agência pode ser incluída em um arquivo. E 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 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.