Moduler DIL dil-modules

WARNING
Från och med juli 2023 har Adobe upphört med utvecklingen av tillägget Data Integration Library (DIL) och DIL.
Befintliga kunder kan fortsätta använda sin DIL-implementering. Adobe kommer dock inte att utveckla DIL efter den här punkten. Kunder uppmuntras att utvärdera Experience Platform Web SDK för sin långsiktiga datainsamlingsstrategi.
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 namnområdet DIL.modules. Med dessa moduler kan du programmässigt samla in data och arbeta med Audience Manager-objekt.

siteCatalyst.init sitecat-init

Fungerar med DIL för att 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 den här koden på sidan före funktionen s.t();.

Parametrar

Namn
Typ
Beskrivning
names
Sträng
En matris med strängar som innehåller ouppräknade Analytics -variabler som pageName , channel , campaign , product osv.
iteratedNames
Objekt
En array med objekt som innehåller uppräknade Analytics -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å avhandlingar eller varv anger du maxIndex:2 .
siteCatalystReportingSuite
Objekt
Ett objekt som representerar objektet Analytics .
dilInstance
Objekt
Ett objekt som representerar DIL .
options
Objekt

Ytterligare alternativ:

  • replaceContextDataPeriodsWith

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

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

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

  • filterFromContextVariables

    filterFromContextVariables: ['email', 'zip', 'accountNumber'] skulle till exempel resultera 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
        }]
});

Om du vill spåra alla övervakade Analytics-datapunkter utan den tilläggsfunktion som visas ovan, anropar du siteCatalyst.init separat så här:

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

GA.submitUniversalAnalytics ga-submit-universal-analytics

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

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

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

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

Egenskaper

Funktionen GA.submitUniversalAnalytics(); 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 din Google Analytics -kod.
dilInstance
Variabeln som representerar din instans av DIL .
internalPropertyName

(Valfritt) I biblioteket analytics.js är egenskapen internal den minifierade variabeln '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' anropar du GA.submitUniversalAnalytics(); så här:

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

Exempel

Kom ihåg att definiera objektet Google Analytics ga först, innan du anropar 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

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

IMPORTANT
GA.init() fungerar bara med Google äldre analytikspårningskod, ga.js eller dc.js. Du kan inte anropa den här DIL-funktionen 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 läsa 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 egenskapen names. Den här egenskapen är en array med GA-kommandonamn som du vill spåra.

GA-funktionsanrop som stöds

Som standard hämtar GA.init 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. Om du vill arbeta med GA-data skapar DIL automatiskt ett nyckelvärdepar och skapar en nyckel som den här: 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 separat så här:

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