Moduli DIL

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.

siteCatalyst.init

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)

NOTA

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 pageName , channel , campaign , product , ecc.

iteratedNames Oggetto

Matrice di oggetti che contiene variabili enumerate Analytics come prop ed evar (ad esempio prop1 , prop2 , evar3 , evar4 ).

maxIndex Intero

Indica quanti nomi iterati si desidera restituire. Ad esempio, per restituire due proprietà o evar, imposta maxIndex:2 .

siteCatalystReportingSuite Oggetto

Un oggetto che rappresenta l'oggetto Analytics .

dilInstance Oggetto

Un oggetto che rappresenta DIL .

options Oggetto

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'} si tradurrebbe in c_contextData_abc_def=123 nella stringa di query della chiamata dell'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. Questa opzione esclude le informazioni personali (PII, Personally Identifiable Information).

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);

GA.submitUniversalAnalytics

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.

IMPORTANTE
  • 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

gaObject

La variabile globale dell'istanza di Google Analytics . Questo è solitamente ga per impostazione predefinita, a meno che tu non abbia personalizzato il tuo codice Google Analytics .

dilInstance

Variabile che rappresenta l'istanza di DIL .

internalPropertyName

(Facoltativo) Nella analytics.js libreria, la proprietà interna è la variabile minimizzata 'b' . Questa variabile contiene Google Analytics i dati .

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 'a' , chiamerai GA.submitUniversalAnalytics(); in questo modo:

DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');

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);

GA.init

La funzione GA.init() invia ad Audience Manager i dati della versione legacy/obsoleta di Google Analytics .

IMPORTANTE

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

In questa pagina