Arquivos de dados para relatórios Audience Optimization e arquivos de registro acionáveis data-files-for-audience-optimization-reports

Um arquivo de dados contém dados de impressão, clique ou conversão. Quando formatados corretamente, você pode importar esses dados para o Audience Manager para exibi-los nos Relatórios de Audience Optimization e criar características usando os dados por meio dos Arquivos de Log Acionáveis. Formate seus arquivos de dados de acordo com essas especificações nesta seção.

Visão geral overview

Um arquivo de dados formatado e com nomes adequados permite importar dados de impressão, clique ou conversão para os Relatórios de Audience Optimization. Isso é útil ao trabalhar com um parceiro que não está integrado ao Audience Manager e você deseja trabalhar com seus dados nesse conjunto de relatórios. Esse processo requer arquivos separados para dados de impressão, clique e conversão. Não misture esses eventos em um único arquivo.

Um arquivo de dados deve ser acompanhado por um arquivo de metadados. O conteúdo do arquivo de metadados corresponde às informações do arquivo de dados a rótulos relacionados e legíveis nos menus do relatório. Para obter mais informações, consulte Visão geral e mapeamentos para arquivos de metadados.

Convenções de nomenclatura para arquivos de dados naming-conventions

A sintaxe a seguir define a estrutura de um nome de arquivo de dados bem formado. Observe que itálico indica um espaço reservado para variável que muda dependendo do conteúdo do arquivo.

Sintaxe:

tipo de evento_aaaammdd

Em um nome de arquivo:

  • O tipo de evento indica que o arquivo contém impressões, cliques ou conversões. Crie um arquivo separado para cada tipo de evento.
  • Um sublinhado separa o tipo de evento e um carimbo de data e hora de ano e mês.
  • Antes de carregar, compacte os arquivos usando o gzip e salve-os com a extensão de arquivo .gz.

Dados esses requisitos, nomeie seus arquivos de dados com base em seu conteúdo da seguinte maneira:

  • Dados de impressão:

    code language-none
    impressões_aaaammdd.gz
    
  • Dados de cliques:

    code language-none
    cliques_aaaammdd.gz
    
  • Dados de conversão:

    code language-none
    conversões_aaaammdd.gz
    

Formato de conteúdo para arquivos de dados content-format

A sintaxe a seguir define a estrutura de conteúdo no arquivo de dados bem formado. Observe que itálico indica um espaço reservado para variável e é substituído por um rótulo em um arquivo de dados real.

Sintaxe:

rótulo do cabeçalho 1 | rótulo do cabeçalho 2 … rótulo do cabeçalho n | versão

No conteúdo do arquivo:

  • Os rótulos do cabeçalho devem aparecer na ordem, conforme mostrado na tabela abaixo. As impressões e os cliques usam os mesmos rótulos. Os arquivos de conversão contêm cabeçalhos extras.

  • Se você não tiver dados para uma coluna específica, preencha esse campo com um -1.

  • Os arquivos devem terminar com um número de versão. A versão atual é a 1.1.

  • Separe os cabeçalhos e conteúdos do arquivo com o caractere ASCII 001 não imprimível. Se não for possível usar ASCII 001, separe os cabeçalhos e dados com um delimitador de tabulação. Como esses caracteres não são imprimíveis, o exemplo de sintaxe acima mostra uma barra vertical "|" somente para fins de exibição.

Rótulos de campos

A tabela abaixo lista e descreve os cabeçalhos de coluna para seu arquivo de dados. Os cabeçalhos diferenciam maiúsculas de minúsculas e devem aparecer conforme ordenados na tabela. Todos os tipos de dados são inteiros (INT), salvo indicação em contrário.

Rótulo
Descrição
Carimbo de data e hora
Uma data e hora UTC para o evento de impressão, clique ou conversão. Use o formato yyyy-MM-dd HH:mm:ss.
ID de usuário
Sua ID para um visitante do site, também conhecida como a ID de usuário exclusiva ou DPUUID do provedor de dados .
ID do anunciante
A ID da fonte de dados ou o código de integração do anunciante.
BU-ID
ID da unidade de negócios.
Campaign-ID
ID da campanha.
Creative-ID
ID de criação.
Site-ID
ID do site.
ID de posicionamento
ID de posicionamento numérico do servidor de publicidade.
Insertion-Order-ID
ID da ordem de inserção.
Tactic-ID
ID tática.
Vertical-ID
ID para um negócio vertical ou categoria.
Quantidade

O número de itens vendidos em um evento de conversão.

Somente para arquivos de dados de conversão.

Receita

Compra ou outro valor de conversão. Tipo de dados: Flutuante.

Somente para arquivos de dados de conversão.

Outros-Dados

URL da página de aterrissagem de conversão. Tipo de dados: String.

Somente para arquivos de dados de conversão.

Tipo de evento

Tipo de conversão. Indica se uma conversão corresponde ou não. As opções incluem:

  • 0: Impressão
  • 1: Clique
  • -1: Não atribuído ou desconhecido

Somente para arquivos de dados de conversão.

Versão
Um número de versão necessário que aparece no final de cada linha em um arquivo de dados de impressão, clique ou conversão. A versão atual é a 1.1.

Métodos de delivery para arquivos de dados delivery-methods

Carregue arquivos de dados de impressão, clique ou conversão para um diretório Amazon S3 da sua conta Audience Manager. Consulte esta seção para obter informações sobre caminhos de entrega/diretório, tempos de processamento de arquivos e atualizações.

IMPORTANT
Entre em contato com seu consultor do Audience Manager ou com o Atendimento ao cliente para começar e configurar um diretório Amazon S3 para seus arquivos de dados.

Sintaxe de Caminho de Entrega e Exemplos

Os dados são armazenados em um namespace separado para cada cliente em um diretório Amazon S3. O caminho do arquivo segue a sintaxe mostrada abaixo. Observe que itálico indica um espaço reservado para variável. Outros elementos são constantes ou chaves e não são alterados.

Sintaxe:

…/log_ingestion/pid= ID de AAM/dpid= d_src/logs/ tipo de arquivo_aaaammdd

A tabela a seguir define cada um desses elementos em um caminho de entrega de arquivo.

Parâmetro do arquivo
Descrição
.../log_ingestion/
Este é o início do caminho de armazenamento do diretório. Você receberá o caminho completo quando tudo estiver configurado.
pid=AAM ID
Este par de valor-chave contém sua ID de cliente do Audience Manager do .
dpid=d_src
Esse par de valor-chave contém a ID da fonte de dados transmitida em uma chamada de evento. Ele identifica a agência de onde os dados vêm e vincula esses dados a um arquivo de metadados de suporte.
logs
Um diretório de nível superior para arquivos de dados.
file type_yyyymmdd
Um nome de tipo de arquivo que indica que tipo de dados ele contém e um carimbo de data e hora de delivery.

Caminho de Carregamento de Exemplo e Nome de Arquivo

Ao fazer upload de um arquivo, o caminho será semelhante a este:

.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902

Tempos de Processamento e Atualizações do Arquivo

Os arquivos de dados são processados quatro vezes por dia, em intervalos regulares.

Para atualizar seus dados, envie um arquivo que contenha todas as impressões, cliques ou conversões de um dia específico. Nesse caso, um dia é o período de 24 horas de uma meia-noite para a próxima. Como prática recomendada, talvez você queira usar a hora UTC para definir o intervalo do dia.

Próximas etapas next-steps

Revise os requisitos para nomear e criar arquivos de metadados. Para começar, consulte Visão geral e mapeamentos para arquivos de metadados.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695