Módulos da DIL dil-modules
Descreve métodos na variável DIL.modules
namespace. Esses módulos permitem coletar dados de forma programática e trabalhar com objetos Audience Manager.
siteCatalyst.init sitecat-init
Funciona com DIL para enviar Analytics elementos de tag (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)
s.t();
função.Parâmetros
names
pageName
, channel
, campaign
, product
, etc.iteratedNames
prop1
, prop2
, evar3
, evar4
).maxIndex
maxIndex:2
.siteCatalystReportingSuite
dilInstance
options
Opções adicionais:
-
replaceContextDataPeriodsWith
Se você não especificar mais nada, os pontos serão substituídos pelo sublinhado padrão ( _ ).
Por exemplo
s.contextData = {abc.def = '123'}
resultaria emc_contextData_abc_def=123
na string de consulta da 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 matriz de cadeias de caracteres sendo filtrada da coleção de dados de contexto. Essa opção exclui informações pessoais identificáveis (PII).
Dados capturados pelo siteCatalyst.init
Esta função retorna detalhes sobre o seguinte 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 existirem 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 Analytics pontos de dados sem a função adicional mostrada acima, chame siteCatalyst.init
por si só, assim:
DIL.modules.siteCatalyst.init(s, scDil);
GA.submitUniversalAnalytics ga-submit-universal-analytics
A variável GA.submitUniversalAnalytics();
A função envia dados do Google Universal Analytics para Audience Manager. Este DIL 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 nem controle sobre a Google
analytics.js
biblioteca de códigos. Você deve verificar se DIL a coleta de dados ainda está funcionando se ou quando o Google lançar novas versões doanalytics.js
. -
Você não pode usar
GA.submitUniversalAnalytics();
se você ainda estiver trabalhando com o código de rastreamento de análise herdado do Google (por exemplo,ga.js
oudc.js
). Consulte GA.init em vez disso.
Assinatura da Função: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Propriedades
A variável GA.submitUniversalAnalytics();
A função aceita as seguintes propriedades.
gaObject
ga
por padrão, a menos que você tenha personalizado seu Google Analytics código.dilInstance
internalPropertyName
(Opcional) No analytics.js
, a propriedade internal é a variável minificada 'b'
. Essa variável contém Google Analytics dados.
Essa propriedade é opcional porque você não precisa defini-la, a menos que o Google altere o nome de sua variável interna. Por exemplo, se essa variável minificada mudou para 'a'
, você chamaria GA.submitUniversalAnalytics();
assim:
DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');
Exemplo
Lembre-se de definir a variável Google Analytics ga
objeto primeiro, antes de chamar DIL e GA.submitUniversalAnalytics();
. O código pode ser semelhante a:
//Instantiate DIL
var dilInstance = DIL.create({
partner:"adobe"
});
//Call the DIL Universal Analytics function
DIL.modules.GA.submitUniversalAnalytics(ga, dilInstance);
GA.init ga-init
A variável GA.init()
A função envia dados da versão herdada/obsoleta do Google Analytics para Audience Manager.
GA.init()
funciona somente com o código de rastreamento de análise herdado do Google, ga.js
ou dc.js
. Você não pode invocar este 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 deve ver GA.submitUniversalAnalytics.Assinatura da Função: DIL.modules.GA.init(_gaq, dilInstance, trackVars);
Parâmetros
_gaq
dilInstance
trackVars
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 funciona com itens em uma matriz. Para trabalhar com dados do GA, DIL O cria um par de valor-chave automaticamente e forma uma chave como esta: c_ <key name>
. Além disso, os itens nos arrays GA aparecem 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 O mapeia chaves para os seguintes métodos do 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
por si só, assim:
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