Estamos sempre publicando atualizações em nossa documentação, mas pode ser que elas ainda não estejam disponíveis em seu idioma. Para ter acesso às informações mais atualizadas, use a ​​versão em inglês.

Importação de dados de custos com anúncios

Com a solução de importação de dados da Adjust, você pode fazer o upload de dados de custos com anúncios e informações de campanha diretamente para a Adjust. Isso é útil se você mensura custos com anúncios com um parceiro que não possui integração com a Adjust.

Ao importar seus dados de custos com anúncios para o nosso sistema, eles são combinados com os dados mensurados pela Adjust para insights mais robustos e relatórios mais decisivos.

Importante:
A Adjust não pode verificar a precisão dos dados que você forneceu. Você é responsável pelos dados de custos com anúncios que enviar, que então recebem o matching e são exibidos pela Adjust.

Antes de começar

O que você precisa saber antes de começar.

Requisitos

  • É necessário estar no pacote SpendWorks Enterprise ou Custom para obter a solução de importação de dados de custos com anúncios em sua conta.
  • Permissões de Administrador ou Editor na Adjust.

Selecione um método de compartilhamento de arquivos

Siga as instruções abaixo para configurar seu método de preferência para enviar dados de custos com anúncios à Adjust.

Google Sheets

Para importar corretamente seus dados de custos com anúncios ao sistema da Adjust, você precisa configurar seu arquivo do Google Sheets em um formato específico e incluir as principais informações.

  1. Crie um arquivo do Google Sheets intitulado: [YourCompany]_[Network being integrated]_[Data type] data import.

    • Exemplo: companyname_networkname_adspend_data_import
  2. Modifique as configurações de compartilhamento para:

    • Compartilhar com permissões de View com o e-mail automate.import@adjust.com.
  3. Use o modelo de importação de dados de custos com anúncios para criar seu relatório em CSV no formato correto.

    • Verifique se não há vírgulas (,) ou cifrões ($) no documento, porque causarão erros durante a importação.
    • Não deixe nenhuma linha vazia entre as linhas de dados.
    • Confirme se não há células aleatórias preenchidas fora das linhas de dados.
  4. Configure a importação de dados de custos com anúncios na Adjust.

E-mail | AWS Redshift | Link direto

  1. Use o modelo de importação de dados de custos com anúncios para criar seu relatório em CSV no formato correto.

  2. Forneça as seguintes informações ao seu Technical Account Manager:

    • O endereço de e-mail do qual você enviará os relatórios.

    • O endereço de e-mail ao qual você enviará os relatórios. A Adjust fornece um modelo de endereço ao qual você pode adicionar um identificador, de modo que somente seus relatórios sejam enviados para esse endereço.

      • Modelo: automate.import.sa+{your_recipient_identifier_here}@adjust.com
      • Exemplo de endereço de e-mail: automate.import.sa+14et85dc9ed48c0489ed4c@adjust.com Substitua 14et85dc9ed48c0489ed4c por seu recipient_identifier.
    • A hora do dia (incluindo o fuso horário) em que você enviará os relatórios.

      • A Adjust agendará as extrações de dados da maneira correspondente.
  3. Envie relatórios ao endereço de e-mail da Adjust definido e compartilhado com o Technical Account Manager.

Formatação da coluna

Verifique se seu arquivo CSV contém os seguintes parâmetros:

  • Parâmetros obrigatórios: date, campaign_name, store_id, store_type, ad_spend

  • Recomendados: campaign_id

    • Especifique um campaign_id único para cada campanha.
  • Todos os outros campos podem ser deixados vazios se você não os recebe da rede.

