Adobe Analytics Framework aanpassen customizing-the-adobe-analytics-framework

Het Adobe Analytics-framework bepaalt welke informatie wordt bijgehouden met Adobe Analytics. Als u het standaardframework wilt aanpassen, gebruikt u javascript om aangepaste tracking toe te voegen, Adobe Analytics-plug-ins te integreren en algemene instellingen te wijzigen in het framework dat wordt gebruikt voor bijhouden.

Over de gegenereerde javascript voor Frameworks about-the-generated-javascript-for-frameworks

Wanneer een pagina is gekoppeld aan een Adobe Analytics-framework en de pagina bevat verwijzingen naar de module Analyticswordt er automatisch een bestand analytics.sitecatalyst.js voor de pagina gegenereerd.

Met het javascript op de pagina wordt een s_giobject (dat door de Adobe Analytics-bibliotheek s_code.js wordt gedefinieerd) en waarden worden toegewezen aan de eigenschappen ervan. De naam van de objectinstantie is s. De codevoorbeelden die in deze sectie worden weergegeven, verwijzen naar deze s variabele.

De volgende voorbeeldcode lijkt op de code in het bestand analytics.sitecatalyst.js:

var s_account = "my_sitecatalyst_account";
var s = s_gi(s_account);
s.fpCookieDomainPeriods = "3";
s.currencyCode= 'USD';
s.trackInlineStats= true;
s.linkTrackVars= 'None';
s.charSet= 'UTF-8';
s.linkLeaveQueryString= false;
s.linkExternalFilters= '';
s.linkTrackEvents= 'None';
s.trackExternalLinks= true;
s.linkDownloadFileTypes= 'exe,zip,wav,mp3,mov,mpg,avi,wmv,doc,pdf,xls';
s.linkInternalFilters= 'javascript:,'+window.location.hostname;
s.trackDownloadLinks= true;

s.visitorNamespace = "mynamespace";
s.trackingServer = "xxxxxxx.net";
s.trackingServerSecure = "xxxxxxx.net";

/* Plugin Config */
/*
s.usePlugins=false;
function s_doPlugins(s) {
    //add your custom plugin code here
}
s.doPlugins=s_doPlugins;
*/

Wanneer u aangepaste javascript-code gebruikt om het framework aan te passen, wijzigt u de inhoud van dit bestand.

Adobe Analytics-eigenschappen configureren configuring-adobe-analytics-properties

Er zijn een aantal vooraf gedefinieerde variabelen binnen Adobe Analytics die kunnen worden geconfigureerd op een framework​ . ​ De charset, cookieLifetime, currencyCode en trackInlineStats in de Algemene analytische instellingen lijst standaard.

U kunt namen en waarden van variabelen aan de lijst toevoegen. Deze vooraf gedefinieerde variabelen en alle variabelen die u toevoegt, worden gebruikt om de eigenschappen van de s in het bestand analytics.sitecatalyst.js. In het volgende voorbeeld wordt getoond hoe de toegevoegde prop10 eigenschap of value CONSTANT wordt vertegenwoordigd in de javascript-code:

var s_account = "my_sitecatalyst_account";
var s = s_gi(s_account);
s.fpCookieDomainPeriods = "3";
s.currencyCode= 'USD';
s.trackInlineStats= true;
s.linkTrackVars= 'None';
s.charSet= 'UTF-8';
s.linkLeaveQueryString= false;
s.linkExternalFilters= '';
s.linkTrackEvents= 'None';
s.trackExternalLinks= true;
s.linkDownloadFileTypes= 'exe,zip,wav,mp3,mov,mpg,avi,wmv,doc,pdf,xls';
s.prop10= 'CONSTANT';
s.linkInternalFilters= 'javascript:,'+window.location.hostname;
s.trackDownloadLinks= true;

s.visitorNamespace = "mynamespace";
s.trackingServer = "xxxxxxx.net";
s.trackingServerSecure = "xxxxxxx.net";

Gebruik de volgende procedure om variabelen aan de lijst toe te voegen:

Aangepaste javascript toevoegen aan een Adobe Analytics Framework adding-custom-javascript-to-an-adobe-analytics-framework

De javascript-vakken 'free-from' in het dialoogvenster Algemene analytische instellingen kunt u aangepaste code toevoegen aan een Adobe Analytics-framework.

