DIL-Module dil-modules

WARNING
Ab Juli 2023 hat Adobe die Entwicklung der Erweiterung Data Integration Library (DIL) und der Erweiterung DIL eingestellt.
Bestehende Kunden können weiterhin ihre DIL -Implementierung verwenden. Adobe wird jedoch nicht mehr DIL als bisher entwickeln. Kunden wird empfohlen, das Experience Platform Web SDK für ihre langfristige Datenerfassungsstrategie zu bewerten.
Kunden, die nach Juli 2023 neue Datenerfassungs-Integrationen implementieren möchten, sollten stattdessen das Experience Platform Web SDK verwenden.

Beschreibt Methoden im Namespace DIL.modules . 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.) 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)

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

Parameter

Namen
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 Aufzählungsvariablen Analytics enthalten, wie Props und eVars (z. B. prop1 , prop2 , evar3 , evar4 ).
maxIndex
Ganzzahl
Gibt an, wie viele iterierte Namen Sie zurückgeben möchten. Wenn Sie beispielsweise zwei Eigenschaften oder eVars zurückgeben möchten, legen Sie maxIndex:2 fest.
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.

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

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

  • filterFromContextVariables

    Beispiel: filterFromContextVariables: ['email', 'zip', 'accountNumber'] würde 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 ga-submit-universal-analytics

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.

IMPORTANT
  • Audience Manager hat keine Einblicke in die Google analytics.js-Codebibliothek und hat keine Kontrolle darüber. 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 alten 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 normalerweise standardmäßig ga , 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 zu 'a' geändert wird, rufen Sie GA.submitUniversalAnalytics(); wie folgt auf:

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

Beispiel

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

IMPORTANT
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 die neueste Codebibliothek 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 Eigenschaft 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 Data

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

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