DIL-modules dil-modules
Beschrijft methodes in DIL.modules
naamruimte. Deze modules laten u programmatically gegevens verzamelen en met de voorwerpen van de Audience Manager werken.
siteCatalyst.init sitecat-init
Werken met DIL naar verzenden Analytics tag-elementen (variabelen, props, eVars, enz.) naar Audience Manager. Retourneert gegevens in een door komma's gescheiden lijst. Beschikbaar in versie 2.6.
Functiehandtekening: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)
s.t();
functie.Parameters
names
pageName
, channel
, campaign
, product
, enz.iteratedNames
prop1
, prop2
, evar3
, evar4
).maxIndex
maxIndex:2
.siteCatalystReportingSuite
dilInstance
options
Aanvullende opties:
-
replaceContextDataPeriodsWith
Als u niets anders opgeeft, worden punten vervangen door het standaardonderstrepingsteken ( _ ).
Bijvoorbeeld
s.contextData = {abc.def = '123'}
zou leiden totc_contextData_abc_def=123
in de queryreeks voor gebeurtenisoproepen.Deze optie is alleen beschikbaar in DIL versie 5.0 of hoger.
-
filterFromContextVariables
Bijvoorbeeld:
filterFromContextVariables: ['email', 'zip', 'accountNumber']
resulteert in het filteren van de array van tekenreeksen uit de gegevensverzameling van contextgegevens. Deze optie sluit Persoonlijke identificeerbare informatie (PII) uit.
Gegevens vastgelegd door siteCatalyst.init
Deze functie retourneert details over het volgende Analytics eigenschappen:
pageName
channel
campaign
products
events
eVar
(1 - 250)prop
(1 - 75)pe
pev1
pev2
pev3
Voorbeeldcode
Deze code maakt een door komma's gescheiden lijst met Analytics gebeurtenissen (props, eVars, enz.) als er waarden voor bestaan.
// 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
}]
});
Alle bewaakte Analytics gegevenspunten zonder de hierboven getoonde extra functie, aanhalen siteCatalyst.init
op zich :
DIL.modules.siteCatalyst.init(s, scDil);
GA.submitUniversalAnalytics ga-submit-universal-analytics
De GA.submitUniversalAnalytics();
function verzendt gegevens van Google Universal Analytics naar Audience Manager. Dit DIL functie is ontworpen om te werken met analytics.js
, de nieuwste codebibliotheek voor Google Universal Analytics.
-
Audience Manager heeft geen inzicht in of controle over de Google
analytics.js
codebibliotheek. Controleer of DIL gegevensverzameling werkt nog steeds als of wanneer Google nieuwe versies vananalytics.js
. -
U kunt niet
GA.submitUniversalAnalytics();
als u nog steeds werkt met code voor het bijhouden van analyses van Google (bijvoorbeeldga.js
ofdc.js
). Zie GA.init in plaats daarvan.
Functiehandtekening: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Eigenschappen
De GA.submitUniversalAnalytics();
-functie accepteert de volgende eigenschappen.
gaObject
ga
standaard, tenzij u uw Google Analytics code.dilInstance
internalPropertyName
(Optioneel) In de analytics.js
bibliotheek, is het interne bezit de geminiatuurde variabele 'b'
. Deze variabele houdt rekening met Google Analytics gegevens.
Deze eigenschap is optioneel omdat u deze alleen hoeft in te stellen als Google de naam van de interne variabele wijzigt. Als deze geminificeerde variabele bijvoorbeeld is gewijzigd in 'a'
, u wilt bellen GA.submitUniversalAnalytics();
als volgt:
DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');
Voorbeeld
Vergeet niet de Google Analytics ga
object eerst, voordat wordt aangeroepen DIL en GA.submitUniversalAnalytics();
. Uw code kan er ongeveer als volgt uitzien:
//Instantiate DIL
var dilInstance = DIL.create({
partner:"adobe"
});
//Call the DIL Universal Analytics function
DIL.modules.GA.submitUniversalAnalytics(ga, dilInstance);
GA.init ga-init
De GA.init()
functie verzendt gegevens van de verouderde/vervangen versie van Google Analytics naar Audience Manager.
GA.init()
werkt alleen met de code voor het bijhouden van analyses van Google. ga.js
of dc.js
. U kunt dit niet aanroepen DIL functie als u analytics.js
, de nieuwste codebibliotheek voor Google Universal Analytics. Audience Manager klanten die DIL en Universal Analytics moet GA.submitUniversalAnalytics.Functiehandtekening: DIL.modules.GA.init(_gaq, dilInstance, trackVars);
Parameters
_gaq
dilInstance
trackVars
names
eigenschap. Deze eigenschap is een array van GA-opdrachtnamen die u wilt bijhouden.Ondersteunde functieaanroepen GA
Standaard, GA.init
vangt gegevens van de volgende functies:
_setCustomVar
_addItem
_addTrans
_setAccount
_trackSocial
DIL maakt toetsen voor GA-gegevens
Audience Manager accepteert gegevens in de vorm van sleutelwaardeparen, terwijl GA werkt met items in een array. Om met GA-gegevens te werken, DIL maakt automatisch een sleutelwaardepaar en vormt zo een sleutel: c_ <key name>
. Items in GA-arrays worden ook in een specifieke volgorde weergegeven. Dit betekent dat u alle parameters in die volgorde moet opgeven, zelfs als deze geen gegevens bevatten. DIL kaarttoetsen voor de volgende GA-methoden:
// 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
]);
Voorbeeldcode
// 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 alle bewaakte GA metriek zonder de extra hierboven getoonde functie te volgen, haal GA.init
op zich :
DIL.modules.GA.init(_gaq, dilInstance).submit();
Voorbeeld van gebeurtenisoproep
De URL-gebeurtenisaanroep naar Audience Manager kan er als volgt uitzien:
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