Amostras de código e descrições para casos de uso de DIL específicos.
Crie uma variável de objeto que envia informações sobre elementos de página para o Audience Manager. Isso é útil para a coleta de dados geral 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 manter os elementos de dados em uma lista simples ou em uma matriz. Lembre-se de transmitir variáveis como pares de valores chave. Além disso, observe o prefixo c_
antes da chave no par de valores chave. Esse prefixo necessário identifica informações como dados definidos pelo usuário. No primeiro exemplo, é necessário anexar c_
manualmente à 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á prioridade 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
Esse exemplo básico envia dados de cor e preço para o Audience Manager na forma de pares de valores-chave. O 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 passar um objeto como parâmetro de função para o método signals(). DIL O 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. O 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();
Capture e envie um URL de referência para o Audience Manager.
Esse método funciona somente quando os usuários se movem entre páginas com protocolos semelhantes (HTTP vs HTTPS). Por exemplo, o navegador retém um URL de referência quando você navega de um site seguro para outro site seguro. Os navegadores não retêm o URL de referência quando você se move entre sites seguros e inseguros. Esse comportamento é a funcionalidade normal do navegador e não pode ser contornado por DIL.
Amostra de código
O código pode ser semelhante ao seguinte:
var adobe_dil = DIL.create({ partner : "partner name" });
adobe_dil.api.signals({ d_referer : document.referrer }).submit();
Envie informações sobre o tipo de mecanismo de pesquisa e pesquisas de palavras-chave para o Audience Manager.
Esta seção descreve a funcionalidade herdada, que não é compatível com as versões mais recentes do DIL.
Mecanismos de pesquisa suportados
Por padrão, DIL.getSearchReferrer
reconhece pesquisas desses mecanismos de pesquisa (incluindo variações internacionais):
Descrição
O código a seguir demonstra como obter o referenciador de pesquisa para qualquer um dos mecanismos de pesquisa compatíveis. Nesse caso, suponhamos que um usuário tenha pesquisado o termo "home" de Google Canadá ( www.google.ca
). Este 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 o referenciador de pesquisa (de google.com
, por exemplo) tem a seguinte aparência:
var search_referrer = DIL.tools.getSearchReferrer();
Amostra de código do mecanismo de pesquisa listada
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 necessário que os identifica como variáveis definidas pelo cliente para o 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, suponhamos que um usuário tenha pesquisado 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 o Audience Manager. O 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();
}
Associe o valor de um par de valores chave a outra chave.
Descrição
Em um par de valores chave, o prefixo c_
anexado à chave identifica o sinal como dados definidos pelo cliente. Os dados definidos pelo cliente são usados para o direcionamento no site específico que passou os dados em uma chamada de evento. No entanto, às vezes você deseja que essas informações estejam disponíveis em todas as propriedades da sua conta do Audience Manager. Para fazer isso, mapeie o valor em um par de valores chave c_
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.
Como exemplo, você coleta dados de CEP de um site específico, mas deseja direcioná-los para todas as propriedades do Audience Manager. Para disponibilizar o CEP no nível da plataforma, você pode mapear a chave de código postal definida pelo cliente (por exemplo, c_zip
) para uma chave definida pela plataforma, conforme mostrado abaixo.
Amostra de código
O 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
Configure e forneça o DIL com uma tag GTM.
Esse procedimento pressupõe que você tenha uma conta Google Tag Manager, algum conhecimento sobre o funcionamento desse produto e seu arquivo Audience Manager dil.js
.
Para enviar o tráfego do arquivo dil.js
no GTM:
Crie um novo contêiner ou abra um contêiner existente.
Adicione uma nova tag ao container.
Abra a tag para editá-la e:
<script>DIL code</script>
.Publique o contêiner.
Gere o código da tag do container e coloque-o no inventário.