DIL Modules 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
namespageName , channel , campaign , product osv.iteratedNamesprop1 , prop2 , evar3 , evar4 ).maxIndexmaxIndex:2 .siteCatalystReportingSuitedilInstanceoptionsYtterligare alternativ:
-
replaceContextDataPeriodsWithOm du inte anger något annat ersätts punkter med standardunderstrecket ( _ ).
s.contextData = {abc.def = '123'}skulle till exempel resultera ic_contextData_abc_def=123i frågesträngen för händelsanropet.Det här alternativet är endast tillgängligt i DIL version 5.0 eller senare.
-
filterFromContextVariablesfilterFromContextVariables: ['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:
pageNamechannelcampaignproductseventseVar(1 - 250)prop(1-75)pepev1pev2pev3
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.jsellerdc.js). Se GA.init i stället.
Funktionssignatur: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Egenskaper
Funktionen GA.submitUniversalAnalytics(); accepterar följande egenskaper.
gaObjectga som standard, såvida du inte har anpassat din Google Analytics -kod.dilInstanceinternalPropertyName(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
_gaqdilInstancetrackVarsnames. 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 godkänner 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