DIL-Module

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

siteCatalyst.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)

HINWEIS

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 Variablen Analytics wie pageName , channel , campaign , product usw. enthalten.

iteratedNames Objekt

Ein Array von Objekten, die aufgezählte Variablen Analytics wie props und evars (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 Objekt Analytics 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.

    s.contextData = {abc.def = '123'} würde z. B. in der Abfrage des Ereignis-Aufrufs c_contextData_abc_def=123 enden.

    Diese Option ist nur in der DIL Version 5.0 oder höher verfügbar.

  • filterFromContextVariables

    filterFromContextVariables: ['email', 'zip', 'accountNumber'] würde zum Beispiel dazu führen, dass das Array von Zeichenfolgen 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 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.

WICHTIG
  • Audience Manager hat keinen Einblick in oder Kontrolle über die Google- analytics.js Codebibliothek. Überprüfen Sie, ob die Datenerfassung weiterhin funktioniert, wenn Google neue Versionen von analytics.js veröffentlicht.DIL

  • Sie können GA.submitUniversalAnalytics(); nicht verwenden, 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 Funktion GA.submitUniversalAnalytics(); akzeptiert die folgenden Eigenschaften.

Eigenschaft Beschreibung

gaObject

Die globale Variable für Ihre Instanz der Google Analytics . Dies ist in der Regel ga , es sei denn, Sie haben Ihren -Google Analytics -Code angepasst.

dilInstance

Die Variable, die Ihre Instanz von DIL darstellt.

internalPropertyName

(Optional) In der analytics.js Bibliothek 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 wurde, würden Sie GA.submitUniversalAnalytics(); wie folgt aufrufen:

DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');

Beispiel

Denken Sie daran, zuerst das Google Analytics ga-Objekt zu definieren, bevor Sie DIL und GA.submitUniversalAnalytics(); aufrufen. 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 Funktion GA.init() sendet Daten aus der veralteten/veralteten Version von Google Analytics an Audience Manager.

WICHTIG

GA.init() funktioniert nur mit dem veralteten 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. Audience Manager Kunden, die DIL GA.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

Standardmäßig erfasst GA.init Daten aus den folgenden Funktionen:

  • _setCustomVar
  • _addItem
  • _addTrans
  • _setAccount
  • _trackSocial

DIL erstellt Tasten für GA-Daten

Audience Manager akzeptiert Daten in Form von Schlüssel-Wert-Paaren, während GA mit Elementen in einem Array funktioniert. Zum Arbeiten mit GA-Daten erstellt DIL automatisch ein Schlüsselwertpaar 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 wie folgt auf:

DIL.modules.GA.init(_gaq, dilInstance).submit();

Beispiel-Ereignis-Aufruf

Der URL-Ereignis-Aufruf an 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

Auf dieser Seite