Arquivo de registro acionável actionable-log-files

O Actionable Log Files permite capturar dados de mídia de arquivos de log do servidor de anúncios e usar os dados para criar características no Audience Manager. Capture impressões, cliques e conversões de servidores de anúncios como características sem precisar acrescentar pixels.

NOTE
Estilos de texto (monospaced text, itálico, colchetes [ ] ( ) etc.) neste documento indique elementos e opções de código. Consulte Convenções de estilo para código e elementos de texto para obter mais informações.

Propósito purpose

O Actionable Log Files simplifica a maneira de capturar impressões, cliques e conversões de servidores de anúncios. Use essas informações para segmentação de usuário sem precisar aplicar pixels manualmente na mídia para enviar atributos de campanha para Audience Manager.

Introdução getting-started

Para começar a usar o Actionable Log Files, você precisa importar os dados de log para o Audience Manager. Os links a seguir ajudarão você a começar:

Se você já estiver importando dados de log para o Audience Manager, peça ao seu consultor do Audience Manager ou ao Atendimento ao cliente para habilitar o Actionable Log Files para você.

Trabalhar com arquivos de registro acionáveis working-with-actionable-log-files

Com o Actionable Log Files, as informações dos logs do servidor de publicidade são capturadas no Audience Manager da mesma forma que você capturaria os dados das interações do site em tempo real. O Audience Manager se conecta ao seu armazenamento de log do servidor de publicidade, analisa as informações dos logs e envia os dados do log como sinais acionáveis para nossos Servidores de Coleta de Dados.

Você ainda precisa configurar características baseadas em regras para capturar os sinais acionáveis. Veja como configurar características baseadas em regras na interface do usuário do Audience Manager ou usando as Ferramentas de Gerenciamento em Massa. Role para baixo até a seção Sinais acionáveis para obter uma lista de todas as chaves que você pode usar em características baseadas em regras.

IMPORTANT
Recomendamos implementar Actionable Log Files em vez de Pixel Calls. Desincentivamos o uso de ambas as opções, pois isso resulta em um aumento nas contagens de frequência para características.

Sinais acionáveis actionable-signals

Os sinais são as menores unidades de dados em Audience Manager. O Actionable Log Files permite capturar valores de anunciante, unidade de negócios, criativo e campanha em eventos de impressão, eventos de clique e eventos de conversão como sinais dos logs do servidor de anúncios.

IMPORTANT
Actionable Log Files têm suporte para os seguintes servidores de anúncios:

Lembre-se de que, para usar essas informações para a criação e segmentação de público-alvo, é necessário configurar as características com base em regras.

Sinais acionáveis de logs do Google Campaign Manager dcm-logs-signals

A tabela lista os sinais acionáveis de Google Campaign Manager arquivos de log:

Nome do cabeçalho no arquivo de log
Sinal
Descrição
Exemplo de valor
Activity ID
d_conversion

Disponível somente para eventos de conversão.

Representa a ID numérica da atividade de conversão no Google Campaign Manager. Este campo mapeia para a ID da atividade do gerente de campanha da Google.

Dica: você pode capturar várias atividades de conversão ou atividades específicas do Google Campaign Manager. Crie características usando d_conversion = activity ID para cada atividade de conversão do Google Campaign Manager.

24122
Conversion ID
d_conversionType

Disponível somente para eventos de conversão.

Este campo mapeia para a ID de conversão no Google Campaign Manager. Indica a atividade que precede a conversão do usuário do Google Campaign Manager.

Os valores aceitos são:

  • 1 para conversões pós-clique.
  • 2 para conversões pós-impressão.
  • 0 para conversões sem correspondência. A conversão não pode corresponder a uma atividade anterior.
0,1,2
Event Time
d_time
Uma data e hora UTC para o evento de impressão, clique ou conversão. Representado em microssegundos desde 1970-01-01 00:00:00 UTC.
1570826763000
Advertiser Group ID
d_adsrc

Um código de integração para a fonte de dados do anunciante. Observe que isso não está relacionado às fontes de dados Audience Manager.

Este campo mapeia para a ID de grupo do anunciante do gerente de campanha do Google.

