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:
- Preparar o arquivo CSV com os dados de custo a serem enviados.
- Enviar o arquivo para a AppsFlyer por:
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 |
|
|
✓ |
| app-id |
|
|
✓ |
| media-source |
|
network_x_int | ✓ |
| campaign |
|
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 |
|
2874.12345
|
✓ |
| reported-clicks |
|
1200 | Não |
| reported-impressions |
|
45000 | Não |
| geo |
|
US, CN, AU
|
Não |
| currency |
|
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 |
|
id1213mno | Não |
| channel | Formato: string | video | Não |
| keywords | Formato: string |
|
Não |
| agency |
|
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 |
|
| 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:
- Na AppsFlyer, no menu lateral, selecione Configurações > Cost Import.
A página do Cost Import é exibida. - Clique em + Importar arquivo de custo
A janela do Cost Import é aberta.
- Arraste o arquivo CSV para a janela Importar arquivo de custo.
A mensagem "Processando arquivo" é exibida. - Se uma mensagem de erro for exibida durante o upload: corrija o erro e repita as etapas necessárias.
- A janela Cost Import: resumo do arquivo é aberta.
- 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.
- 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:
-
Anunciantes:
- O e-mail do remetente deve ser um usuário cadastrado da AppsFlyer.
-
Ad networks:
- O e-mail do remetente deve ser um usuário cadastrado da AppsFlyer.
- Permissão do Cost Import concedida pelo anunciante.
Para enviar o arquivo CSV por e-mail:
- Obtenha o token para importação por e-mail.
- Na AppsFlyer, no menu lateral, selecione Configurações > Cost Import.
- No canto superior direito da página, clique em Token para importação por e-mail.
- Copie e salve o token.
- 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.
-
Para:
-
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:
|
| Ação |
|
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:
- Selecione as células a serem formatadas.
- Clique com o botão direito e selecione Formatar células.
A janela de formatação de células é aberta. - Selecione Personalizada.
- No campo "Tipo", insira AAAA-MM-DD
- 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.
Para formatar células de investimento sem uma vírgula que separa os milhares:
- Selecione as células a serem formatadas.
- Clique com o botão direito e selecione Formatar células.
A janela de formatação de células é aberta. - Selecione Número.
- Desmarque Usar separador de 1000 (,).
- (Opcional) Defina o número de Casas decimais. O padrão é 2. O máximo permitido é 5.
- Clique em OK.
As células estão formatadas corretamente.
Verifique o formato do conteúdo
Para verificar o formato do conteúdo:
- Use um editor para visualizar o arquivo.
- Windows: Notepad, Notepad++
- macOS: TextEdit
- 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.
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:
- Na AppsFlyer, o anunciante precisa acessar o menu lateral e selecionar Colaborar > Integrações ativas.
A página "Parceiros integrados" é exibida. - Escolha o parceiro integrado.
- Acesse a aba de Permissões.
- Ative Permissões da ad network, se ainda não fez isso.
- (Opcional) Adicione os usuários da conta.
- Ative Usar Cost Import.
- 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. |
|
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. |
|
Aguarde 1 hora e faça upload novamente. |
Características e limitações
| Caraterística | Observações |
|---|---|
| Ad networks |
Compatíveis. Exceções:
|
| Agências |
|
| 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 é:
|
| 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. |