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

Adobe Analytics-ramverket avgör vilken information som spåras med Adobe Analytics. Om du vill anpassa standardramverket använder du JavaScript för att lägga till anpassad spårning, integrera Adobe Analytics-plugin-program och ändra allmänna inställningar i det ramverk som används för spårning.

Om den genererade JavaScript för ramverk about-the-generated-javascript-for-frameworks

När en sida är kopplad till ett Adobe Analytics-ramverk och sidan innehåller referenser till analysmodulen, genereras automatiskt filen analytics.sitecatalyst.js för sidan.

JavaScript på sidan skapar ett s_gi-objekt (som definieras av Adobe Analytics-biblioteket s_code.js) och tilldelar värden till dess egenskaper. Objektinstansens namn är s. De kodexempel som presenteras i det här avsnittet gör flera referenser till den här s-variabeln.

Följande exempelkod liknar koden i en analytics.sitecatalyst.js-fil:

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;
*/

När du använder anpassad JavaScript-kod för att anpassa ramverket ändrar du innehållet i den här filen.

Konfigurera Adobe Analytics-egenskaper configuring-adobe-analytics-properties

Det finns flera fördefinierade variabler i Adobe Analytics som kan konfigureras i ett ramverk. Variablerna charset, cookieLifetime, currencyCode och trackInlineStats ingår som standard i listan Allmänna analysinställningar .

Du kan lägga till variabelnamn och värden i listan. Dessa fördefinierade variabler och eventuella variabler som du lägger till används för att konfigurera egenskaperna för objektet s i filen analytics.sitecatalyst.js. I följande exempel visas hur den tillagda egenskapen prop10 för värdet CONSTANT representeras i JavaScript-koden:

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";

Använd följande procedur för att lägga till variabler i listan:

Lägga till anpassade JavaScript i en Adobe Analytics Framework adding-custom-javascript-to-an-adobe-analytics-framework

Med den kostnadsfria JavaScript-rutan i området Allmänna analysinställningar kan du lägga till anpassad kod i ett Adobe Analytics-ramverk.

Koden som du lägger till läggs till i filen analytics.sitecatalyst.js. Därför kan du komma åt variabeln s, som är en instans av JavaScript-objektet s_gi som definieras i s_code.js. Att lägga till följande kod motsvarar till exempel att lägga till variabeln prop10 för värdet CONSTANT, vilket är exemplet i föregående avsnitt:

s.prop10= 'CONSTANT';

Koden i filen analytics.sitecatalyst.js (som innehåller innehållet i Adobe Analytics s-code.js -filen) innehåller följande kod:

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

Följande procedur visar hur du använder rutan JavaScript för att anpassa Adobe Analytics tracking. Om din JavaScript behöver använda Adobe Analytics plugin-program kan du integrera dem i AEM.

I följande exempel sammanfogas de data som samlats in på en sida i hierarkisk ordning med hjälp av en gemensam avgränsare (|).

Ett Adobe Analytics-ramverk har följande konfigurationer:

Följande värden genereras till exempel i Adobe Analytics:

Lägga till global anpassad kod för alla Adobe Analytics-ramverk adding-global-custom-code-for-all-adobe-analytics-frameworks

Skapa anpassad JavaScript-kod som är integrerad i alla Adobe Analytics ramverk. När en sidas Adobe Analytics-ramverk inte innehåller någon anpassad JavaScript med valfri form, läggs den JavaScript som genereras av /libs/cq/analytics/components/sitecatalyst/config.js.jsp-skriptet till i filen analytics.sitecatalyst.js . Skriptet har som standard ingen effekt eftersom det kommenteras ut. Koden ställer också in s.usePlugins på false:

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

Koden i filen analytics.sitecatalyst.js (som innehåller innehållet i Adobe Analytics-filen s_code.js) innehåller följande kod:

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

Därför bör din JavaScript ställa in s.usePlugins på true så att all kod i funktionen s_doPlugins körs. Om du vill anpassa koden lägger du över config.js.jsp-filen med en som använder din egen JavaScript. Om din JavaScript behöver använda Adobe Analytics plugin-program kan du integrera dem i AEM.

Använda Adobe Analytics Plugins i AEM using-adobe-analytics-plugins-in-aem

Hämta JavaScript-koden för Adobe Analytics-plugin-program och integrera dem i Adobe Analytics-ramverket i AEM. Lägg till koden i en klientbiblioteksmapp i kategorin sitecatalyst.plugins så att den är tillgänglig för din anpassade JavaScript-kod.

Om du till exempel integrerar plugin-programmet getQueryParams kan du anropa plugin-programmet från funktionen s_doPlugins i din anpassade JavaScript. Följande exempelkod skickar frågesträngen i "pid" från referentens URL som eVar1 när ett Adobe Analytics-anrop utlöses.

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 installerar följande Adobe Analytics-plugin-program så att de är tillgängliga som standard:

Klientbiblioteksmappen /libs/cq/analytics/clientlibs/sitecatalyst/plugins innehåller dessa plugin-program i kategorin sitecatalyst.plugins.

Använd följande procedur för att skapa klientbiblioteksmappen för dina plugin-program. Du behöver bara utföra den här proceduren en gång. Om du vill lägga till ett plugin-program i klientbiblioteksmappen gör du följande.

Använd följande procedur för att hämta plugin-programkoden, lagra koden i AEM och lägga till koden i klientbiblioteksmappen.