Anpassen des Adobe Analytics-Frameworks customizing-the-adobe-analytics-framework

Das Adobe Analytics-Framework bestimmt die Informationen, die mit Adobe Analytics verfolgt werden. Um das Standard-Framework anzupassen, können Sie mit JavaScript benutzerdefiniertes Tracking hinzufügen, Adobe Analytics-Plug-ins integrieren und die allgemeinen Einstellungen in dem zum Tracking genutzten Framework ändern.

Über das generierte JavaScript für Frameworks about-the-generated-javascript-for-frameworks

Wenn eine Seite mit einem Adobe Analytics-Framework verknüpft ist und die Seite Verweise auf das Analytics-Modul enthält, wird automatisch die Datei „analytics.sitecatalyst.js“ für diese Seite erstellt.

Das JavaScript auf der Seite erstellt ein s_gi-Objekt (das die s_code.js-Adobe Analytics-Bibliothek definiert) und weist seinen Eigenschaften Werte zu. Der Name der Objektinstanz ist s. Die Code-Beispiele, die in diesem Abschnitt gezeigt werden, verweisen häufiger auf diese s-Variable.

Der folgende Beispiel-Code ähnelt dem Code in der Datei 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;
*/

Wenn Sie das Framework mit benutzerdefiniertem JavaScript-Code anpassen, ändern Sie den Inhalt dieser Datei.

Konfigurieren von Adobe Analytics-Eigenschaften configuring-adobe-analytics-properties

Es gibt verschiedene vordefinierte Variablen in Adobe Analytics, die in einem Framework konfigurierbar sind. Die Variablen charset, cookieLifetime, currencyCode und trackInlineStats sind standardmäßig in der Liste Allgemeine Analytics-Einstellungen enthalten.

Sie können Variablennamen und -werte zur Liste hinzufügen. Diese vordefinierten Variablen und alle Variablen, die Sie hinzufügen, werden für die Konfiguration der Eigenschaften des s-Objekts in der Datei analytics.sitecatalyst.js verwendet. Das folgende Beispiel zeigt, wie die hinzugefügte Eigenschaft prop10 mit dem Wert CONSTANT im JavaScript-Code dargestellt wird:

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

Mit dem folgenden Verfahren können Sie Variablen zur Liste hinzufügen:

Hinzufügen von benutzerdefiniertem JavaScript zu einem Adobe Analytics-Framework adding-custom-javascript-to-an-adobe-analytics-framework

Im Freiform-JavaScript-Feld des Bereichs Allgemeine Analytics-Einstellungen können Sie benutzerdefinierten Code zu einem Adobe Analytics-Framework hinzufügen.

Der Code, den Sie hinzufügen, wird an die Datei analytics.sitecatalyst.js angehängt. Daher können Sie auf die s-Variable zugreifen, die eine Instanz des in s_code.js definierten JavaScript-Objekts s_gi ist. Wenn Sie beispielsweise den folgenden Code hinzufügen, entspricht dies dem Hinzufügen einer Variable namens prop10 mit dem Wert CONSTANT (das Beispiel aus dem vorhergehenden Abschnitt):

s.prop10= 'CONSTANT';

Der Code in der Datei analytics.sitecatalyst.js (die auch den Inhalt der Adobe Analytics-Datei s-code.js umfasst) enthält die folgende Code-Zeile:

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

Das folgende Verfahren zeigt, wie Sie über das JavaScript-Feld das Adobe Analytics-Tracking anpassen können. Wenn Ihr JavaScript Adobe Analytics-Plug-ins benötigt, integrieren Sie sie in AEM.

Beim folgenden Beispiel werden die auf einer Seite erfassten Daten in hierarchischer Reihenfolge verbunden. Dabei wird das gemeinsame Trennzeichen „|“ genutzt.

Ein Adobe Analytics-Framework weist die folgenden Konfigurationen auf:

Beispielsweise werden die folgenden Werte in Adobe Analytics erzeugt:

Hinzufügen von globalem benutzerdefinierten Code für alle Adobe Analytics-Frameworks adding-global-custom-code-for-all-adobe-analytics-frameworks

Geben Sie benutzerdefinierten JavaScript-Code ein, der in alle Adobe Analytics-Frameworks integriert wird. Wenn das Adobe Analytics-Framework einer Seite kein benutzerdefiniertes Freiform-JavaScript enthält, wird das vom Skript /libs/cq/analytics/components/sitecatalyst/config.js.jsp erzeugte JavaScript zur Datei analytics.sitecatalyst.js hinzugefügt. Standardmäßig hat das Skript keine Wirkung, da es auskommentiert ist. Zusätzlich legt der Code s.usePlugins auf false fest:

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

Der Code in der Datei analytics.sitecatalyst.js (die auch den Inhalt der Adobe Analytics-Datei umfasst) enthält die folgende Code-Zeile:

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

Daher sollte Ihr JavaScript s.usePlugins auf true festlegen, damit jeder Code in der Funktion s_doPlugins ausgeführt wird. Um den Code anzupassen, überlagern Sie die Datei config.js.jsp mit einer Datei, die Ihr eigenes JavaScript nutzt. Wenn Ihr JavaScript Adobe Analytics-Plug-ins benötigt, integrieren Sie sie in AEM.

Verwenden von Adobe Analytics-Plug-ins in AEM using-adobe-analytics-plugins-in-aem

Beschaffen Sie sich den JavaScript-Code für Adobe Analytics-Plug-ins und integrieren Sie sie in das Adobe Analytics-Framework in AEM. Fügen Sie den Code zu einem Client-Bibliotheksordner der Kategorie sitecatalyst.plugins hinzu, damit sie für den angepassten JavaScript-Code verfügbar sind.

Wenn Sie beispielsweise das Plug-in getQueryParams integrieren, können Sie dieses Plug-in über die Funktion s_doPlugins des angepassten JavaScripts aufrufen. Der folgende Beispiel-Code sendet die Abfragezeichenfolge in "pid" von der Referrer-URL als eVar1, wenn ein Adobe Analytics-Aufruf ausgelöst wird.

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 installiert die folgenden Adobe Analytics-Plug-ins, sodass sie standardmäßig zur Verfügung stehen:

Der Client-Bibliotheksordner /libs/cq/analytics/clientlibs/sitecatalyst/plugins enthält diese Plug-ins in der Kategorie sitecatalyst.plugins.

Mit dem folgenden Verfahren können Sie den Client-Bibliotheksordner für Ihre Plug-ins erstellen.  Sie müssen diesen Vorgang nur einmal durchführen.  Über das darauffolgende Verfahren können Sie ein Plug-in zum Client-Bibliotheksordner hinzufügen.

Mit dem folgenden Verfahren können Sie sich den Plug-in-Code beschaffen, den Code im AEM-Repository speichern und den Code zu Ihrem Client-Bibliotheksordner hinzufügen.