DIL-Module dil-modules
Beschreibt Methoden im Namespace DIL.modules
. Mit diesen Modulen können Sie Daten programmgesteuert erfassen und mit Audience Manager-Objekten arbeiten.
siteCatalyst.init sitecat-init
Funktioniert mit DIL , um Analytics -Tag-Elemente (Variablen, Props, eVars usw.) zu senden. auf Audience Manager. Gibt Daten in einer kommagetrennten Liste zurück. Verfügbar in Version 2.6.
Funktionssignatur: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)
s.t();
platzieren.Parameter
names
pageName
, channel
, campaign
, product
usw. enthalten.iteratedNames
prop1
, prop2
, evar3
, evar4
).maxIndex
maxIndex:2
fest.siteCatalystReportingSuite
dilInstance
options
Zusätzliche Optionen:
-
replaceContextDataPeriodsWith
Wenn Sie nichts anderes angeben, werden Punkte durch den standardmäßigen Unterstrich ( _ ) ersetzt.
Beispiel:
s.contextData = {abc.def = '123'}
würde in der Abfragezeichenfolge des Ereignisaufrufs zuc_contextData_abc_def=123
führen.Diese Option ist nur in DIL Version 5.0 oder neuer verfügbar.
-
filterFromContextVariables
Beispiel:
filterFromContextVariables: ['email', 'zip', 'accountNumber']
würde dazu führen, dass das Array von Zeichenfolgen aus der Datenerfassung von Kontextdaten gefiltert wird. Bei dieser Option werden personenbezogene Daten (PII) ausgeschlossen.
Von SiteCatalyst.init erfasste Daten
Diese Funktion gibt Details zu den folgenden Analytics -Eigenschaften zurück:
pageName
channel
campaign
products
events
eVar
(1 - 250)prop
(1-75)pe
pev1
pev2
pev3
Beispielcode
Dieser Code erstellt eine kommagetrennte Liste von Analytics -Ereignissen (Props, eVars usw.) , wenn Werte für sie vorhanden sind.
// 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
}]
});
Um alle überwachten Analytics -Datenpunkte ohne die oben dargestellte zusätzliche Funktion zu verfolgen, rufen Sie siteCatalyst.init
allein wie folgt auf:
DIL.modules.siteCatalyst.init(s, scDil);
GA.submitUniversalAnalytics ga-submit-universal-analytics
Die Funktion GA.submitUniversalAnalytics();
sendet Daten von Google Universal Analytics an Audience Manager. Diese DIL -Funktion wurde für die Verwendung mit analytics.js
entwickelt, der neuesten Codebibliothek für Google Universal Analytics.
-
Audience Manager hat keine Einblicke in die Google
analytics.js
-Codebibliothek und hat keine Kontrolle darüber. Sie sollten sicherstellen, dass die DIL-Datenerfassung weiterhin funktioniert, wenn oder wenn Google neue Versionen vonanalytics.js
veröffentlicht. -
Sie können
GA.submitUniversalAnalytics();
nicht verwenden, wenn Sie weiterhin mit dem alten Analytics-Trackingcode von Google arbeiten (z. B.ga.js
oderdc.js
). Siehe stattdessen GA.init .
Funktionssignatur: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Eigenschaften
Die Funktion GA.submitUniversalAnalytics();
akzeptiert die folgenden Eigenschaften.
gaObject
ga
, es sei denn, Sie haben Ihren Google Analytics -Code angepasst.dilInstance
internalPropertyName
(Optional) In der Bibliothek analytics.js
ist die interne Eigenschaft die minimierte Variable 'b'
. Diese Variable enthält Google Analytics -Daten.
Diese Eigenschaft ist optional, da Sie sie nur festlegen müssen, wenn Google den Namen der internen Variablen ändert. Wenn diese minimierte Variable beispielsweise zu 'a'
geändert wird, rufen Sie GA.submitUniversalAnalytics();
wie folgt auf:
DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');
Beispiel
Denken Sie daran, zuerst das Objekt Google Analytics ga
zu definieren, bevor Sie DIL und GA.submitUniversalAnalytics();
aufrufen. Ihr Code könnte in etwa wie folgt aussehen:
//Instantiate DIL
var dilInstance = DIL.create({
partner:"adobe"
});
//Call the DIL Universal Analytics function
DIL.modules.GA.submitUniversalAnalytics(ga, dilInstance);
GA.init ga-init
Die Funktion GA.init()
sendet Daten aus der veralteten/veralteten Version von Google Analytics an Audience Manager.
GA.init()
funktioniert nur mit dem alten Analytics-Trackingcode von Google, ga.js
oder dc.js
. Sie können diese DIL -Funktion nicht aufrufen, wenn Sie analytics.js
verwenden, die die neueste Codebibliothek für Google Universal Analytics ist. Audience Manager -Kunden, die DIL und Universal Analytics verwenden, sollten GA.submitUniversalAnalytics sehen.Funktionssignatur: DIL.modules.GA.init(_gaq, dilInstance, trackVars);
Parameter
_gaq
dilInstance
trackVars
names
besteht. Diese Eigenschaft ist ein Array von GA-Befehlsnamen, die Sie verfolgen möchten.Unterstützte GA-Funktionsaufrufe
Standardmäßig erfasst GA.init
Daten aus den folgenden Funktionen:
_setCustomVar
_addItem
_addTrans
_setAccount
_trackSocial
DIL Erstellt Schlüssel für GA Data
Audience Manager akzeptiert Daten in Form von Schlüssel-Wert-Paaren, während GA mit Elementen in einem Array funktioniert. Um mit GA-Daten zu arbeiten, erstellt DIL automatisch ein Schlüssel-Wert-Paar und bildet einen Schlüssel wie den folgenden: c_ <key name>
. Außerdem werden Elemente in GA-Arrays in einer bestimmten Reihenfolge angezeigt. Daher müssen Sie alle Parameter in dieser Reihenfolge angeben, auch wenn sie keine Daten enthalten. DIL ordnet Schlüssel für die folgenden GA-Methoden zu:
// 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
]);
Beispielcode
// 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
]);
Um alle überwachten GA-Metriken ohne die oben dargestellte zusätzliche Funktion zu verfolgen, rufen Sie GA.init
allein wie folgt auf:
DIL.modules.GA.init(_gaq, dilInstance).submit();
Beispielereignisaufruf
Der URL-Ereignisaufruf an Audience Manager könnte in etwa wie folgt aussehen:
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