Título da colunaTipo de dadosComentários
Parâmetros obrigatórios
datestringData no formato aaaa-mm-dd


  • Exemplo: 2024-07-01
  • campaign_namestringNome da campanha
    store_idstringID da Apple App Store, ID do Google Play Store ou o ID do app da web


  • Para aplicativos web, o valor de store_id precisa seguir este formato: web_{adjust_app_token}
  • store_typestring
    Possíveis valores: "google_play", "app_store" ou "web"
    ad_spenddecimalTotal de custos com anúncios no relatório, com base no parâmetro "currency" selecionado. Use o ponto (em vez da vírgula) como separador decimal.

    Não deixe esse campo em branco, use "0" caso não haja um valor.
    Parâmetro recomendado
    campaign_idstringID da campanha
    • Especifique um campaign_id único para cada campanha.
    Parâmetros opcionais
    countrystring Código ISO 3166 do país de dois dígitos


  • Exemplo: FR
  • adgroup_namestringNome do grupo de anúncios
    adgroup_idstringID do grupo de anúncios
    ad_namestringNome do anúncio/criativo
    ad_idstringID do anúncio/criativo
    source_namestringNome da fonte/aplicativo do subpublisher
    source_idstringID da fonte/aplicativo do subpublisher
    data_typestringIndica se os dados são específicos do SKAN ou não.

    Valores possíveis: skan, non_skan, unknown.

    Padrão: unknown
    currencystringCódigo de 3 letras (ISO 4217), o padrão é USD
    impressionsintegerNúmero de impressões de anúncio no aplicativo


  • Exemplo: 1000
  • clicksintegerNúmero de cliques no anúncio no aplicativo


  • Exemplo: 10
  • installsintegerNúmero de instalações do aplicativo


  • Exemplo: 1000
  • Configurar a importação de dados de custos com anúncios

    Siga os passos nesta seção se quiser enviar dados de custos com anúncios para a Adjust via Google Sheets.

    1. Em DataWorks, selecione Importações de dados.

    2. Selecione Nova importação de dados.

    3. Em Tipo de dados, selecione Custos com anúncios.

    4. Selecione um parceiro na lista.

      • Se você não conseguir ver o parceiro na lista, entre em contato com seu gerente de contas para adicionar esse parceiro.
    5. No campo Link do Google Sheets, cole o link correto do Google Sheets que você configurou.

    6. Agora, selecione Verificar tabela para validar seu arquivo do Google Sheets. Se seu arquivo tiver erros, eles serão exibidos aqui, e você precisará corrigi-los antes de continuar para o próximo passo.

    7. Em Frequência, escolha a frequência de execução automática do processo de importação de dados.

      • Selecione Diariamente e um horário em UTC. Quando você opta pela execução diária de uma importação, os dados são verificados diariamente no horário selecionado. O processo de importação somente é executado se 24 horas se passaram desde a última importação.
      • Selecione Semanalmente e um dia e horário em UTC. Quando você opta pela execução semanal de uma importação, os dados são verificados semanalmente no horário selecionado. O processo de importação somente é executado se uma semana se passou desde a última importação.
    8. Selecione Criar importação de dados.

    Pronto! A Adjust vai extrair os dados dos últimos 7 dias automaticamente. Se você quiser modificar essa janela de retrospectiva, entre em contato conosco em support@adjust.com.

    A Adjust exibe os dados de custos com anúncios no Datascape automaticamente. Não é preciso integrar o SDK da Adjust ao seu aplicativo ou criar um link da Adjust para seu parceiro no Campaign Lab.

    Visualizar e gerenciar sua configuração de importação de dados

    1. Acesse DataWorks > Importações de dados. Essa página exibe uma lista de todas as importações de dados que você configurou. Ela oferece uma visão geral de:

      • ID: o identificador da importação de dados. Sempre compartilhe o ID com seu Technical Account Manager se tiver dúvidas ou precisar discutir problemas.
      • Parceiro: o nome da rede de anúncios para a qual você está importando os dados de custos com anúncios.
      • Conta de anúncios: a conta de anúncios do parceiro.
      • Frequência: a frequência da execução automática do processo de importação de dados.
      • Tipo de dados: o tipo de dados. Nesse caso, os dados de custos com anúncios.
      • Tipo de fonte: a fonte dos dados de custos com anúncios. Exemplo: Google Sheets
      • Última importação: a última vez em que o processo de importação de dados foi executado com sucesso.
      • Importações com falha: o número de vezes em que houve falha na conclusão do processo de importação de dados.
        • None - Denota que nunca houve falhas no processo de importação de dados.
        • Failed - Denota o número de vezes em que houve falha no processo de importação de dados. Em Ações, selecione (ícone de mais) > Abrir para ver os motivos da falha em uma importação.
    2. Na página Importações de dados, em Ações, selecione (ícone de mais) > Abrir para ver uma importação de dados específica. Você pode realizar as seguintes tarefas para essa importação de dados:

      • Selecionar (ícone de exclusão) para excluir a configuração da importação de dados.
      • Selecionar Editar importação para editar a configuração da importação.
      • Na seção Configurações da importação, você pode:
        • Visualizar as configurações da importação e ativar ou desativar o processo automático de importação de dados.
        • Visualizar o log de importações com detalhes de todos os processos de importação executados até o momento. Essa seção exibe a hora em que o processo de importação foi executado e o período do qual os dados foram importados. Para todas as importações com sucesso, selecione Visualizar dados importados para visualizar os dados importados em relatórios no Datascape. Para todas as importações com falha, selecione Verificar detalhes do erro para visualizar e resolver erros no processo de importação de dados.
    3. Na página Importações de dados, em Ações, selecione (ícone de mais) e, em seguida:

      • Selecione Editar para editar a configuração de uma importação existente.
      • Selecione Excluir para excluir a configuração da importação de dados.

    Mapeamento de campanha

    Quando a Adjust recebe dados de custos com anúncios, tentamos conectá-los com os dados agregados de campanha que estão disponíveis. O matching dos dados de custos com anúncios com os dados de atribuição pode ser feito com diferentes métodos como o serviço automatizado de matching ou o mapeamento personalizado.

    Mapeamento automatizado

    Nosso matching de campanha automatizado usa os dados da API do Report Service. Isso inclui:

    • Dados de atribuição
    • Relatório de dados de custos com anúncios por APIs de rede

    O matching é feito usando, principalmente campaign ID e campaign name. Como o matching é realizado de maneira automática, não é necessário fazer nenhuma configuração.

    Mapeamento personalizado

    Nos casos em que não é possível fazer um matching automatizado, a Adjust pode configurar mapeamentos personalizados. Por exemplo, se a API de rede compartilha apenas o campaign_id que não pode ser combinado com o campaign_name da Adjust.

    Forneça uma das seguintes informações ao seu Technical Account Manager da Adjust:

    • Seu ID da campanha da rede ou o ID do grupo de anúncios.
    • O nome da campanha correspondente.
    • O nome do grupo de anúncios da Adjust.

    Seu Account Manager configurará, então, o mapeamento na Adjust para que você tenha todos os dados de custos com anúncios em um lugar, com uma visão geral das informações de custos com anúncios.

    Os mapeamentos personalizados são criados e gerenciados diretamente na Adjust com o uso de informações enviadas por você. Podemos combinar os dados de uma das seguintes maneiras, dependendo dos dados que você fornecer:

    Informações da AdjustInformações da rede
    nome de campanhaID da campanha
    nome do grupo de anúncios (Adgroup)ID do grupo de anúncios (Adgroup)
    Dica:
    Para ter resultados melhores, inclua seu ID da campanha no nome da campanha. Isso ajuda a Adjust a fazer a correspondência entre os custos com anúncios e os dados agregados automaticamente. Use a seguinte estrutura para os melhores resultados: {campaign_name}_{campaign_id}.