134243
Advertiser ID
d_bu
ID da unidade de negócios. Este campo mapeia para a ID do anunciante do Gerenciador de campanhas do Google.
563332
Campaign ID
d_campaign
A ID da campanha fornecida pelo Gerente de campanha do Google.
7892520
Creative ID
d_creative
A Creative ID fornecida pelo Gerente de campanha do Google.
224221
Revenue
d_revenue
O valor das vendas em USD, à potência de -6. Multiplique por 1.000.000 para ver como uma quantia em dólar.
10
-
d_event

Indica o tipo de evento. O Audience Manager lê o tipo de evento do nome do arquivo de log do Google Campaign Manager e o transforma em um sinal acionável.

Os valores aceitos são:

  • d_event = imp para impressões.
  • d_event = click para cliques.
  • d_event = conv para conversões.
imp, click, conv
-
d_src
A ID da fonte de dados usada para capturar dados do Google Campaign Manager. Consulte Como Criar uma Source de Dados.
743

Os sinais descritos na tabela são capturados em Audience Manager como uma chamada HTTP em tempo real. A chamada de exemplo abaixo contém informações sobre um evento de conversão de Google Campaign Manager. As chamadas não precisam necessariamente incluir todos os sinais na chamada de exemplo.

https://yourcompany.demdex.net?d_src=743&d_uuid=07955261652886032950143702505894272138&d_time=1504536233&d_event=conv&d_conversion=24122&d_conversionType=2&d_bu=3983524&d_campaign=7321391&d_adsrc=11111&d_creative=123456

Para um arquivo de log de tamanho médio Google Campaign Manager de 2 milhões de linhas, todas as características criadas a partir de sinais acionáveis são percebidas dentro de aproximadamente uma hora após processarmos os logs.

NOTE
O carimbo de data/hora do evento fornecido nos logs Google Campaign Manager será respeitado e passado para Data Collection Servers.
  • Se um carimbo de data/hora não estiver disponível para uma linha de dados no arquivo de log Google Campaign Manager, usamos a hora da chamada HTTP como carimbo de data/hora do evento.
  • Se a linha de dados no arquivo de log Google Campaign Manager contiver um carimbo de data/hora malformado, ignoraremos a linha inteira.

Sinais Acionáveis de Google Ad Manager logs ad-manager-logs-signals

A tabela lista os sinais acionáveis de Google Ad Manager arquivos de log:

Nome do cabeçalho no arquivo de log
Sinal
Descrição
LineItemId
d_lineitem
A ID numérica do item de linha entregue do Gerenciador de publicidade
OrderId
d_orderid
A ID numérica da ordem do Gerenciador de anúncios que continha o item de linha entregue e o criativo.
CreativeId
d_creative
A ID numérica do criativo entregue do Ad Manager.
-
d_event

Indica o tipo de evento. O Audience Manager lê o tipo de evento do nome do arquivo de registro do Ad Manager e o transforma em um sinal acionável. Os valores aceitos são:

  • d_event = imp para impressões.
  • d_event = clique para cliques.
  • d_event = conv para conversões e atividades.
-
d_src
A ID da fonte de dados usada para capturar os dados do Ad Manager. Consulte Como Criar uma Source de Dados.

Os sinais descritos na tabela são capturados no Audience Manager como uma chamada HTTP em tempo real. O exemplo de chamada abaixo contém informações sobre um evento de conversão do Google Ad Manager. As chamadas não precisam necessariamente incluir todos os sinais na chamada de exemplo.

https://yourcompany.demdex.net?d_src=743&d_uuid=07955261652886032950143702505894272138&d_time=1504536233&d_event=conv&d_lineitem=112&d_orderid=22223&d_creative=3983524
NOTE
O carimbo de data/hora do evento fornecido nos logs Google Ad Manager será respeitado e passado para Data Collection Servers.
  • Se um carimbo de data/hora não estiver disponível para uma linha de dados no arquivo de log Google Ad Manager, usamos a hora da chamada HTTP como carimbo de data/hora do evento.
  • Se a linha de dados no arquivo de log Google Ad Manager contiver um carimbo de data/hora malformado, ignoraremos a linha inteira.

Sinais acionáveis de logs de servidor de anúncios do Adobe Advertising Cloud, Flashtalk e Sizmek generic-logs-signals

Primeiro, você deve depositar os logs do servidor de anúncios em nossos buckets do Amazon S3. Para fazer isso, leia os Arquivos de Dados para os Relatórios de Audience Optimization e os Arquivos de Log Acionáveis e e entre em contato com seu consultor do Audience Manager. A tabela lista os sinais acionáveis dos arquivos de log do servidor de anúncios:

Nome do cabeçalho no arquivo de log
Sinal
Descrição
Exemplo de valor
Event-Type
d_conversionType

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
0,1,-1
Time-Stamp
d_time
Uma data e hora UTC para o evento de impressão, clique ou conversão. Use o formato yyyy-MM-dd HH:mm:ss.
2019-03-26 11:23:10
Advertiser-ID
d_adsrc
Um código de integração para a fonte de dados do anunciante. Observe que este campo não está relacionado a fontes de dados Audience Manager.
134243
BU-ID
d_bu
ID da unidade de negócios.
563332
Campaign-ID
d_campaign
A ID da campanha do arquivo de log.
7892520
Creative-ID
d_creative
A Creative ID do arquivo de log.
224221
Revenue
d_revenue
Compra ou outro valor de conversão. Tipo de dados: Flutuante.
0.001
-
d_event

Indica o tipo de evento. O Audience Manager lê o tipo de evento do nome do arquivo de log e o transforma em um sinal acionável. Consulte convenções de nomenclatura de arquivos de log.

Os valores aceitos são:

  • d_event = imp para impressões.
  • d_event = click para cliques.
  • d_event = conv para conversões.
imp, click, conv
-
d_src
A ID da fonte de dados usada para capturar dados de log. Consulte Como Criar uma Source de Dados.
743

Os sinais descritos na tabela são capturados em Audience Manager como uma chamada HTTP em tempo real. As chamadas não precisam necessariamente incluir todos os sinais na chamada de exemplo.

https://yourcompany.demdex.net?d_src=743&d_uuid=07955261652886032950143702505894272138&d_time=1504536233&d_activity=1234&d_creative=24122&d_placemebt=3442&d_bu=3983524&d_campaign=7321391&d_adsrc=11111

Trabalhar com sinais acionáveis na interface do usuário do Audience Manager actionable-signals-in-ui

Você pode visualizar os sinais acionáveis recebidos na interface da Pesquisa de sinais.

Vá para Dados de Público (1) > Sinais (2) > Pesquisar (3) e selecione o filtro Arquivos de Log Acionáveis (4).

Sinais acionáveis na interface do usuário

Para criar características baseadas em regras usando seus sinais acionáveis, selecione Arquivos de Log Acionáveis (1), selecione os sinais acionáveis que você deseja usar como regras de características (2) e pressione Criar Característica dos Sinais Selecionados (3).

Criar características a partir de sinais

Casos de uso use-cases

Um benefício de implementar o Actionable Log Files é a opção de aplicar controles de recenticidade e frequência a qualquer característica com base em regras que contenha sinais acionáveis. Isso permite, por exemplo, limitar a frequência do número de vezes que um usuário recebe um anúncio específico em uma campanha de mídia. Leia Supressão instantânea entre dispositivos para saber como fazer isso. Outros casos de uso incluem:

Redirecionar usuários

Redirecione usuários que viram o creative 123, mas não clicaram ou converteram e mostrem o creative 456. Faça o seguinte:

  1. Crie uma característica para capturar os usuários que viram o criativo. Digamos que você nomeie a característica Creative Trait 123. Usar a regra de característica:

    d_creative == 123 AND d_event == imp

  2. Crie uma característica para capturar usuários que clicam ou convertem. Digamos que você nomeie este Click and Converter. Usar a regra de característica:

    d_event == click OR d_event=conv

  3. Crie um segmento para popular com usuários que viram o creative 123, mas não clicaram nem converteram. Nomeie-o Retarget Users e use a regra de segmento:

    Creative Trait 123 AND NOT Click and Converter

  4. Mapeie o segmento Retarget Users para um destino e direcione usuários no destino com o creative 456.

Use a atividade de Floodlight do Google Campaign Manager nos Relatórios de Audience Optimization ou no Audience Lab

As marcas Floodlight permitem que anunciantes rastreiem conversões de usuário. Com o Actionable Log Files, você pode acompanhar as Google Campaign Manager conversões nos Relatórios de Audience Optimization ou no Audience Lab:

  1. Crie uma característica e use a seguinte regra de característica para capturar uma conversão dos logs do servidor de publicidade:

    d_event == conv AND d_conversion == 123

    Ao criar a característica no Audience Manager UI, selecione Conversion como Event Type.

  2. Depois de criar a característica, a conversão começará a ser relatada no Audience Optimization Reports e em Audience Lab.

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