Módulos da DIL

Descreve métodos na namespace DIL.modules. Esses módulos permitem que você colete dados de forma programática e trabalhe com objetos Audience Manager.

siteCatalyst.init

Funciona com DIL para enviar Analytics elementos de tags (variáveis, props, eVars etc.) para Audience Manager. Retorna dados em uma lista separada por vírgulas. Disponível na versão 2.6.

Assinatura da função: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)

Parâmetros

Nomes	Tipo	Descrição
names	String	Uma matriz de strings que contém variáveis do Analytics não enumeradas, como pageName , channel , campaign , product etc.
iteratedNames	Objeto	Uma matriz de objetos que contém variáveis do Analytics enumeradas, como props e evars (por exemplo, prop1 , prop2 , evar3 , evar4 ).
maxIndex	Número inteiro	Indica quantos nomes repetidos você deseja retornar. Por exemplo, para retornar duas props ou evars, defina maxIndex:2 .
siteCatalystReportingSuite	Objeto	Um objeto que representa o objeto do Analytics .
dilInstance	Objeto	Um objeto que representa DIL .
options	Objeto	Opções adicionais: replaceContextDataPeriodsWith Se você não especificar outra coisa, os pontos serão substituídos pelo sublinhado padrão ( _ ). Por exemplo, s.contextData = {abc.def = '123'} resultaria em c_contextData_abc_def=123 na sequência de query da chamada do evento. Essa opção está disponível somente na versão 5.0 ou posterior do DIL ou <a0/>. filterFromContextVariables Por exemplo, filterFromContextVariables: ['email', 'zip', 'accountNumber'] resultaria na filtragem da matriz de sequências de caracteres da coleta de dados de contexto. Essa opção exclui as Informações pessoais identificáveis (PII).

Dados capturados pelo siteCatalyst.init

Esta função retorna detalhes sobre as seguintes propriedades Analytics:

• pageName
• channel
• campaign
• products
• events
• eVar (1 - 250)
• prop (1 - 75)
• pe
• pev1
• pev2
• pev3

Código de exemplo

Esse código cria uma lista separada por vírgulas de Analytics eventos (props, eVars etc.) se houver valores para eles.

// Get the Site Catalyst object instance: 
var s = s_gi(s_account); 
  
// Instantiate DIL code: 
var scDil = DIL.create({ 
        partner: 'adobe', 
        containerNSID: 5 
}); 
 
// Use the module: 
DIL.modules.siteCatalyst.init(s, scDil, { 
        //Specify the Site Catalyst variables you want to capture: 
        names: ['pageName', 'channel', 'campaign'], 
        //Use this to create iterated variable names: 
        iteratedNames: [{ 
               name: 'eVar', 
               maxIndex: 75 
        }, { 
               name: 'prop', 
               maxIndex: 75 
        }] 
});

Para rastrear todos os pontos de dados Analytics monitorados sem a função adicional mostrada acima, chame siteCatalyst.init por si mesmo assim:

DIL.modules.siteCatalyst.init(s, scDil);

GA.submitUniversalAnalytics

A função GA.submitUniversalAnalytics(); envia dados de Universal Analytics do Google para o Audience Manager. Esta função DIL foi projetada para funcionar com analytics.js, que é a biblioteca de códigos mais recente do Google Universal Analytics.

Assinatura da função: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);

Propriedades

A função GA.submitUniversalAnalytics(); aceita as seguintes propriedades.

Propriedade	Descrição
gaObject	A variável global para sua instância de Google Analytics . Normalmente, isso é ga por padrão, a menos que você tenha personalizado seu código Google Analytics .
dilInstance	A variável que representa a sua instância de DIL .
internalPropertyName	(Opcional) Na analytics.js biblioteca, a propriedade interna é a variável minified 'b' . Essa variável contém dados Google Analytics . Essa propriedade é opcional, pois não é necessário defini-la a menos que o Google altere o nome de sua variável interna. Por exemplo, se essa variável minified mudou para 'a' , você chamaria GA.submitUniversalAnalytics(); desta forma: DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');

Exemplo

