Casos de uso da DIL e exemplos de código

Amostras de código e descrições para casos de uso de DIL específicos.

Enviar elementos de dados para o Audience Manager com DIL

Crie uma variável de objeto que envia informações sobre elementos de página para o Audience Manager. Isso é útil para a coleta geral de dados ou como uma alternativa para a coleta de dados com as variáveis do Analytics.

Descrição

O código a seguir demonstra como coletar dados de página e enviá-los para o Audience Manager com DIL. Esses exemplos usam uma variável para conter elementos de dados em uma lista simples ou em uma matriz. Lembre-se, passe variáveis como pares de valores chave. Além disso, observe o prefixo c_ antes da chave no par de valor chave. Esse prefixo necessário identifica informações como dados definidos pelo usuário. No primeiro exemplo, você precisa anexar manualmente c_ à chave. No segundo exemplo, DIL faz isso automaticamente para você.

Manter propriedades de valor consistentes

Lembre-se de manter as propriedades de valor iguais ao transmitir dados. Por exemplo, se você tiver duas chaves idênticas com valores diferentes, o valor do último par de valor chave terá precedência sobre os objetos de valor anteriores. Por exemplo, transmitir color:blue e color:red define o valor retornado como vermelho (substitui azul).

Exemplo 1: Enviar dados como pares de valores chave

Este exemplo básico envia dados de cor e preço para o Audience Manager na forma de pares de valor chave. Seu código pode ser semelhante ao seguinte:

var sample_dil = DIL.create({partner:"partner name"}); 
sample_dil.api.signals({ 
   c_color:"blue", 
   c_price:"900" 
}); 
sample_dil.api.submit();

Exemplo 2: Enviar dados em um objeto

Este exemplo avançado demonstra como enviar dados em um objeto para o Audience Manager. Ao trabalhar com esse método, DIL permite que você passe um objeto como parâmetro de função para o método signals(). DIL Seu código pode ser semelhante ao seguinte:

var my_object = { 
   color : "blue", 
   price : "900" 
}; 
 
var sample_dil = DIL.create({ partner : "partner name" }); 
//Load the object and append "c_" to all keys in the key-value pairs and send data to AudienceManager. 
sample_dil.api.signals(my_object,"c_").submit();

Exemplo 3: Enviar dados da página em um storage

Nesse caso, a variável my_object usa uma matriz para armazenar dados. Este exemplo baseia-se nas informações passadas pelo método recomendado acima, mas adiciona uma camada adicional para acomodar um tipo de produto e modelo. Seu código pode ser semelhante ao seguinte:

var my_objects = [{ 
   color : "blue", 
   price : "900" 
}, { 
   type : "acura", 
   model : "tl" 
}]; 
 
var sample_dil = DIL.create({ partner : "partner name" }); 
 
for (var i = 0; i < my_objects.length; i++) 
//Load the object and append "c_" to all the keys in the key-value pairs.  
{ 
    sample_dil.api.signals(my_objects[i], "c_"); 
} 
sample_dil.api.submit();

Capturar URL de referência

Capture e envie um URL de referência para o Audience Manager.

Amostra de código

Seu código pode ser semelhante ao seguinte:

var adobe_dil = DIL.create({ partner : "partner name" }); 
adobe_dil.api.signals({ d_referer : document.referrer }).submit();

Capturar Tipos de Mecanismo de Pesquisa e Termos de Pesquisa de Palavra-chave

Envie informações sobre pesquisas de tipos de mecanismos de pesquisa e palavras-chave para o Audience Manager.

Mecanismos de pesquisa suportados

Por padrão, DIL.getSearchReferrer reconhece pesquisas desses mecanismos de pesquisa (incluindo variações internacionais):

• AOL
• Ask
• Bing
• Google
• Yahoo!

Descrição

O código a seguir demonstra como obter a quem indicou de pesquisa para qualquer um dos mecanismos de pesquisa suportados. Nesse caso, vamos supor que um usuário pesquisou o termo "home" de Google Canadá ( www.google.ca). Esse código ajudará você a capturar esses termos de pesquisa e enviá-los para o Audience Manager.

