Beschreibt Methoden im Namespace DIL.modules
. Mit diesen Modulen können Sie Daten programmgesteuert erfassen und mit Audience Manager-Objekten arbeiten.
Funktioniert mit DIL zum Senden von Analytics Tag-Elementen (Variablen, Props, eVars usw.) 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)
Sie müssen diesen Code auf der Seite vor der Funktion s.t();
platzieren.
Parameter
Variablen | Typ | Beschreibung |
---|---|---|
names |
Zeichenfolge | Ein Array von Zeichenfolgen, die nicht aufgezählte Analytics -Variablen wie |
iteratedNames |
Objekt | Ein Array von Objekten, die Auflistungsvariablen Analytics wie Props und eVars (z. B. |
maxIndex |
Ganzzahl | Gibt an, wie viele iterierte Namen Sie zurückgeben möchten. Um beispielsweise zwei Eigenschaften oder eVars zurückzugeben, legen Sie |
siteCatalystReportingSuite |
Objekt | Ein Objekt, das das Analytics -Objekt darstellt. |
dilInstance |
Objekt | Ein Objekt, das DIL darstellt. |
options |
Objekt | Zusätzliche Optionen:
|
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);
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 Code-Bibliothek für Google Universal Analytics.
Audience Manager hat keine Einblicke in die Google- analytics.js
Codebibliothek oder deren Kontrolle. Sie sollten sicherstellen, dass die DIL-Datenerfassung weiterhin funktioniert, wenn oder wenn Google neue Versionen von analytics.js
veröffentlicht.
Sie können GA.submitUniversalAnalytics();
nicht verwenden, wenn Sie weiterhin mit dem veralteten Analytics-Trackingcode von Google arbeiten (z. B. ga.js
oder dc.js
). Siehe stattdessen GA.init .
Funktionssignatur: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Eigenschaften
Die Funktion GA.submitUniversalAnalytics();
akzeptiert die folgenden Eigenschaften.
Eigenschaft | Beschreibung |
---|---|
|
Die globale Variable für Ihre Instanz von Google Analytics . Dies ist in der Regel |
|
Die Variable, die Ihre Instanz von DIL darstellt. |
|
(Optional) In der 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 |
Beispiel
Denken Sie daran, zuerst 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);
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 neueste Codebibliothek für Google Universal Analytics ist. Audience Manager -Kunden, die DIL und Universal Analytics sollten GA.submitUniversalAnalytics sehen.
Funktionssignatur: DIL.modules.GA.init(_gaq, dilInstance, trackVars);
Parameter
Name | Typ | Beschreibung |
---|---|---|
_gaq |
Array | Ein Array, das GA-Befehle enthält. |
dilInstance |
Objekt | Ein Objekt, das die DIL-Instanz enthält. |
trackVars |
Objekt | (Optional) Ein Objekt, das aus der names Eigenschaft 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 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