DIL-modules dil-modules
Beschrijft methodes in DIL.modules
namespace. Met deze modules kunt u programmatisch gegevens verzamelen en werken met Audience Manager-objecten.
siteCatalyst.init sitecat-init
Werkt met DIL om Analytics -tag-elementen (variabelen, eigenschappen, eVars, enz.) naar Audience Manager te verzenden. Retourneert gegevens in een door komma's gescheiden lijst. Beschikbaar in versie 2.6.
de Handtekening van de Functie: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)
s.t();
functie.Parameters
names
pageName
, channel
, campaign
, product
, enz. bevat.iteratedNames
prop1
, prop2
, evar3
, evar4
) bevat.maxIndex
maxIndex:2
in als u bijvoorbeeld twee stappen of gebeurtenissen wilt retourneren.siteCatalystReportingSuite
dilInstance
options
Aanvullende opties:
-
replaceContextDataPeriodsWith
Als u niets anders opgeeft, worden punten vervangen door het standaardonderstrepingsteken ( _ ).
s.contextData = {abc.def = '123'}
resulteert bijvoorbeeld inc_contextData_abc_def=123
in de queryreeks voor de gebeurtenisaanroep.Deze optie is alleen beschikbaar in DIL versie 5.0 of hoger.
-
filterFromContextVariables
filterFromContextVariables: ['email', 'zip', 'accountNumber']
resulteert bijvoorbeeld in het filteren van de array van tekenreeksen uit de gegevensverzameling van contextgegevens. Deze optie sluit Persoonlijke identificeerbare informatie (PII) uit.
Gegevens die door siteCatalyst.init worden gevangen
Deze functie retourneert details over de volgende Analytics -eigenschappen:
pageName
channel
campaign
products
events
eVar
(1 - 250)prop
(1 - 75)pe
pev1
pev2
pev3
Code van de Steekproef
Met deze code maakt u een door komma's gescheiden lijst met Analytics -gebeurtenissen (eigenschappen, variabelen, enzovoort) 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
}]
});
Als u alle gecontroleerde gegevenspunten van Analytics wilt bijhouden zonder de extra functie die hierboven wordt weergegeven, roept u siteCatalyst.init
op als volgt:
DIL.modules.siteCatalyst.init(s, scDil);
GA.submitUniversalAnalytics ga-submit-universal-analytics
De functie GA.submitUniversalAnalytics();
verzendt gegevens van Google Universal Analytics naar Audience Manager. Deze functie DIL is ontworpen om te werken met analytics.js
, de nieuwste codebibliotheek voor Google Universal Analytics .
-
Audience Manager heeft geen insight in of controle over de Google
analytics.js
-codebibliotheek. Controleer of de gegevensverzameling van DIL nog steeds werkt als of wanneer Google nieuwe versies vananalytics.js
publiceert. -
U kunt
GA.submitUniversalAnalytics();
niet gebruiken als u nog steeds werkt met code voor het bijhouden van Google-analyses (bijvoorbeeldga.js
ofdc.js
). Zie GA.initin plaats daarvan.
de Handtekening van de Functie: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Eigenschappen
De functie GA.submitUniversalAnalytics();
accepteert de volgende eigenschappen.
gaObject
ga
standaard, tenzij u uw Google Analytics -code hebt aangepast.dilInstance
internalPropertyName
(Optioneel) In de analytics.js
-bibliotheek is de interne eigenschap de geminificeerde variabele 'b'
. Deze variabele bevat 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'
, roept u GA.submitUniversalAnalytics();
als volgt aan:
DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');
Voorbeeld
Denk eraan het object Google Analytics ga
eerst te definiëren voordat u DIL en GA.submitUniversalAnalytics();
aanroept. 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 functie GA.init()
verzendt gegevens van de verouderde/vervangen versie van Google Analytics naar Audience Manager.
GA.init()
werkt alleen met code ga.js
of dc.js
voor het bijhouden van analyses van Google. U kunt deze DIL functie niet aanroepen als u analytics.js
gebruikt, de nieuwste codebibliotheek voor Google Universal Analytics . Audience Manager klanten die DIL en Universal Analytics gebruiken zouden GA.submitUniversalAnalyticsmoeten zien.de Handtekening van de Functie: DIL.modules.GA.init(_gaq, dilInstance, trackVars);
Parameters
_gaq
dilInstance
trackVars
names
bezit bestaat. Deze eigenschap is een array van GA-opdrachtnamen die u wilt bijhouden.Ondersteunde vraag van de Functie GA
Standaard legt GA.init
gegevens van de volgende functies vast:
_setCustomVar
_addItem
_addTrans
_setAccount
_trackSocial
DIL creeert Sleutels voor Gegevens GA
Audience Manager accepteert gegevens in de vorm van sleutelwaardeparen, terwijl GA werkt met items in een array. Als u met GA-gegevens wilt werken, maakt DIL automatisch een sleutelwaardepaar en vormt dit een sleutel als deze: 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 wijst sleutels voor de volgende methodes GA in kaart:
// 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
]);
Code van de Steekproef
// 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
]);
Als u alle bewaakte GA-meetgegevens wilt bijhouden zonder de hierboven weergegeven extra functie, roept u GA.init
als volgt aan:
DIL.modules.GA.init(_gaq, dilInstance).submit();
Vraag van de Gebeurtenis van de Steekproef
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