Código básico

O código básico para obter a quem indicou de pesquisa (de google.com, por exemplo) tem a seguinte aparência:

var search_referrer = DIL.tools.getSearchReferrer();

Exemplo de código do mecanismo de pesquisa listado

Nesse caso, suponhamos que um usuário tenha pesquisado o termo "home" de Google Canadá ( www.google.ca). Observe como o código prefixa o parâmetro c_ necessário para o mecanismo de pesquisa ( c_se) e o termo de pesquisa ( c_st). c_ é um prefixo obrigatório que identifica como variáveis definidas pelo cliente para Audience Manager.

var adobe_dil = DIL.create({partner:"partner name"}); 
var search_referrer = DIL.tools.getSearchReferrer(); 
 
if (search_referrer && search_referrer.valid) { 
  adobe_dil.api.signals({ 
    c_se : se.name, 
    c_st : se.keywords 
  }).submit(); 
}

Amostra de código do mecanismo de pesquisa não listada

Nesse caso, vamos supor que um usuário buscou o termo "home" de dogpile.com. Como Dogpile não é suportado por padrão, você pode configurar o DIL para reconhecer esse mecanismo de pesquisa e retornar os termos de pesquisa para Audience Manager. Seu código pode ser semelhante ao seguinte:

var adobe_dil = DIL.create({partner:"partner name"}); 
var search_referrer = DIL.tools.getSearchReferrer(document.referrer, {  
    hostPattern:/dogpile\./, 
    queryParam:"q" 
}); 
 
if (search_referrer && search_referrer.valid) { 
  adobe_dil.api.signals({ 
    c_se : se.name, 
    c_st : se.keywords 
  }).submit(); 
}

Mapear valores de chave para outras chaves

Associe o valor de um par de valores chave a outra chave.

Descrição

Em um par de valor chave, o prefixo c_ anexado à chave identifica o sinal como dados definidos pelo cliente. Os dados definidos pelo cliente são usados para direcionamento no site específico que passou os dados em uma chamada de evento. No entanto, às vezes você deseja que essas informações fiquem disponíveis em todas as propriedades da sua conta do Audience Manager. Para fazer isso, mapeie o valor em um par c_ de valor chave para uma chave de nível de plataforma. Uma chave de nível de plataforma tem o prefixo d_ e disponibiliza o sinal para definição de metas em todas as propriedades da sua conta.

Por exemplo, você coleta dados de código ZIP de um site específico, mas deseja público alvo-los para todas as propriedades do Audience Manager. Para disponibilizar o código ZIP no nível da plataforma, é possível mapear a chave de código ZIP definida pelo cliente (por exemplo, c_zip) para uma chave definida pela plataforma, conforme mostrado abaixo.

Amostra de código

Seu código pode ser semelhante ao seguinte:

var adobe_dil = DIL.create({ 
    partner : "adobe", 
    mappings : { 
        c_zip : 'd_zip', 
        d_key2 : 'h_dil_key2' 
    } 
}); 
adobe_dil.api.signals({c_zip : '10010'}).submit(); 
// Request will look like /event?c_zip=10010&d_zip=10010

DIL de tráfego no Google Tag Manager (GTM)

Configure e sirva DIL com uma tag GTM.

Este procedimento supõe que você tenha uma conta Google Tag Manager, algum conhecimento funcional do produto e seu arquivo Audience Manager dil.js.

Para fazer o tráfego do arquivo dil.js no GTM:

1. Crie um novo container ou abra um container existente.

2. Adicione uma nova tag ao container.

3. Abra a tag para editá-la e:

   • Nomeie a tag .
   • Selecione Custom HTML Tag na lista suspensa Tag Type.
   • No campo HTML, coloque o código DIL (biblioteca + o código personalizado) nas tags de script <script>DIL code</script>.
   • Clique em Save.

4. Publique o container.

5. Gere o código da tag do container e coloque-o no inventário.