Importar dados de custo

Premium
Para:
Profissionais de marketing Agências
Última atualização:

Resumo: o Cost Import, parte do ROI360 da AppsFlyer, permite que os anunciantes tenham uma cobertura completa e precisa de seus custos de marketing ao importar arquivos CSV via 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 de influenciadores, CTV e mais) para a AppsFlyer. Isso é particularmente importante para fontes de mídia que não relatam custos via API ou link de atribuição.
  • Substitua e corrija retroativamente os dados de custo existentes.

O custo é relatado por meio de arquivos CSV ou enviados por e-mail para a AppsFlyer. Uma vez que a AppsFlyer recebe o arquivo, os dados são processados e ficam disponíveis nos seus dashboards e relatórios dentro de algumas horas. Com isso você tem uma visão completa dos custos da sua campanha e do seu ROI.

Atenção:

  • As ad networks podem importar arquivos de custo para seus clientes se as permissões relevantes forem fornecidas.
  • As agências podem preparar arquivos, mas os anunciantes devem enviá-los.

Procedimentos

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 via:
    • Upload na interface da AppsFlyer.
    • E-mail Atenção: Para aplicativos em plataformas 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 de Cost Import. Ver arquivo de amostra

Para preparar o arquivo CSV:

Esquema CSV

Nome da coluna 

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

Formato/observação

Exemplo

Obrigatoriedade

data
  • A data em que o custo ocorreu
  • Formato: String
    (Recomendado):
    • AAAA-MM-DD
    • AAAA/MM/DD
    • MM/DD/AAAA
    • MM/DD/AAAA 
  • Datas futuras não permitidas
  • Prática recomendada: utilize o mesmo fuso horário definido para o seu app na AppsFlyer.
  • Atenção: Você está usando Excel/Google Sheets 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 como ele 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.
    • Somente um canal de mídia por arquivo é permitido./span> São permitidos vários aplicativos para o mesmo canal de mídia

network_x_int

✓

campaign
  • Formato: String
  • Nome da campanha. Se o nome da campanha aparecer na ad network, o nome nesse arquivo deve corresponder a ele (sensível a 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:
    • Separadores de 1.000 com vírgula não são permitidos, por exemplo: "2,874.12".
    • Você está usando Excel/Google Sheets para preparar o arquivo? Leia aqui.

2874.12345

 

 

✓

geo
  • Formato: String
  • Código de duas letras do país, seguindo as regras 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, seguindo as regras ISO 4217.  Atenção: envie três caracteres, sem espaços em branco no início ou no final.
  • No arquivo, é permitido um código de moeda por aplicativo. Ddiferentes aplicativos podem ter diferentes códigos de moeda .

USD, GBP, EUR, JPY

Não.

O padrão será USD se deixado em branco.

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 único que identifica o publisher que exibe o anúncio. Saiba mais
id1213mno Não

channel

 Formato: String   video Não

keywords

Formato: String
  • better
  • better you app
  • better you online
 Não

agency
  • Formato: String
  • O nome da agência. O valor no parâmetro af_prt)
  • 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 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.
 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 filename

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 o upload de determinados campos, eles não devem ser enviados no arquivo.

Hierarquia publicitária 

O custo deve ser registrado no nível da campanha, sendo opcionais outras dimensões na hierarquia de publicidade.

Quaisquer dados parciais enviados em uma hierarquia inferior substituirão todos os dados do nível da campanha para baixo.

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 de Cost Import.

Pré-requisitos: As ad networks exigem permissão de Cost Import do anunciante.

Para enviar o arquivo CSV via interface do usuário da AppsFlyer:

  1. Na AppsFlyer, no menu lateral, selecione Configurações > Cost Import.
    A página de Cost Import é exibida. 
  2. Clique em + Importar arquivo de custo
    A janela de Cost import se abre.
  3. Arraste o arquivo CSV para a janela de importação de 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 é exibida.
  6. Faça uma das seguintes opções:
    • Para cancelar o upload, clique em Cancelar ingestão.  
    • Para concluir o processo, clique em importar arquivo.
      A mensagem "Tudo pronto!" aparece.
    • Se uma mensagem de erro for exibida, siga as instruções da mensagem de erro.
  7. Clique em importar outro arquivo ou em concluído. 

