Módulos da DIL

Descreve métodos no namespace DIL.modules. Esses módulos permitem coletar dados de forma programática e trabalhar com objetos Audience Manager.

siteCatalyst.init

Funciona com DIL para enviar elementos de tags Analytics (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)

OBSERVAÇÃO

Você deve colocar esse código na página antes de da função s.t();.

Parâmetros

Nomes Tipo Descrição
names String

Uma matriz de cadeias de caracteres 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 as variáveis enumeradas do Analytics como props e evars (por exemplo, prop1 , prop2 , evar3 , evar4 ).

maxIndex Número inteiro

Indica quantos nomes iterados 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 sã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 consulta de chamada de evento.

    Essa opção está disponível somente no DIL versão 5.0 ou posterior.

  • 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 informações pessoais identificáveis (PII).

Dados capturados pelo siteCatalyst.init

Essa 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 sozinho assim:

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

GA.submitUniversalAnalytics

A função GA.submitUniversalAnalytics(); envia dados do 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 para o Google Universal Analytics.

IMPORTANTE
  • 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 DIL ainda está funcionando se ou quando o Google lança novas versões de analytics.js.

  • Você não pode usar GA.submitUniversalAnalytics(); se 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 função GA.submitUniversalAnalytics(); aceita as seguintes propriedades.

Propriedade Descrição

gaObject

A variável global para sua instância de Google Analytics . Isso geralmente é ga por padrão, a menos que você tenha personalizado seu código Google Analytics .

dilInstance

A variável que representa a instância de DIL .

internalPropertyName

(Opcional) Na analytics.js biblioteca, a propriedade interna é a variável minificada 'b' . Essa variável armazena 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 minificada fosse alterada 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();. O 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.

IMPORTANTE

GA.init() O só funciona com o código de rastreamento de análise herdado do Google, ga.js ou dc.js. Não é possível chamar essa função DIL se você usar analytics.js, que é a biblioteca de códigos mais recente para o Google Universal Analytics. Audience Manager clientes que usam DIL e Universal Analytics devem consultar GA.submitUniversalAnalytics.

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

Parâmetros

Nome Tipo Descrição
_gaq Matriz Uma matriz 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 do 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 do GA

O Audience Manager aceita dados na forma de pares de valores chave enquanto o GA trabalha com itens em uma matriz. Para trabalhar com dados do 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 aparecem em uma ordem específica. Como resultado, você deve fornecer todos os parâmetros nessa ordem, mesmo quando eles não contiverem 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 de GA monitoradas sem a função adicional mostrada acima, chame GA.init sozinho assim:

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

Exemplo de chamada de evento

A chamada do 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

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now