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

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