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 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
namespageName , channel , campaign , product usw. enthält.iteratedNamesprop1 , prop2 , evar3 , evar4 ).maxIndexmaxIndex:2 .siteCatalystReportingSuitedilInstanceoptionsZusätzliche Optionen:
-
replaceContextDataPeriodsWithWenn 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=123in der Abfragezeichenfolge des Ereignisaufrufs führen.Diese Option ist nur in DIL Version 5.0 oder höher verfügbar.
-
filterFromContextVariablesfilterFromContextVariables: ['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:
pageNamechannelcampaignproductseventseVar(1 - 250)prop(1 - 75)pepev1pev2pev3
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 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 keine insight in oder Kontrolle über die Google
analytics.js-Code-Bibliothek. Sie sollten sicherstellen, dass DIL Datenerfassung weiterhin funktioniert, wenn oder wenn Google neue Versionen vonanalytics.jsveröffentlicht. -
Sie können
GA.submitUniversalAnalytics();nicht verwenden, wenn Sie noch immer mit dem veralteten Analytics-Trackingcode von Google arbeiten (z. B.ga.jsoderdc.js). Siehe GA.init.
Funktionssignatur: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Eigenschaften
Die GA.submitUniversalAnalytics();-Funktion akzeptiert die folgenden Eigenschaften.
gaObjectga , es sei denn, Sie haben Ihren Google Analytics- angepasst.dilInstanceinternalPropertyName(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 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
_gaqdilInstancetrackVarsnames 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 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