DIL-Module dil-modules
Beschreibt die Methoden im DIL.modules
Namespace. 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.) an den Audience Manager zu senden. 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. enthält.iteratedNames
prop1
, prop2
, evar3
, evar4
).maxIndex
maxIndex:2
.siteCatalystReportingSuite
dilInstance
options
Zusätzliche Optionen:
-
replaceContextDataPeriodsWith
Wenn Sie nichts anderes angeben, werden Punkte durch den standardmäßigen Unterstrich ( _ ) ersetzt.
Beispielsweise würde
s.contextData = {abc.def = '123'}
zu einerc_contextData_abc_def=123
in der Abfragezeichenfolge des Ereignisaufrufs führen.Diese Option ist nur in DIL Version 5.0 oder höher verfügbar.
-
filterFromContextVariables
filterFromContextVariables: ['email', 'zip', 'accountNumber']
würde beispielsweise dazu führen, dass das Zeichenfolgen-Array aus der Datenerfassung der Kontextdaten gefiltert würde. Diese Option schließt personenbezogene Daten (PII) aus.
Von siteCatalyst.init erfasste Daten
Diese Funktion gibt Details zu den folgenden Analytics 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 ohne die oben dargestellte zusätzliche Funktion zu verfolgen, rufen Sie siteCatalyst.init
wie folgt selbst auf:
DIL.modules.siteCatalyst.init(s, scDil);
GA.submitUniversalAnalytics ga-submit-universal-analytics
Die GA.submitUniversalAnalytics();
sendet Daten aus der Universal Analytics von Google an den Audience Manager. Diese DIL-Funktion wurde für die Verwendung mit analytics.js
entwickelt, der neuesten Code-Bibliothek für Google Universal Analytics.
-
Audience Manager hat keinen Einblick in die Google
analytics.js
-Code-Bibliothek und keine Kontrolle über diese. Sie sollten sicherstellen, dass DIL Datenerfassung weiterhin funktioniert, wenn oder wenn Google neue Versionen vonanalytics.js
veröffentlicht. -
Sie können
GA.submitUniversalAnalytics();
nicht verwenden, wenn Sie noch immer mit dem veralteten Analytics-Trackingcode von Google arbeiten (z. B.ga.js
oderdc.js
). Siehe GA.init.
Funktionssignatur: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Eigenschaften
Die GA.submitUniversalAnalytics();
-Funktion akzeptiert die folgenden Eigenschaften.
gaObject
ga
, es sei denn, Sie haben Ihren Google Analytics- angepasst.dilInstance
internalPropertyName
(Optional) In der analytics.js
-Bibliothek ist die interne Eigenschaft die minimierte Variable 'b'
. Diese Variable enthält Google Analytics-.
Diese Eigenschaft ist optional, da Sie sie nicht festlegen müssen, es sei denn, Google ändert den Namen seiner internen Variablen. Wenn diese minimierte Variable beispielsweise in 'a'
geändert wird, würden Sie GA.submitUniversalAnalytics();
wie folgt aufrufen:
DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');
Beispiel
Denken Sie daran, zunächst das Google Analytics ga
-Objekt 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 GA.init()
sendet Daten aus der veralteten/veralteten Version von Google Analytics an den -Audience Manager.
GA.init()
funktioniert nur mit dem alten Analytics-Trackingcode von Google, ga.js
oder dc.js
. Sie können diese DIL nicht aufrufen, wenn Sie analytics.js
verwenden, die die neueste Code-Bibliothek 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-Daten
Audience Manager akzeptiert Daten in Form von Schlüssel-Wert-Paaren, während GA mit Elementen in einem Array arbeitet. 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 erscheinen Elemente in GA-Arrays in einer bestimmten Reihenfolge. 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
wie folgt selbst auf:
DIL.modules.GA.init(_gaq, dilInstance).submit();
Beispielereignisaufruf
Der URL-Ereignisaufruf an den 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