Arquivo de e-mail

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

Pré-requisitos:

  • Anunciantes:
    • O e-mail do remetente deve ser um usuário cadastrado da AppsFlyer.
  • Ad networks:

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 de e-mail.
    3. Copie e salve o token.
  2. Coloque os seguintes campos no 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 para importação no campo de assunto.
    • Anexar: 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 são identificados, siga as instruções da mensagem de erro.
    • Você pode ver o status dos arquivos enviados no dashboard de Cost Import

Dashboard

O dashboard de Cost Import é o local onde você pode enviar arquivos e visualizar detalhes de arquivos enviados anteriormente.

Dashboard de Cost Import

Para visualizar o dashboard de 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
CSV file name O nome dos arquivos de custo enviados para a AppsFlyer.
Upload date Data em que o arquivo foi enviado.
Media source Canal de mídia incluído no arquivo.
Date range Primeiras e últimas datas no arquivo em que o gasto com anúncios ocorreu.
Matched rows (%) 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 que ele lhe deu permissão para usar o Cost Import. 
  • Reverted: ação concluída com sucesso. O arquivo foi substituído por outros dados.
Action
  • At the file level: se você tiver 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.
  • At the app level: Se você clicar em um arquivo específico, as informações sobre todos os Cost Import para o aplicativo serão exibidas, a partir daquele arquivo específico, bem como outros arquivos. Se você tiver 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 canal 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 de 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, com correspondência, 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 desta tabela para detalhes.

Informações adicionais

Usar o Excel ou Google Sheets para preparar o arquivo CSV

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. 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 gasto.
  • 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 formatar 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 gastos

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 Cost Import. 

mceclip1.png

Para formatar células de gastos sem uma vírgula de milhar: 

  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.
    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. 
    • Gastos: Certifique-se de que não haja vírgulas nas células de gastos.
    • Delimitadores: devem ser vírgulas. Se forem ponto e 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, mais especificamente o alemão.
      • 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.

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 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 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 de 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 de Cost Import:

  1. Na AppsFlyer, o anunciante precisa acessar o menu lateral e selecionar Colaborar > Integrações ativas.
    A página de 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 o tiver feito.
  5. (opcional) Adicione 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.
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 um canal de mídia. Vários canais de mídia encontrados no arquivo: [número de canais de mídia].   Não é possível fazer upload de um arquivo com mais de um canal de mídia. Divida o upload em um arquivo para cada canal de mídia.
O valor fornecido [valor] para [campo] não é um valor 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: %número de moedas%. 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: [headers do arquivo] 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 não suportadas e reenvie.
Colunas obrigatórias ausentes no cabeçalho do arquivo: [cabeçalhos de arquivo] 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: [data] Datas futuras não são permitidas. Corrija a data para a data de hoje ou para 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 entram em conflito devido a dimensões idênticas. Forneça uma única linha de gastos por conjunto de dimensões. [linhas em conflito]. Existe mais de uma linha com os mesmos campos-chave (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: [nomes dos anunciantes] O upload de um parceiro não pode ser feito para mais de um anunciante. Faça o 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 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.
  • Normalmente, esse é um problema temporário.
 Aguarde 1 hora e faça o upload novamente.

Características e Limitações

Caraterística Observações 
Ad networks

Suportado.

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 da aplicação Disponível
Moeda específica da aplicação  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 contados separadamente. 

Por exemplo, se os nomes das campanhas não corresponderem, mesmo que os IDs das campanhas sejam iguais, eles serão contados como campanhas diferentes.
Tamanho do arquivo Ao enviar um arquivo CSV de Cost Import, o limite de tamanho é:
  • Através do dashboard da AppsFlyer: (2 MB)
  • Por e-mail: 5 MB por arquivo
Dados orgânicos Disponível
Dados não orgânicos Disponível
Atualização dos dados Ad spend
Dados históricos Disponível 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 canal de mídia.