DIL-Module

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

siteCatalyst.init

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)

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

iteratedNames Objekt

Ein Array von Objekten, die Auflistungsvariablen 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 Eigenschaften oder eVars zurückzugeben, legen Sie maxIndex:2 fest.

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.

    s.contextData = {abc.def = '123'} würde beispielsweise in der Abfragezeichenfolge für Ereignisaufrufe c_contextData_abc_def=123 zu führen.

    Diese Option ist nur in DIL Version 5.0 oder neuer verfügbar.

  • filterFromContextVariables

    filterFromContextVariables: ['email', 'zip', 'accountNumber'] würde beispielsweise dazu führen, dass das Array von Zeichenfolgen aus der Datenerfassung von Kontextdaten gefiltert wird. Bei dieser Option werden personenbezogene Daten (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 allein 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 Code-Bibliothek für Google Universal Analytics.

WICHTIG
  • 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

gaObject

Die globale Variable für Ihre Instanz von 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 zu 'a' geändert wird, rufen Sie GA.submitUniversalAnalytics(); wie folgt auf:

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 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

Die Funktion GA.init() sendet Daten aus der veralteten/veralteten Version von Google Analytics an Audience Manager.

WICHTIG

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

Auf dieser Seite