Descrive i metodi nello spazio dei nomi DIL.modules
. Questi moduli consentono di raccogliere i dati in modo programmatico e di lavorare con oggetti di Audience Manager.
Funziona con DIL per inviare elementi tag Analytics (variabili, proprietà, eVar, ecc.) all'Audience Manager. Restituisce i dati in un elenco separato da virgole. Disponibile nella versione 2.6.
Firma della funzione: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)
Devi inserire questo codice nella pagina prima della funzione s.t();
.
Parametri
Nomi | Tipo | Descrizione |
---|---|---|
names |
Stringa | Array di stringhe contenenti variabili Analytics non enumerate come |
iteratedNames |
Oggetto | Matrice di oggetti che contiene variabili enumerate Analytics come prop ed evar (ad esempio |
maxIndex |
Intero | Indica quanti nomi iterati si desidera restituire. Ad esempio, per restituire due proprietà o evar, imposta |
siteCatalystReportingSuite |
Oggetto | Un oggetto che rappresenta l'oggetto Analytics . |
dilInstance |
Oggetto | Un oggetto che rappresenta DIL . |
options |
Oggetto | Opzioni aggiuntive:
|
Dati acquisiti da siteCatalyst.init
Questa funzione restituisce i dettagli sulle seguenti proprietà Analytics :
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 eventi Analytics (proprietà, eVar, ecc.) se esistono dei valori per essi.
// 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 punti di dati Analytics monitorati senza la funzione aggiuntiva mostrata sopra, invoca siteCatalyst.init
da solo come segue:
DIL.modules.siteCatalyst.init(s, scDil);
La funzione GA.submitUniversalAnalytics();
invia ad Audience Manager i dati da Universal Analytics di Google. Questa funzione DIL è progettata per funzionare con analytics.js
, che è la libreria di codici più recente per Google Universal Analytics.
Audience Manager non dispone di informazioni approfondite o di alcun controllo sulla libreria di analytics.js
codici Google. Verifica che la raccolta dati DIL funzioni ancora se o quando Google rilascia nuove versioni di analytics.js
.
Non puoi utilizzare GA.submitUniversalAnalytics();
se stai ancora lavorando con il codice di tracciamento legacy di Google Analytics (ad esempio, ga.js
o dc.js
). Vedi invece GA.init .
Firma della funzione: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Proprietà
La funzione GA.submitUniversalAnalytics();
accetta le seguenti proprietà.
Proprietà | Descrizione |
---|---|
|
La variabile globale dell'istanza di Google Analytics . Questo è solitamente |
|
Variabile che rappresenta l'istanza di DIL . |
|
(Facoltativo) Nella Questa proprietà è facoltativa perché non è necessario impostarla a meno che Google non modifichi il nome della relativa variabile interna. Ad esempio, se questa variabile minimizzata viene modificata in |
Esempio
Ricordare di definire prima l'oggetto Google Analytics ga
prima di chiamare DIL e GA.submitUniversalAnalytics();
. Il tuo codice potrebbe assomigliare a questo:
//Instantiate DIL
var dilInstance = DIL.create({
partner:"adobe"
});
//Call the DIL Universal Analytics function
DIL.modules.GA.submitUniversalAnalytics(ga, dilInstance);
La funzione GA.init()
invia ad Audience Manager i dati della versione legacy/obsoleta di Google Analytics .
GA.init()
funziona solo con il codice di tracciamento Analytics legacy di Google, ga.js
o dc.js
. Non è possibile richiamare questa funzione DIL se si utilizza analytics.js
, che è la libreria di codici più recente per Google Universal Analytics. Audience Manager i clienti che utilizzano DIL e Universal Analytics devono visualizzare GA.submitUniversalAnalytics.
Firma della funzione: DIL.modules.GA.init(_gaq, dilInstance, trackVars);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
_gaq |
Array | Matrice contenente comandi GA. |
dilInstance |
Oggetto | Un oggetto che contiene l'istanza DIL. |
trackVars |
Oggetto | (Facoltativo) Un oggetto costituito dalla names proprietà . Questa proprietà è una matrice di nomi di comando GA che si desidera tenere traccia. |
Chiamate a funzioni GA supportate
Per impostazione predefinita, GA.init
acquisisce dati dalle seguenti funzioni:
_setCustomVar
_addItem
_addTrans
_setAccount
_trackSocial
DIL crea chiavi per i dati GA
Audience Manager accetta i dati sotto forma di coppie chiave-valore, mentre GA funziona con gli elementi di un array. Per lavorare con i dati GA, DIL crea automaticamente una coppia chiave-valore e crea 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 mappa le 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, invoca GA.init
di per sé come segue:
DIL.modules.GA.init(_gaq, dilInstance).submit();
Chiamata evento di esempio
La chiamata dell'evento URL ad 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