Moduli DIL dil-modules
Descrive i metodi in DIL.modules
spazio dei nomi. Questi moduli ti consentono di raccogliere dati in modo programmatico e lavorare con oggetti Audienci Manager.
siteCatalyst.init sitecat-init
Funziona con DIL da inviare Analytics elementi tag (variabili, prop, eVar, ecc.) all'Audience Manager. Restituisce i dati in un elenco separato da virgole. Disponibile nella versione 2.6.
Firma funzione: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)
s.t();
funzione.Parametri
names
pageName
, channel
, campaign
, product
, ecc.iteratedNames
prop1
, prop2
, evar3
, evar4
).maxIndex
maxIndex:2
.siteCatalystReportingSuite
dilInstance
options
Opzioni aggiuntive:
-
replaceContextDataPeriodsWith
Se non si specifica altro, i punti vengono sostituiti con il carattere di sottolineatura predefinito ( _ ).
Ad esempio
s.contextData = {abc.def = '123'}
comporterebbec_contextData_abc_def=123
nella stringa di query della chiamata evento.Questa opzione è disponibile solo in DIL versione 5.0 o successiva.
-
filterFromContextVariables
Ad esempio:
filterFromContextVariables: ['email', 'zip', 'accountNumber']
comporterebbe il filtraggio dell’array di stringhe dalla raccolta di dati contestuali. Sono escluse le informazioni personali (PII, Personally Identifiable Information).
Dati acquisiti da siteCatalyst.init
Questa funzione restituisce dettagli sui seguenti elementi Analytics proprietà:
pageName
channel
campaign
products
events
eVar
(1 - 250)prop
(1 - 75)pe
pev1
pev2
pev3
Codice di esempio
Questo codice crea un elenco separato da virgole di Analytics eventi (prop, eVar, ecc.) se esistono dei valori per esse.
// 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
}]
});
Per tenere traccia di tutti i dati monitorati Analytics punti dati senza la funzione aggiuntiva mostrata sopra, richiama siteCatalyst.init
di per sé come questo:
DIL.modules.siteCatalyst.init(s, scDil);
GA.submitUniversalAnalytics ga-submit-universal-analytics
Il GA.submitUniversalAnalytics();
invia dati da Google Universal Analytics all'Audience Manager. Questo DIL è progettata per l'utilizzo con analytics.js
, che è la libreria di codici più recente per Google Universal Analytics.
-
Audience Manager non ha alcuna informazione o controllo sul Google
analytics.js
libreria dei codici. È necessario verificare che DIL la raccolta dati funziona ancora se o quando Google rilascia nuove versioni dianalytics.js
. -
Non è possibile utilizzare
GA.submitUniversalAnalytics();
se utilizzi ancora il codice di tracciamento Analytics legacy di Google (ad esempio,ga.js
odc.js
). Consulta GA.init invece.
Firma funzione: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Proprietà
Il GA.submitUniversalAnalytics();
la funzione accetta le seguenti proprietà.
gaObject
ga
per impostazione predefinita, a meno che tu non abbia personalizzato Google Analytics codice.dilInstance
internalPropertyName
(Facoltativo) In analytics.js
, la proprietà interna è la variabile minimizzata 'b'
. Questa variabile contiene Google Analytics dati.
Questa proprietà è facoltativa perché non è necessario impostarla a meno che Google non modifichi il nome della variabile interna. Ad esempio, se questa variabile minimizzata è stata modificata in 'a'
, chiameresti GA.submitUniversalAnalytics();
così:
DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');
Esempio
Ricorda di definire Google Analytics ga
prima dell'oggetto, prima della chiamata DIL e GA.submitUniversalAnalytics();
. Il codice sarà simile al seguente:
//Instantiate DIL
var dilInstance = DIL.create({
partner:"adobe"
});
//Call the DIL Universal Analytics function
DIL.modules.GA.submitUniversalAnalytics(ga, dilInstance);
GA.init ga-init
Il GA.init()
invia dati dalla versione legacy/obsoleta di Google Analytics all'Audience Manager.
GA.init()
funziona solo con il codice di tracciamento Analytics legacy di Google, ga.js
o dc.js
. Non è possibile richiamarlo DIL funzione se utilizza analytics.js
, che è la libreria di codici più recente per Google Universal Analytics. Audience Manager clienti che utilizzano DIL e Universal Analytics dovrebbe vedere GA.submitUniversalAnalytics.Firma funzione: DIL.modules.GA.init(_gaq, dilInstance, trackVars);
Parametri
_gaq
dilInstance
trackVars
names
proprietà. Questa proprietà è una matrice di nomi di comandi GA di cui si desidera tenere traccia.Chiamate di funzione GA supportate
Per impostazione predefinita, GA.init
acquisisce dati dalle seguenti funzioni:
_setCustomVar
_addItem
_addTrans
_setAccount
_trackSocial
DIL crea chiavi per dati GA
Audienci Manager accetta i dati sotto forma di coppie chiave-valore, mentre GA funziona con gli elementi in un array. Per lavorare con i dati GA: DIL crea automaticamente una coppia chiave-valore e forma una chiave come questa: c_ <key name>
. Inoltre, gli elementi negli array GA vengono visualizzati in un ordine specifico. Di conseguenza, è necessario fornire tutti i parametri in tale ordine, anche quando non contengono dati. DIL mappatura delle chiavi per i seguenti metodi 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
]);
Codice di esempio
// 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
]);
Per tenere traccia di tutte le metriche GA monitorate senza la funzione aggiuntiva mostrata sopra, richiama GA.init
di per sé come questo:
DIL.modules.GA.init(_gaq, dilInstance).submit();
Chiamata evento di esempio
La chiamata evento URL all’Audience Manager potrebbe essere simile alla seguente:
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