Show Menu
TÓPICOS×

Módulos DIL

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

siteCatalyst.init

Funciona com DIL para enviar elementos de Analytics tags (variáveis, props, eVars etc.) para o 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)
Você deve colocar esse código na página antes da s.t(); função.
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 , campanha , produto etc.
iteratedNames Objeto
Uma matriz de objetos que contém variáveis enumeradas do Analytics, 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 Analytics .
dilInstance Objeto
Um objeto que representa DIL .
opções 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 string de consulta de chamada de evento.
    Essa opção está disponível somente na DIL versão 5.0 ou posterior.
  • filterFromContextVariables
    Por exemplo, filterFromContextVariables: ['email', 'zip', 'accountNumber'] resultaria na matriz de strings sendo filtrada da coleta de dados de contexto. Essa opção exclui as Informações pessoais identificáveis (PII).
Dados capturados pelo siteCatalyst.init
Essa função retorna detalhes sobre as seguintes Analytics propriedades:
  • 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 Analytics dados monitorados sem a função adicional mostrada acima, chame siteCatalyst.init por si mesmo desta forma:
DIL.modules.siteCatalyst.init(s, scDil);

GA.submitUniversalAnalytics

A GA.submitUniversalAnalytics(); função envia dados do Google Universal Analytics para o Audience Manager. Esta DIL função foi projetada para funcionar com analytics.js , que é a biblioteca de códigos mais recente do Google Universal Analytics.
  • Audience Manager não tem nenhum insight ou controle sobre a biblioteca de analytics.js códigos do Google. Você deve verificar se a coleta de dados ainda está funcionando se ou quando o Google lançar novas versões do DIL analytics.js .
  • Não é possível usar GA.submitUniversalAnalytics(); se você ainda estiver trabalhando com o código de rastreamento de análise herdado do Google (por exemplo, ga.js ou dc.js ). Em vez disso, consulte GA.init .
**** Assinatura da função: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Propriedades
A GA.submitUniversalAnalytics(); função aceita as seguintes propriedades.
Propriedade Descrição
gaObject
A variável global para sua instância do Google Analytics . Normalmente, isso é ga por padrão, a menos que você tenha personalizado seu código do Google Analytics .
dilInstance
A variável que representa a sua instância do DIL .
internalPropertyName
(Opcional) Na biblioteca analytics.js , a propriedade interna é a variável minified 'b' . Essa variável contém dados do 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(); como:
DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');
Exemplo
Lembre-se de definir o Google Analytics ga objeto 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 GA.init() função envia dados da versão herdada/obsoleta do para Google Analytics o Audience Manager.
GA.init() funciona somente com o código de rastreamento de análise herdado do Google, ga.js ou dc.js . Não é possível invocar essa DIL função se você usar analytics.js , que é a biblioteca de códigos mais recente do Google Universal Analytics. Audience Manager clientes que usam DIL e Universal Analytics devem ver GA.submitUniversalAnalytics .
**** 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 um par de valores chave automaticamente 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 desta forma:
DIL.modules.GA.init(_gaq, dilInstance).submit();
Exemplo de chamada de evento
A chamada de evento de URL para o 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