Lembre-se de definir o objeto Google Analytics ga primeiro, antes de chamar DIL e GA.submitUniversalAnalytics();. Seu código pode ser semelhante a este:

//Instantiate DIL 
var dilInstance = DIL.create({ 
     partner:"adobe" 
}); 
 
//Call the DIL Universal Analytics function 
DIL.modules.GA.submitUniversalAnalytics(ga, dilInstance);

GA.init

A função GA.init() envia dados da versão herdada/obsoleta de Google Analytics para o Audience Manager.

Assinatura da função: DIL.modules.GA.init(_gaq, dilInstance, trackVars);

Parâmetros

Nome	Tipo	Descrição
_gaq	Matriz	Um storage que contém comandos GA.
dilInstance	Objeto	Um objeto que contém a instância DIL.
trackVars	Objeto	(Opcional) Um objeto que consiste na names propriedade. Essa propriedade é uma matriz de nomes de comando GA que você deseja rastrear.

Chamadas de função GA suportadas

Por padrão, GA.init captura dados das seguintes funções:

• _setCustomVar
• _addItem
• _addTrans
• _setAccount
• _trackSocial

DIL cria chaves para dados GA

O Audience Manager aceita dados na forma de pares de valores chave enquanto o GA trabalha com itens em um storage. Para trabalhar com dados GA, DIL cria automaticamente um par de valores chave e forma uma chave como esta: c_ <key name>. Além disso, os itens em arrays GA são exibidos em uma ordem específica. Como resultado, você deve fornecer todos os parâmetros nessa ordem, mesmo quando eles não contêm dados. DIL mapeia chaves para os seguintes métodos GA:

// Tracking Social Interactions 
_gaq.push(['_trackSocial', 
    'facebook',                        // c_socialNetwork 
    'like',                            // c_socialAction 
    'https://www.adobe.com/cool.php',   // c_socialTarget 
    '/cool.php'                        // c_socialPagePath 
]);  
 
// Tracking a Transaction 
_gaq.push(['_addTrans', 
   '1234',           // c_transOrderId 
   'Womens Apparel', // c_transAfflication 
   '28.28',          // c_transTotal 
   '1.29',           // c_tranTax 
   '15.00',          // c_transShipping 
   'San Jose',       // c_transCity 
   'California',     // c_transState 
   'USA'             // c_transCountry 
]); 
 
// Tracking an item 
_gaq.push(['_addItem', 
   '1234',           // c_itemOrderId=1234 
   'DD44',           // c_itemSku 
   'T-Shirt',        // c_itemName 
   'Olive Medium',   // c_itemCategory 
   '11.99',          // c_itemPrice 
   '1'               // c_itenQuantity 
]);

Código de exemplo

// DIL JavaScript library needs to be loaded and executed here 
var dilInstance = DIL.create({ 
    partner : "adobe" 
}); 
 
// Assume ga.js has not loaded 
var _gaq = _gaq || []; 
_gaq.push( 
  ['_setAccount', 'UA-XXXXX-X'], 
  ['_setDomainName', 'example.com'], 
  ['_setCustomVar', 1, 'Section', 'Life & Style', 3], 
  ['_trackPageview'] 
); 
_gaq.push([ 
  '_addItem', 
  '1234',         // order ID - necessary to associate item with transaction 
  'DD44',         // SKU/code - required 
  'T-Shirt',      // product name - necessary to associate revenue with product 
  'Olive Medium', // category or variation 
  '11.99',        // unit price - required 
  '1'             // quantity - required 
]); 

Para rastrear todas as métricas GA monitoradas sem a função adicional mostrada acima, chame GA.init por si mesmo assim:

DIL.modules.GA.init(_gaq, dilInstance).submit();

Chamada de Evento de exemplo

A chamada de evento de URL para Audience Manager pode ser semelhante a:

https://adobe.demdex.com/event?...c_accountId=UA-XXXXX-X&c_Section=Life%20%26%20Style &c_itemOrderId=1234&c_itemSku=DD44&c_itemName=T-Shirt&c_itemCategory=Olive%20Medium& c_itemPrice=11.99&c_itemQuantity=1