Show Menu
THEMEN×

DIL-Module

Beschreibt Methoden im DIL.modules -Namespace. Mit diesen Modulen können Sie Daten programmgesteuert erfassen und mit Audience Manager-Objekten arbeiten.

siteCatalyst.init

Funktioniert mit DIL dem Senden von Analytics Tag-Elementen (Variablen, Props, eVars usw.) in 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 s.t(); Funktion platzieren.
Parameter
Variablen Typ Beschreibung
names Zeichenfolge
Ein Array von Zeichenfolgen, die nicht aufgezählte Analytics- Variablen wie pageName , channel, campaign , product usw. enthalten.
iteratedNames Objekt
Ein Array von Objekten, das aufgezählte Analytics- Variablen wie props und evars enthält (z. B. prop1 , prop2 , evar3 , evar4 ).
maxIndex Ganzzahl
Gibt an, wie viele iterierte Namen Sie zurückgeben möchten. Um beispielsweise zwei Props oder eVars zurückzugeben, setzen Sie maxIndex:2 .
siteCatalystReportingSuite Objekt
Ein Objekt, das das Analytics- Objekt darstellt.
dilInstance Objekt
Ein Objekt, das DIL darstellt .
options Objekt
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 c_contextData_abc_def=123 resultieren.
    Diese Option ist nur in DIL Version 5.0 oder höher verfügbar.
  • filterFromContextVariables
    Beispiel: filterFromContextVariables: ['email', 'zip', 'accountNumber'] würde dazu führen, dass das Zeichenfolgenarray aus der Datenerfassung von Kontextdaten gefiltert wird. Bei dieser Option werden persönliche identifizierbare Informationen (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 wie folgt auf:
DIL.modules.siteCatalyst.init(s, scDil);

GA.submitUniversalAnalytics

Die GA.submitUniversalAnalytics(); Funktion sendet Daten von Google Universal Analytics an Audience Manager. Diese DIL Funktion ist für die Verwendung mit analytics.js , der neuesten Code-Bibliothek für Google Universal Analytics.
  • Audience Manager hat keinen Einblick in oder Kontrolle über die Google analytics.js -Codebibliothek. Sie sollten überprüfen, ob die DIL Datenerfassung weiterhin funktioniert, wenn oder wenn Google neue Versionen von veröffentlicht analytics.js .
  • Sie können diese Option nicht verwenden, GA.submitUniversalAnalytics(); wenn Sie weiterhin mit dem alten Google Analytics-Trackingcode arbeiten (z. B. ga.js oder dc.js ). Siehe stattdessen GA.init .
**** Funktionssignatur: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);
Eigenschaften
Die GA.submitUniversalAnalytics(); Funktion akzeptiert die folgenden Eigenschaften.
Eigenschaft Beschreibung
gaObject
Die globale Variable für Ihre Instanz von Google Analytics . Dies ist in der Regel ga standardmäßig, es sei denn, Sie haben Ihren Google Analytics- Code angepasst.
dilInstance
Die Variable, die Ihre Instanz von DIL darstellt .
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 in "a"geändert wird , würden Sie GA.submitUniversalAnalytics() aufrufen. wie folgt:
DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');
Beispiel
Denken Sie daran, zuerst das Google Analytics Objekt zu definieren, bevor Sie ga und DIL GA.submitUniversalAnalytics(); . Ihr Code könnte 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

Die GA.init() Funktion sendet Daten aus der veralteten/veralteten Version von an Audience Manager Google Analytics .
GA.init() funktioniert nur mit dem alten Google Analytics-Trackingcode ga.js oder dc.js . Sie können diese DIL Funktion nicht aufrufen, wenn Sie analytics.js die neueste Codebibliothek für Google verwenden Universal Analytics. Audience Manager Kunden, die DILGA.submitUniversalAnalytics verwenden Universal Analytics und sehen sollten .
**** 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
Erfasst standardmäßig Daten aus den folgenden Funktionen: GA.init
  • _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, DIL wird automatisch ein Schlüssel-Wert-Paar erstellt und ein Schlüssel wie der folgende: 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 wie folgt auf:
DIL.modules.GA.init(_gaq, dilInstance).submit();
Beispielereignisaufruf
Der URL-Ereignisaufruf für Audience Manager könnte 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