Um arquivo de dados contém dados de impressão, clique ou conversão. Quando formatados corretamente, é possível importar esses dados para o Audience Manager para exibi-los na Relatórios do Audience Optimization e criar características usando os dados via Arquivos de registro acionáveis. Formate os arquivos de dados de acordo com essas especificações nesta seção.
Um arquivo de dados corretamente nomeado e formatado permite importar dados de impressão, clique ou conversão para a Relatórios do 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 aos rótulos relacionados e legível nos menus de relatório. Para obter mais informações, consulte Visão geral e mapeamentos para arquivos de metadados.
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 de variável que muda de acordo com o conteúdo do arquivo.
Sintaxe:
tipo de evento_aaaammdd
Em um nome de arquivo:
.gz
extensão de arquivo.Considerando esses requisitos, nomeie os arquivos de dados com base em seus conteúdos da seguinte forma:
impressões_aaaammdd.gz
cliques_aaaammdd.gz
conversões_aaaammdd.gz
A sintaxe a seguir define a estrutura do conteúdo no arquivo de dados bem formado. Observação: 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 de cabeçalho 1 | etiqueta do cabeçalho 2 … rótulo do cabeçalho n | version
No conteúdo do arquivo:
Os rótulos do cabeçalho devem aparecer na ordem mostrada na tabela abaixo. Impressões e 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 uma -1
.
Arquivos must 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 são caracteres não imprimíveis, o exemplo de sintaxe acima mostra uma barra vertical "|"
somente para fins de exibição.
Rótulos de campo
A tabela abaixo lista e descreve os cabeçalhos da coluna para seu arquivo de dados. Os cabeçalhos fazem distinção entre maiúsculas e minúsculas e devem aparecer conforme a ordem 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 |
User-ID |
Sua ID de um visitante do site, também conhecida como ID de usuário exclusiva do provedor de dados ou DPUUID. |
Anunciante-ID |
A ID da fonte de dados ou o código de integração do anunciante. |
BU-ID |
ID da unidade de negócios. |
ID da campanha |
ID da campanha. |
Creative-ID |
ID de criação. |
ID do site |
ID do site. |
ID de posicionamento |
ID de posicionamento numérico do servidor de anúncios. |
Insertion-Order-ID |
Inserção da ID do pedido. |
Tactic-ID |
ID Tática. |
ID Vertical |
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: Flutuar. 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:
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. |
Carregue seus arquivos de dados de impressão, clique ou conversão para 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.
Entre em contato com seu consultor do Audience Manager ou com o Atendimento ao cliente para começar e configurar um Amazon S3 para seus arquivos de dados.
Sintaxe e exemplos do caminho de entrega
Os dados são armazenados em um namespace separado para cada cliente em um Amazon S3 diretório. O caminho do arquivo segue a sintaxe mostrada abaixo. Observação: 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 de arquivo | Descrição |
---|---|
|
Este é o início do caminho de armazenamento do diretório. Você receberá o caminho completo quando tudo estiver configurado. |
|
Esse par de valor-chave contém seu Audience Manager ID do cliente. |
|
Esse par de valores chave contém a ID da fonte de dados transmitida em uma chamada de evento. Ela identifica a agência de origem dos dados e vincula esses dados a um arquivo de metadados de suporte. |
|
Um diretório de nível superior para arquivos de dados. |
|
Um nome de tipo de arquivo que indica o tipo de dados que ele contém e um carimbo de data e hora do delivery. |
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 do processamento de arquivos
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, você pode usar o horário UTC para definir o intervalo de dias.
Revise os requisitos para nomear e criar arquivos de metadados. Para começar, consulte Visão geral e mapeamentos para arquivos de metadados.