Gedeelde modules voor de extensie Adobe Analytics

De Adobe Analytics-extensie biedt twee verschillende gedeelde modules dat u kunt integreren in uw ervaringstoepassing. Deze modules worden behandeld in de onderstaande secties.

get-tracker

Voordat Adobe Analytics bakens verzendt, moet het het tracker-object initialiseren. Het initialisatieproces begint met het laden AppMeasurement, gevolgd door het maken van een tracker-object.

U kunt het tracker-object openen nadat het volledig is geïnitialiseerd met de opdracht get-tracker gedeelde module, als volgt:

var getTracker = turbine.getSharedModule('adobe-analytics', 'get-tracker');

getTracker().then(function(tracker) {
  // Use tracker in some way
});

Controleren of Adobe Analytics is geïnstalleerd

Het is mogelijk dat Adobe Analytics niet is geïnstalleerd of opgenomen in dezelfde tagbibliotheek als uw extensie. Daarom wordt u ten zeerste aangeraden deze kwestie in uw code te controleren en deze op de juiste manier af te handelen. Het volgende JavaScript is een voorbeeld van hoe u dit kunt implementeren:

var getTracker = turbine.getSharedModule('adobe-analytics', 'get-tracker');

if (getTracker) {
  getTracker().then(function(tracker) {
    // Use tracker in some way
  });
} else {
  turbine.logger.error("The Adobe Analytics extension is required for Extension XYZ to function properly.");
}

Indien getTracker is undefined, bestaat de extensie Adobe Analytics niet in de tagbibliotheek. U kunt het geregistreerde bericht aanpassen om nauwkeurig te wijzen op welke functionaliteit kan worden verloren als Adobe Analytics niet geïnstalleerd is.

augment-tracker

Nadat het tracker-object is geïnitialiseerd, bestaat de volgende stap in het proces uit augmentatie. Met deze stap kan uw extensie de tracker verfraaien met wat nodig is voordat er variabelen zijn toegepast vanuit de Adobe Analytics-extensieconfiguratie of voordat er bakens zijn verzonden.

Bovendien heeft uw extensie de mogelijkheid om het initialisatieproces van de tracker te pauzeren terwijl uw extensie een eigen asynchrone taak uitvoert, zoals het ophalen van gegevens of JavaScript van een server.

U kunt de augment-tracker op deze manier:

var augmentTracker = turbine.getSharedModule('adobe-analytics', 'augment-tracker');

augmentTracker(function(tracker) {
  // Augment tracker in some way
});

De functie die wordt doorgegeven aan augmentTracker() wordt aangeroepen zodra de augmentatiefase van het initialisatieproces van de tracker is bereikt.

Als uw extensie een asynchrone taak moet voltooien voordat de tracker wordt uitgebreid, kunt u als volgt een promise van uw functie retourneren:

var Promise = require('@adobe/reactor-promise');
var augmentTracker = turbine.getSharedModule('adobe-analytics', 'augment-tracker');

augmentTracker(function(tracker) {
  return new Promise(function(resolve) {
    // Augment the tracker object, then call resolve()
  });
});

Door een belofte terug te keren, signaleert uw uitbreiding aan Adobe Analytics dat het het volgaarinitialiseringsproces zou moeten pauzeren tot de belofte wordt opgelost.