DIL-moduler dil-modules

WARNING
Från och med juli 2023 har Adobe upphört med utvecklingen av Data Integration Library (DIL) och DIL tillägg.
Befintliga kunder kan fortsätta använda sina DIL implementering. Adobe kommer dock inte att utvecklas DIL bortom denna punkt. Kunder uppmanas att utvärdera Experience Platform Web SDK för deras långsiktiga strategi för datainsamling.
Kunder som vill implementera integreringar för datainsamling efter juli 2023 bör använda Experience Platform Web SDK i stället.

Beskriver metoder i DIL.modules namnutrymme. Med dessa moduler kan du programmässigt samla in data och arbeta med Audience Manager-objekt.

siteCatalyst.init sitecat-init

Fungerar med DIL skicka Analytics taggelement (variabler, props, eVars osv.) till Audience Manager. Returnerar data i en kommaavgränsad lista. Finns i version 2.6.

Funktionssignatur: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)

NOTE
Du måste placera koden på sidan före den s.t(); funktion.

Parametrar

Namn
Typ
Beskrivning
names
Sträng
En array med strängar som innehåller icke-uppräknade Analyser variabler som pageName , channel , campaign , product , osv.
iteratedNames
Objekt
En array med objekt som innehåller uppräknade Analyser variabler som props och evar (t.ex. prop1 , prop2 , evar3 , evar4 ).
maxIndex
Heltal
Anger hur många itererade namn du vill returnera. Om du till exempel vill returnera två avstavningar eller avstavningar anger du maxIndex:2 .
siteCatalystReportingSuite
Objekt
Ett objekt som representerar Analyser -objekt.
dilInstance
Objekt
Ett objekt som representerar DIL .
options
Objekt

Ytterligare alternativ:

  • replaceContextDataPeriodsWith

    Om du inte anger något annat ersätts punkter med standardunderstrecket ( _ ).

    Till exempel s.contextData = {abc.def = '123'} skulle resultera i c_contextData_abc_def=123 i frågesträngen för händelsanrop.

    Det här alternativet är bara tillgängligt i DIL version 5.0 eller senare.

  • filterFromContextVariables

    Till exempel: filterFromContextVariables: ['email', 'zip', 'accountNumber'] resulterar i att strängarrayen filtreras från datainsamlingen för kontextdata. Det här alternativet utesluter PII (Personally Identiitable Information).

Data som samlats in av siteCatalyst.init

Den här funktionen returnerar information om följande Analytics egenskaper:

  • pageName
  • channel
  • campaign
  • products
  • events
  • eVar (1 - 250)
  • prop (1 - 75)
  • pe
  • pev1
  • pev2
  • pev3

Exempelkod

Den här koden skapar en kommaavgränsad lista med Analytics händelser (props, eVars osv.) om det finns värden för dem.

// 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
        }]
});

För att spåra alla övervakade Analytics datapunkter utan den extra funktion som visas ovan, anropa siteCatalyst.init på det här sättet:

DIL.modules.siteCatalyst.init(s, scDil);

GA.submitUniversalAnalytics ga-submit-universal-analytics

The GA.submitUniversalAnalytics(); funktionen skickar data från Google Universal Analytics till Audience Manager. Detta DIL funktionen är utformad för att fungera med analytics.js, som är det senaste kodbiblioteket för Google Universal Analytics.

IMPORTANT
  • Audience Manager inte har någon insikt i eller kontroll över Google analytics.js kodbibliotek. Du bör verifiera att DIL datainsamlingen fungerar fortfarande om eller när Google släpper nya versioner av analytics.js.

  • Du kan inte använda GA.submitUniversalAnalytics(); om du fortfarande arbetar med Google spårningskod för äldre analyser (t.ex. ga.js eller dc.js). Se GA.init i stället.

Funktionssignatur: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);

Egenskaper

The GA.submitUniversalAnalytics(); funktionen accepterar följande egenskaper.

Egenskap
Beskrivning
gaObject
Den globala variabeln för din instans av Google Analytics . Detta är vanligtvis ga som standard, såvida du inte har anpassat Google Analytics kod.
dilInstance
Variabeln som representerar din instans av DIL .
internalPropertyName

(Valfritt) I analytics.js library, the internal property is the minified variable 'b' . Den här variabeln innehåller Google Analytics data.

Den här egenskapen är valfri eftersom du inte behöver ange den om inte Google ändrar namnet på deras interna variabel. Om den här minifierade variabeln till exempel har ändrats till 'a' ringer du GA.submitUniversalAnalytics(); så här:

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

Exempel

Kom ihåg att definiera Google Analytics ga objekt först, innan anrop DIL och GA.submitUniversalAnalytics();. Koden kan se ut ungefär så här:

//Instantiate DIL
var dilInstance = DIL.create({
     partner:"adobe"
});

//Call the DIL Universal Analytics function
DIL.modules.GA.submitUniversalAnalytics(ga, dilInstance);

GA.init ga-init

The GA.init() funktionen skickar data från den gamla/ersatta versionen av Google Analytics till Audience Manager.

IMPORTANT
GA.init() fungerar bara med Google äldre kod för spårning av analyser, ga.js eller dc.js. Du kan inte anropa detta DIL om du använder analytics.js, som är det senaste kodbiblioteket för Google Universal Analytics. Audience Manager kunder som använder DIL och Universal Analytics bör se GA.submitUniversalAnalytics.

Funktionssignatur: DIL.modules.GA.init(_gaq, dilInstance, trackVars);

Parametrar

Namn
Typ
Beskrivning
_gaq
Array
En array som innehåller GA-kommandon.
dilInstance
Objekt
Ett objekt som innehåller DIL-instansen.
trackVars
Objekt
(Valfritt) Ett objekt som består av names -egenskap. Den här egenskapen är en array med GA-kommandonamn som du vill spåra.

Följande funktionsanrop stöds:

Som standard GA.init hämtar data från följande funktioner:

  • _setCustomVar
  • _addItem
  • _addTrans
  • _setAccount
  • _trackSocial

DIL skapar nycklar för GA-data

Audience Manager accepterar data i form av nyckelvärdepar medan GA arbetar med objekt i en array. För att arbeta med GA-data DIL skapar automatiskt ett nyckelvärdepar och skapar en nyckel som denna: c_ <key name>. Dessutom visas objekt i GA-arrayer i en viss ordning. Därför måste du ange alla parametrar i den ordningen, även om de inte innehåller några data. DIL mappar nycklar för följande GA-metoder:

// 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
]);

Exempelkod

// 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
]);

Om du vill spåra alla övervakade GA-mått utan den ytterligare funktion som visas ovan, anropar du GA.init på det här sättet:

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

Exempel på händelseanrop

URL-händelseanropet till Audience Manager kan se ut ungefär så här:

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