DIL-Module dil-modules

WARNING
Ab Juli 2023 hat Adobe die Entwicklung des Data Integration Library (DIL) und der DIL eingestellt.
Bestehende Kundinnen und Kunden können ihre DIL Implementierung weiterhin nutzen. Allerdings wird sich Adobe nicht über diesen Punkt hinaus DIL entwickeln. Kunden wird empfohlen, Experience Platform Web SDK auf ihre langfristige Datenerfassungsstrategie hin zu überprüfen.
Kunden, die nach Juli 2023 neue Datenerfassungsintegrationen implementieren möchten, sollten stattdessen Experience Platform Web SDK verwenden.

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

NOTE
Sie müssen diesen Code auf der Seite () der s.t(); platzieren.

Parameter

Namen
Typ
Beschreibung
names
Zeichenfolge
Ein Array von Zeichenfolgen, das nicht aufgezählte Analytics- wie pageName , channel , campaign , product usw. enthält.
iteratedNames
Objekt
Ein Array von Objekten, das Aufzählungen 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- 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.

    Beispielsweise würde s.contextData = {abc.def = '123'} zu einer c_contextData_abc_def=123 in der Abfragezeichenfolge des Ereignisaufrufs führen.

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

  • filterFromContextVariables

    filterFromContextVariables: ['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:

  • 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 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 den Audience Manager. Diese DIL-Funktion wurde für die Verwendung mit analytics.js entwickelt, der neuesten Code-Bibliothek für Google Universal Analytics.

IMPORTANT
  • Audience Manager hat keinen Einblick in die Google analytics.js-Code-Bibliothek und keine Kontrolle über diese. Sie sollten sicherstellen, dass DIL Datenerfassung weiterhin funktioniert, wenn oder wenn Google neue Versionen von analytics.js veröffentlicht.

  • Sie können GA.submitUniversalAnalytics(); nicht verwenden, wenn Sie noch immer mit dem veralteten Analytics-Trackingcode von Google arbeiten (z. B. ga.js oder dc.js). Siehe 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 Google Analytics-. Dies ist in der Regel standardmäßig ga , es sei denn, Sie haben Ihren Google Analytics- angepasst.
dilInstance
Die Variable, die Ihre Instanz DIL- darstellt.
internalPropertyName

(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 den -Audience Manager.

IMPORTANT
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

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

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695