DIL-modules dil-modules

WARNING
Vanaf juli 2023 heeft Adobe de ontwikkeling van de extensie Data Integration Library (DIL) en DIL stopgezet.
Bestaande klanten kunnen hun DIL -implementatie blijven gebruiken. Adobe ontwikkelt DIL echter niet verder dan dit punt. De klanten worden aangemoedigd om SDK van het Web van Experience Platformvoor hun lange termijn strategie van de gegevensinzameling te evalueren.
De klanten die nieuwe integratie van de gegevensinzameling na Juli 2023 willen uitvoeren zouden SDK van het Web van Experience Platformin plaats daarvan moeten gebruiken.

Beschrijft methodes in DIL.modules namespace. Met deze modules kunt u programmatisch gegevens verzamelen en werken met Audience Manager-objecten.

siteCatalyst.init sitecat-init

Werkt met DIL om Analytics -tag-elementen (variabelen, eigenschappen, eVars, enz.) naar Audience Manager te verzenden. Retourneert gegevens in een door komma's gescheiden lijst. Beschikbaar in versie 2.6.

de Handtekening van de Functie: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)

NOTE
U moet deze code op de pagina vóór plaatsen de s.t(); functie.

Parameters

Namen
Type
Beschrijving
names
String
Een array van tekenreeksen die niet-opgesomde Analytics -variabelen zoals pageName , channel , campaign , product , enz. bevat.
iteratedNames
Object
Een array met objecten die opgesomde Analytics -variabelen zoals props en evars (bijvoorbeeld prop1 , prop2 , evar3 , evar4 ) bevat.
maxIndex
Geheel
Geeft aan hoeveel herhaalde namen u wilt retourneren. Stel maxIndex:2 in als u bijvoorbeeld twee stappen of gebeurtenissen wilt retourneren.
siteCatalystReportingSuite
Object
Een object dat het object Analytics vertegenwoordigt.
dilInstance
Object
Een object dat DIL vertegenwoordigt.
options
Object

Aanvullende opties:

  • replaceContextDataPeriodsWith

    Als u niets anders opgeeft, worden punten vervangen door het standaardonderstrepingsteken ( _ ).

    s.contextData = {abc.def = '123'} resulteert bijvoorbeeld in c_contextData_abc_def=123 in de queryreeks voor de gebeurtenisaanroep.

    Deze optie is alleen beschikbaar in DIL versie 5.0 of hoger.

  • filterFromContextVariables

    filterFromContextVariables: ['email', 'zip', 'accountNumber'] resulteert bijvoorbeeld in het filteren van de array van tekenreeksen uit de gegevensverzameling van contextgegevens. Deze optie sluit Persoonlijke identificeerbare informatie (PII) uit.

Gegevens die door siteCatalyst.init worden gevangen

Deze functie retourneert details over de volgende Analytics -eigenschappen:

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

Code van de Steekproef

Met deze code maakt u een door komma's gescheiden lijst met Analytics -gebeurtenissen (eigenschappen, variabelen, enzovoort) als er waarden voor bestaan.

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

Als u alle gecontroleerde gegevenspunten van Analytics wilt bijhouden zonder de extra functie die hierboven wordt weergegeven, roept u siteCatalyst.init op als volgt:

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

GA.submitUniversalAnalytics ga-submit-universal-analytics

De functie GA.submitUniversalAnalytics(); verzendt gegevens van Google Universal Analytics naar Audience Manager. Deze functie DIL is ontworpen om te werken met analytics.js , de nieuwste codebibliotheek voor Google Universal Analytics .

IMPORTANT
  • Audience Manager heeft geen insight in of controle over de Google analytics.js -codebibliotheek. Controleer of de gegevensverzameling van DIL nog steeds werkt als of wanneer Google nieuwe versies van analytics.js publiceert.

  • U kunt GA.submitUniversalAnalytics(); niet gebruiken als u nog steeds werkt met code voor het bijhouden van Google-analyses (bijvoorbeeld ga.js of dc.js ). Zie GA.initin plaats daarvan.

de Handtekening van de Functie: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);

Eigenschappen

De functie GA.submitUniversalAnalytics(); accepteert de volgende eigenschappen.

Eigenschap
Beschrijving
gaObject
De algemene variabele voor uw instantie van Google Analytics . Dit is doorgaans ga standaard, tenzij u uw Google Analytics -code hebt aangepast.
dilInstance
De variabele die uw instantie van DIL vertegenwoordigt.
internalPropertyName

(Optioneel) In de analytics.js -bibliotheek is de interne eigenschap de geminificeerde variabele 'b' . Deze variabele bevat Google Analytics -gegevens.

Deze eigenschap is optioneel omdat u deze alleen hoeft in te stellen als Google de naam van de interne variabele wijzigt. Als deze geminificeerde variabele bijvoorbeeld is gewijzigd in 'a' , roept u GA.submitUniversalAnalytics(); als volgt aan:

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

Voorbeeld

Denk eraan het object Google Analytics ga eerst te definiëren voordat u DIL en GA.submitUniversalAnalytics(); aanroept. Uw code kan er ongeveer als volgt uitzien:

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

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

GA.init ga-init

De functie GA.init() verzendt gegevens van de verouderde/vervangen versie van Google Analytics naar Audience Manager.

IMPORTANT
GA.init() werkt alleen met code ga.js of dc.js voor het bijhouden van analyses van Google. U kunt deze DIL functie niet aanroepen als u analytics.js gebruikt, de nieuwste codebibliotheek voor Google Universal Analytics . Audience Manager klanten die DIL en Universal Analytics gebruiken zouden GA.submitUniversalAnalyticsmoeten zien.

de Handtekening van de Functie: DIL.modules.GA.init(_gaq, dilInstance, trackVars);

Parameters

Naam
Type
Beschrijving
_gaq
Array
Een array die GA-opdrachten bevat.
dilInstance
Object
Een object dat de DIL-instantie bevat.
trackVars
Object
(Facultatief) Een voorwerp dat uit het names bezit bestaat. Deze eigenschap is een array van GA-opdrachtnamen die u wilt bijhouden.

Ondersteunde vraag van de Functie GA

Standaard legt GA.init gegevens van de volgende functies vast:

  • _setCustomVar
  • _addItem
  • _addTrans
  • _setAccount
  • _trackSocial

DIL creeert Sleutels voor Gegevens GA

Audience Manager accepteert gegevens in de vorm van sleutelwaardeparen, terwijl GA werkt met items in een array. Als u met GA-gegevens wilt werken, maakt DIL automatisch een sleutelwaardepaar en vormt dit een sleutel als deze: c_ <key name> . Items in GA-arrays worden ook in een specifieke volgorde weergegeven. Dit betekent dat u alle parameters in die volgorde moet opgeven, zelfs als deze geen gegevens bevatten. DIL wijst sleutels voor de volgende methodes GA in kaart:

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

Code van de Steekproef

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

Als u alle bewaakte GA-meetgegevens wilt bijhouden zonder de hierboven weergegeven extra functie, roept u GA.init als volgt aan:

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

Vraag van de Gebeurtenis van de Steekproef

De URL-gebeurtenisaanroep naar Audience Manager kan er als volgt uitzien:

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