Show Menu
TÓPICOS×

Arquivos de dados para relatórios de otimização de público-alvo e arquivos de registro acionáveis

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 otimização de público-alvo e criar características usando os dados por meio dos Arquivos de registro acionáveis. Formate seus arquivos de dados de acordo com essas especificações nesta seção.

Visão geral

Um arquivo de dados com nome e formato adequados permite importar dados de impressão, clique ou conversão para os Relatórios de otimização de público-alvo. Isso é útil ao trabalhar com um parceiro que não está integrado Audience Manager e você deseja trabalhar com seus dados nesse conjunto de relatórios. Esse processo requer arquivos separados para impressão, clique e dados de conversão. Não misture esses eventos em um único arquivo.
Um ficheiro de dados deve ser acompanhado de um ficheiro de metadados. O conteúdo do arquivo de metadados corresponde às informações do arquivo de dados a rótulos relacionados e legíveis por humanos nos menus do relatório. Para obter mais informações, consulte Visão geral e mapeamentos para arquivos de metadados.

Como nomear convenções para arquivos de dados

A sintaxe a seguir define a estrutura de um nome de arquivo de dados bem formado. Observação: itálico indica um espaço reservado variável que muda dependendo do conteúdo do arquivo.
Sintaxe:
tipode 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/mês.
  • Antes de carregar, compacte seus arquivos usando gzip e salve-os com a extensão do .gz arquivo.
Dadas estas exigências, nomeie seus arquivos de dados com base em seus conteúdos como este:
  • Dados de impressão:
    impressionsions_
    
    yyyymmdd.gz
    
    
  • Dados de clique:
    click_
    
    yyyymmdd.gz
    
    
  • Dados de conversão:
    conversions_
    
    yyyymmdd.gz
    
    

Formato de conteúdo para arquivos de dados

A sintaxe a seguir define a estrutura do conteúdo em um arquivo de dados bem formado. Observação: itálico indica um espaço reservado 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 cliques usam os mesmos rótulos. Os arquivos de conversão contêm cabeçalhos adicionais.
  • Se você não tiver dados para uma coluna específica, preencha esse campo com uma -1 .
  • Os arquivos devem terminar com um número de versão. A versão atual é 1.1.
  • Separe os cabeçalhos e conteúdos dos arquivos com o caractere ASCII 001 não imprimível. Se você não puder usar ASCII 001, separe os cabeçalhos e dados com um delimitador de tabulação. Como esses são caracteres não imprimíveis, o exemplo de sintaxe acima mostra um pipe somente "|" para fins de exibição.
Rótulos de campo
A tabela abaixo lista e descreve os cabeçalhos de coluna para seu arquivo de dados. Os cabeçalhos fazem distinção entre maiúsculas e minúsculas e devem aparecer conforme ordenado na tabela. Todos os tipos de dados são inteiros (INT), a menos que seja indicado o 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 yyyy-MM-dd HH:mm:ss formato.
ID do usuário
Sua ID para um visitante do site, também conhecida como 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 comercial.
ID da campanha
ID da campanha.
Creative-ID
ID de criação.
ID do site
ID do site.
ID de posicionamento
ID de disposição numérica do servidor de publicidade.
Insertion-Order-ID
ID do pedido de inserção.
Tactic-ID
ID Tática.
ID vertical
ID para uma categoria ou vertical do setor.
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: Flutuar.
Somente para arquivos de dados de conversão.
Outros dados
URL da página inicial 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 é correspondida ou não. As opções incluem:
  • 0 : Impressão
  • 1 : Clique em
  • -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 uma impressão, clique ou arquivo de dados de conversão. A versão atual é 1.1.

Métodos de entrega para arquivos de dados

Faça upload de sua impressão, clique ou converta arquivos de dados em um diretório Amazon S3 para sua Audience Manager conta. Consulte esta seção para obter informações sobre caminhos de entrega/diretório, tempos de processamento de arquivos e atualizações.
Sintaxe do 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. Note, italics indicates a variable placeholder. Outros elementos são constantes ou teclas e não são alterados.
Sintaxe:
 .../log_ingestion/pid= ID 

/dpid do

AAM= 

d_src/logs/ tipo 

dearquivo_

yyyymmdd

A tabela a seguir define cada um desses elementos em um caminho de entrega de arquivo.
Parâmetro de 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
Esse par de valores chave que contém a ID do cliente do Audience Manager .
dpid= d_src
Esse par de valor-chave contém a ID da fonte de dados transmitida em uma chamada de evento. Ela identifica a agência de onde vêm os dados 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 entrega.
Exemplo de caminho de upload e nome de arquivo
Ao carregar um arquivo, o caminho será semelhante a este:
.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902
Tempos e atualizações de processamento de 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. Neste caso, um dia é o período de 24 horas de uma meia-noite para o próximo. Como prática recomendada, você pode usar o horário UTC para definir o intervalo de dias.

Próximas etapas

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