De code die u toevoegt, wordt toegevoegd aan het bestand analytics.sitecatalyst.js. Daarom kunt u tot s variabele, die een instantie is van de s_gi javascript-object dat is gedefinieerd in s_code.js. Het toevoegen van de volgende code is bijvoorbeeld gelijk aan het toevoegen van een variabele met de naam prop10 van waarde CONSTANT, wat het voorbeeld is in de vorige sectie:

s.prop10= 'CONSTANT';

De code in de analytics.sitecatalyst.js bestand (dat de inhoud van de Adobe Analytics bevat) s-code.js bestand) bevat de volgende code:

if (s.usePlugins) s.doPlugins(s)

De volgende procedure laat zien hoe u het vak javascript kunt gebruiken om het bijhouden van Adobe Analytics aan te passen. Als uw javascript Adobe Analytics-plug-ins moet gebruiken, integreren, in AEM.

In het volgende voorbeeld worden de gegevens die op een pagina in hiërarchische volgorde zijn vastgelegd, samengevoegd met een algemeen scheidingsteken "|".

Een Adobe Analytics-framework heeft de volgende configuraties:

De volgende waarden worden bijvoorbeeld gegenereerd in Adobe Analytics:

Global Custom Code toevoegen voor alle Adobe Analytics-frameworks adding-global-custom-code-for-all-adobe-analytics-frameworks

Aangepaste javascript-code opgeven die in alle Adobe Analytics-frameworks is geïntegreerd. Wanneer het Adobe Analytics-framework van een pagina geen aangepaste inhoud bevat javascript met vrije vorm, wordt het javascript dat door het script /libs/cq/analytics/components/sitecatalyst/config.js.jsp wordt gegenereerd, toegevoegd aan het analytics.sitecatalyst.js bestand. Het script heeft standaard geen effect omdat het geen opmerkingen bevat. De codesets s.usePlugins tot false:

/* Plugin Config */
/*
s.usePlugins=false;
function s_doPlugins(s) {
    //add your custom plugin code here
}
s.doPlugins=s_doPlugins;
*/

De code in het bestand analytics.sitecatalyst.js (die de inhoud van het bestand s_code.js van Adobe Analytics bevat) bevat de volgende code:

als (s.usePlugins) s.doPlugins

Uw javascript moet daarom worden ingesteld s.usePlugins tot true zodat de code in de s_doPlugins functie wordt uitgevoerd. Als u de code wilt aanpassen, bedekt u het bestand config.js.jsp met een bestand dat uw eigen javascript gebruikt. Als uw javascript Adobe Analytics-plug-ins moet gebruiken, integreren, in AEM.

Adobe Analytics-plug-ins in AEM gebruiken using-adobe-analytics-plugins-in-aem

Vraag de javascript-code voor Adobe Analytics-plug-ins aan en integreer deze in AEM in uw Adobe Analytics-framework. De code toevoegen aan een clientbibliotheekmap van de categorie sitecatalyst.plugins zodat deze beschikbaar zijn voor uw aangepaste javascript-code.

Als u bijvoorbeeld de getQueryParams insteekmodule kunt u de insteekmodule vanuit de s_doPlugins functie van uw aangepaste javascript. De volgende voorbeeldcode verzendt de queryreeks in "pid" van de URL van de verwijzende als eVar1, wanneer een Adobe Analytics-aanroep wordt geactiveerd.

s.usePlugins=true;
function s_doPlugins(s) {
   // take the query string from the referrer
   s.eVar1=s.getQueryParam('pid','',document.referrer);
}
s.doPlugins=s_doPlugins;

AEM installeert de volgende Adobe Analytics-plug-ins, zodat deze standaard beschikbaar zijn:

De clientbibliotheekmap /libs/cq/analytics/clientlibs/sitecatalyst/plugins bevat deze plug-ins in de categorie sitecatalyst.plugins.

Gebruik de volgende procedure om de map met de clientbibliotheek voor uw plug-ins te maken. U hoeft deze procedure slechts eenmaal uit te voeren. Gebruik de volgende procedure om een plug-in toe te voegen aan de map met clientbibliotheken.

Gebruik de volgende procedure om de insteekmodulecode op te halen, de code op te slaan in de AEM opslagplaats en de code toe te voegen aan de map met de clientbibliotheek.