Moduler DIL dil-modules
Beskriver metoder i namnområdet DIL.modules
. Med dessa moduler kan du programmässigt samla in data och arbeta med Audience Manager-objekt.
siteCatalyst.init sitecat-init
Fungerar med DIL för att skicka Analytics-taggelement (variabler, props, eVars osv.) till Audience Manager. Returnerar data i en kommaavgränsad lista. Finns i version 2.6.
Funktionssignatur: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)
s.t();
.Parametrar
names
pageName
, channel
, campaign
, product
osv.iteratedNames
prop1
, prop2
, evar3
, evar4
).maxIndex
maxIndex:2
.siteCatalystReportingSuite
dilInstance
options
Ytterligare alternativ:
-
replaceContextDataPeriodsWith
Om du inte anger något annat ersätts punkter med standardunderstrecket ( _ ).
s.contextData = {abc.def = '123'}
skulle till exempel resultera ic_contextData_abc_def=123
i frågesträngen för händelsanropet.Det här alternativet är endast tillgängligt i DIL version 5.0 eller senare.
-
filterFromContextVariables
filterFromContextVariables: ['email', 'zip', 'accountNumber']
skulle till exempel resultera i att strängarrayen filtreras från datainsamlingen för kontextdata. Det här alternativet utesluter PII (Personally Identiitable Information).
Data som samlats in av siteCatalyst.init
Den här funktionen returnerar information om följande Analytics-egenskaper:
pageName
channel
campaign
products
events
eVar
(1 - 250)prop
(1-75)pe
pev1
pev2
pev3
Exempelkod
Den här koden skapar en kommaavgränsad lista med Analytics händelser (props, eVars osv.) om det finns värden för dem.
// 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
}]
});
Om du vill spåra alla övervakade Analytics-datapunkter utan den tilläggsfunktion som visas ovan, anropar du siteCatalyst.init
separat så här:
DIL.modules.siteCatalyst.init(s, scDil);
GA.submitUniversalAnalytics ga-submit-universal-analytics
Funktionen GA.submitUniversalAnalytics();
skickar data från Google Universal Analytics till Audience Manager. Den här DIL-funktionen är utformad för att fungera med analytics.js
, som är det senaste kodbiblioteket för Google Universal Analytics.
-
Audience Manager har ingen insikt i eller kontroll över Google
analytics.js
-kodbiblioteket. Du bör verifiera att datainsamlingen DIL fortfarande fungerar om eller när Google släpper nya versioner avanalytics.js
. -
Du kan inte använda
GA.submitUniversalAnalytics();
om du fortfarande arbetar med spårningskod för tidigare Google-analyser (t.ex.ga.js
ellerdc.js
). Se GA.init i stället.
Funktionssignatur: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Egenskaper
Funktionen GA.submitUniversalAnalytics();
accepterar följande egenskaper.
gaObject
ga
som standard, såvida du inte har anpassat din Google Analytics -kod.dilInstance
internalPropertyName
(Valfritt) I biblioteket analytics.js
är egenskapen internal den minifierade variabeln 'b'
. Den här variabeln innehåller Google Analytics -data.
Den här egenskapen är valfri eftersom du inte behöver ange den om inte Google ändrar namnet på deras interna variabel. Om den här minifierade variabeln till exempel har ändrats till 'a'
anropar du GA.submitUniversalAnalytics();
så här:
DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');
Exempel
Kom ihåg att definiera objektet Google Analytics ga
först, innan du anropar DIL och GA.submitUniversalAnalytics();
. Koden kan se ut ungefär så här:
//Instantiate DIL
var dilInstance = DIL.create({
partner:"adobe"
});
//Call the DIL Universal Analytics function
DIL.modules.GA.submitUniversalAnalytics(ga, dilInstance);
GA.init ga-init
Funktionen GA.init()
skickar data från den gamla/ersatta versionen av Google Analytics till Audience Manager.
GA.init()
fungerar bara med Google äldre analytikspårningskod, ga.js
eller dc.js
. Du kan inte anropa den här DIL-funktionen om du använder analytics.js
, som är det senaste kodbiblioteket för Google Universal Analytics. Audience Manager kunder som använder DIL och Universal Analytics bör läsa GA.submitUniversalAnalytics.Funktionssignatur: DIL.modules.GA.init(_gaq, dilInstance, trackVars);
Parametrar
_gaq
dilInstance
trackVars
names
. Den här egenskapen är en array med GA-kommandonamn som du vill spåra.GA-funktionsanrop som stöds
Som standard hämtar GA.init
data från följande funktioner:
_setCustomVar
_addItem
_addTrans
_setAccount
_trackSocial
DIL skapar nycklar för GA-data
Audience Manager accepterar data i form av nyckelvärdepar medan GA arbetar med objekt i en array. Om du vill arbeta med GA-data skapar DIL automatiskt ett nyckelvärdepar och skapar en nyckel som den här: c_ <key name>
. Dessutom visas objekt i GA-arrayer i en viss ordning. Därför måste du ange alla parametrar i den ordningen, även om de inte innehåller några data. DIL mappar nycklar för följande GA-metoder:
// 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
]);
Exempelkod
// 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
]);
Om du vill spåra alla övervakade GA-mått utan den ytterligare funktion som visas ovan, anropar du GA.init
separat så här:
DIL.modules.GA.init(_gaq, dilInstance).submit();
Exempel på händelseanrop
URL-händelseanropet till Audience Manager kan se ut ungefär så här:
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