DIL-moduler dil-modules
Beskriver metoder i DIL.modules
namnutrymme. Med dessa moduler kan du programmässigt samla in data och arbeta med Audience Manager-objekt.
siteCatalyst.init sitecat-init
Fungerar med DIL 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();
funktion.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 ( _ ).
Till exempel
s.contextData = {abc.def = '123'}
skulle resultera ic_contextData_abc_def=123
i frågesträngen för händelsanrop.Det här alternativet är bara tillgängligt i DIL version 5.0 eller senare.
-
filterFromContextVariables
Till exempel:
filterFromContextVariables: ['email', 'zip', 'accountNumber']
resulterar 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
}]
});
För att spåra alla övervakade Analytics datapunkter utan den extra funktion som visas ovan, anropa siteCatalyst.init
på det här sättet:
DIL.modules.siteCatalyst.init(s, scDil);
GA.submitUniversalAnalytics ga-submit-universal-analytics
The GA.submitUniversalAnalytics();
funktionen skickar data från Google Universal Analytics till Audience Manager. Detta DIL funktionen är utformad för att fungera med analytics.js
, som är det senaste kodbiblioteket för Google Universal Analytics.
-
Audience Manager inte har någon insikt i eller kontroll över Google
analytics.js
kodbibliotek. Du bör verifiera att DIL datainsamlingen fungerar fortfarande om eller när Google släpper nya versioner avanalytics.js
. -
Du kan inte använda
GA.submitUniversalAnalytics();
om du fortfarande arbetar med Google spårningskod för äldre analyser (t.ex.ga.js
ellerdc.js
). Se GA.init i stället.
Funktionssignatur: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Egenskaper
The GA.submitUniversalAnalytics();
funktionen accepterar följande egenskaper.
gaObject
ga
som standard, såvida du inte har anpassat Google Analytics kod.dilInstance
internalPropertyName
(Valfritt) I analytics.js
library, the internal property is the minified variable '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'
ringer du GA.submitUniversalAnalytics();
så här:
DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');
Exempel
Kom ihåg att definiera Google Analytics ga
objekt först, innan anrop 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
The GA.init()
funktionen skickar data från den gamla/ersatta versionen av Google Analytics till Audience Manager.
GA.init()
fungerar bara med Google äldre kod för spårning av analyser, ga.js
eller dc.js
. Du kan inte anropa detta DIL 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 se GA.submitUniversalAnalytics.Funktionssignatur: DIL.modules.GA.init(_gaq, dilInstance, trackVars);
Parametrar
_gaq
dilInstance
trackVars
names
-egenskap. Den här egenskapen är en array med GA-kommandonamn som du vill spåra.Följande funktionsanrop stöds:
Som standard GA.init
hämtar 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. För att arbeta med GA-data DIL skapar automatiskt ett nyckelvärdepar och skapar en nyckel som denna: 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
på det här sättet:
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