DIL-modules dil-modules

WARNING
Vanaf juli 2023 heeft Adobe de ontwikkeling van de Data Integration Library (DIL) en de DIL extensie.
Bestaande klanten kunnen hun DIL uitvoering. Adobe zal zich echter niet ontwikkelen DIL verder dan dit punt. Klanten worden aangemoedigd om te evalueren Experience Platform Web SDK voor hun strategie voor het verzamelen van gegevens op lange termijn.
Klanten die na juli 2023 nieuwe integratie voor gegevensverzameling willen implementeren, moeten Experience Platform Web SDK in plaats daarvan.

Beschrijft methodes in DIL.modules naamruimte. Deze modules laten u programmatically gegevens verzamelen en met de voorwerpen van de Audience Manager werken.

siteCatalyst.init sitecat-init

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

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

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

Parameters

Namen
Type
Beschrijving
names
String
Een array van tekenreeksen die een niet-opsomming bevat Analyse variabelen zoals pageName , channel , campaign , product , enz.
iteratedNames
Object
Een array met objecten die zijn opgesomd Analyse variabelen zoals props en evars (bijvoorbeeld prop1 , prop2 , evar3 , evar4 ).
maxIndex
Geheel
Geeft aan hoeveel herhaalde namen u wilt retourneren. Als u bijvoorbeeld twee voorvertoningen of gebeurtenissen wilt retourneren, stelt u maxIndex:2 .
siteCatalystReportingSuite
Object
Een object dat de Analyse object.
dilInstance
Object
Een object dat DIL .
options
Object

Aanvullende opties:

  • replaceContextDataPeriodsWith

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

    Bijvoorbeeld s.contextData = {abc.def = '123'} zou leiden tot c_contextData_abc_def=123 in de queryreeks voor gebeurtenisoproepen.

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

  • filterFromContextVariables

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

Gegevens vastgelegd door siteCatalyst.init

Deze functie retourneert details over het volgende Analytics eigenschappen:

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

Voorbeeldcode

Deze code maakt een door komma's gescheiden lijst met Analytics gebeurtenissen (props, eVars, enz.) 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
        }]
});

Alle bewaakte Analytics gegevenspunten zonder de hierboven getoonde extra functie, aanhalen siteCatalyst.init op zich :

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

GA.submitUniversalAnalytics ga-submit-universal-analytics

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

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

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

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

Eigenschappen

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

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

(Optioneel) In de analytics.js bibliotheek, is het interne bezit de geminiatuurde variabele 'b' . Deze variabele houdt rekening met 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' , u wilt bellen GA.submitUniversalAnalytics(); als volgt:

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

Voorbeeld

Vergeet niet de Google Analytics ga object eerst, voordat wordt aangeroepen DIL en GA.submitUniversalAnalytics();. 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 GA.init() functie verzendt gegevens van de verouderde/vervangen versie van Google Analytics naar Audience Manager.

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

Functiehandtekening: 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 instantie DIL bevat.
trackVars
Object
(Optioneel) Een object dat bestaat uit de names eigenschap. Deze eigenschap is een array van GA-opdrachtnamen die u wilt bijhouden.

Ondersteunde functieaanroepen GA

Standaard, GA.init vangt gegevens van de volgende functies:

  • _setCustomVar
  • _addItem
  • _addTrans
  • _setAccount
  • _trackSocial

DIL maakt toetsen voor GA-gegevens

Audience Manager accepteert gegevens in de vorm van sleutelwaardeparen, terwijl GA werkt met items in een array. Om met GA-gegevens te werken, DIL maakt automatisch een sleutelwaardepaar en vormt zo een sleutel: 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 kaarttoetsen voor de volgende GA-methoden:

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

Voorbeeldcode

// 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 alle bewaakte GA metriek zonder de extra hierboven getoonde functie te volgen, haal GA.init op zich :

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

Voorbeeld van gebeurtenisoproep

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