Das Adobe Analytics-Framework bestimmt die Informationen, die mit Adobe Analytics verfolgt werden. Um das Standard-Framework anzupassen, verwenden Sie JavaScript, um benutzerdefiniertes Tracking hinzuzufügen, Adobe Analytics-Plug-ins zu integrieren und allgemeine Einstellungen innerhalb des für das Tracking verwendeten Frameworks zu ändern.
Wenn eine Seite mit einem Adobe Analytics-Framework verknüpft ist und die Seite Verweise auf das Analytics-Modul, wird automatisch eine Datei analytics.sitecatalyst.js für die Seite generiert.
Das JavaScript auf der Seite erstellt eine s_gi
-Objekt (das die Adobe Analytics-Bibliothek s_code.js 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 benutzerdefinierten JavaScript-Code verwenden, um das Framework anzupassen, ändern Sie den Inhalt dieser Datei.
Es gibt mehrere vordefinierte Variablen in Adobe Analytics, die in einem Framework konfiguriert werden können. 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 prop10
Eigenschaft des Werts CONSTANT
wird im JavaScript-Code dargestellt:
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:
Erweitern Sie auf der Adobe Analytics-Framework-Seite den Bereich Allgemeine Analytics-Einstellungen.
Klicken Sie unter der Liste der Variablen auf „Element hinzufügen“, um eine neue Variable zur Liste hinzuzufügen.
Geben Sie in der linken Zelle einen Namenfür die Variable ein, zum Beispiel prop10
.
Geben Sie in der rechten Spalte einen Wertfür die Variable ein, zum Beispiel CONSTANT
.
Um eine Variable zu entfernen, klicken Sie auf die Schaltfläche (-) neben der Variablen.
Stellen Sie bei der Eingabe von Variablen und Werten sicher, dass sie korrekt formatiert und geschrieben sind, oder -Aufrufe werden nicht gesendet mit dem richtigen Wert-/Variablenpaar. Falsch geschriebene Variablen und Werte können sogar Aufrufe verhindern.
Wenden Sie sich an Ihren Adobe Analytics-Support-Mitarbeiter, um sicherzustellen, dass diese Variablen korrekt eingestellt sind.
Einige der Variablen in dieser Liste sind mandatory , damit Adobe Analytics-Aufrufe ordnungsgemäß funktionieren (z. B. currencyCode, charSet)
Selbst wenn diese Variablen vom Framework selbst entfernt werden, werden sie dennoch bei einem Adobe Analytics-Aufruf mit dem Standardwert angehängt.
Das freie JavaScript-Feld im Allgemeine Analytics-Einstellungen -Bereich 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, die eine Instanz der s_gi
JavaScript-Objekt, das in definiert ist s_code.js
. 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 die Verwendung des JavaScript-Felds zur Anpassung des Adobe Analytics-Trackings. Wenn Ihr JavaScript Adobe Analytics-Plug-ins verwenden muss, integrieren AEM.
Fügen Sie dem Feld den folgenden JavaScript-Code hinzu, damit s.doPlugins
ausgeführt wird:
s.usePlugins=true;
function s_doPlugins(s) {
//add your custom code here
}
s.doPlugins=s_doPlugins;
Dieser Code ist erforderlich, wenn Sie Variablen in einem Adobe Analytics-Aufruf senden möchten, die auf eine Weise angepasst wurden, die nicht über die einfache Drag&Drop-Oberfläche ODER über Inline-JavaScript in der Adobe Analytics-Ansicht durchgeführt werden kann.
Wenn die benutzerdefinierten Variablen außerhalb der s_doPlugins-Funktion liegen, werden sie beim Adobe Analytics-Aufruf als * undefined* gesendet.
Fügen Sie Ihren JavaScript-Code im s_doPlugins -Funktion.
Beim folgenden Beispiel werden die auf einer Seite erfassten Daten in hierarchischer Reihenfolge verbunden. Dabei wird das gemeinsame Trennzeichen „|“ genutzt.
Ein Adobe Analytics-Framework verfügt über die folgenden Konfigurationen:
Die Adobe Analytics-Variable prop2
wird der Website-Eigenschaft pagedata.sitesection
zugeordnet.
Die Adobe Analytics-Variable prop3
wird der Website-Eigenschaft pagedata.subsection
zugeordnet.
Der folgende Code wird zum Freie-von-JavaScript-Feld hinzugefügt:
s.usePlugins=true;
function s_doPlugins(s) {
s.prop1 = s.prop2+'|'+s.prop3;
}
s.doPlugins=s_doPlugins;
Wenn die Web-Seite, die das Framework verwendet, aufgerufen wird (oder wenn die Seite im Bearbeitungsmodus neu geladen oder eine Vorschau von ihr angezeigt wird), werden die Aufrufe an Adobe Analytics durchgeführt.
Beispielsweise werden die folgenden Werte in Adobe Analytics erzeugt:
Bereitstellen von benutzerdefiniertem JavaScript-Code, der in alle Adobe Analytics-Frameworks integriert ist. Wenn das Adobe Analytics-Framework einer Seite keine benutzerdefinierten Freiform-JavaScript, wird das vom Skript /libs/cq/analytics/components/sitecatalyst/config.js.jsp generierte JavaScript an die analytics.sitecatalyst.js -Datei. 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
nach true
sodass jeder Code im s_doPlugins
-Funktion ausgeführt wird. Um den Code anzupassen, überlagern Sie die Datei config.js.jsp mit einer Datei, die Ihr eigenes JavaScript verwendet. Wenn Ihr JavaScript Adobe Analytics-Plug-ins verwenden muss, integrieren AEM.
Bearbeiten Sie die Datei /libs/cq/analytics/components/sitecatalyst/config.js.jsp nicht. Bestimmte AEM Upgrade- oder Wartungsaufgaben können die Originaldatei neu installieren und Ihre Änderungen entfernen.
Erstellen Sie in CRXDE Lite die Ordnerstruktur /apps/cq/analytics/components :
cq
fest und klicken Sie auf „OK“.analytics
und components
.Klicken Sie mit der rechten Maustaste auf den Ordner components
, den Sie gerade erstellt haben, und klicken Sie auf „Erstellen“ > „Komponente erstellen“. Legen Sie die folgenden Eigenschaftswerte fest:
sitecatalyst
sitecatalyst
/libs/cq/analytics/components/sitecatalyst
hidden
Klicken Sie mehrfach auf „Weiter“, bis die Schaltfläche „OK“ aktiviert wird, und klicken Sie dann auf „OK“.
Die SiteCatalyst-Komponente enthält die automatisch erstellte Datei sitecatalyst.jsp.
Klicken Sie mit der rechten Maustaste auf die Datei sitecatalyst.jsp und klicken Sie dann auf „Löschen“.
Klicken Sie mit der rechten Maustaste auf die SiteCatalyst-Komponente und klicken Sie auf „Erstellen“ > „Datei erstellen“. Legen Sie den Namen config.js.jsp
fest und klicken Sie dann auf „OK“.
Die Datei config.js.jsp wird automatisch zur Bearbeitung geöffnet.
Fügen Sie den folgenden Text zur Datei hinzu und klicken Sie auf „Alle speichern“:
<%@page session="true"%>
/* Plugin Config */
s.usePlugins=true;
function s_doPlugins(s) {
//add your custom plugin code here
}
s.doPlugins=s_doPlugins;
Der JavaScript-Code, den das Skript /apps/cq/analytics/components/sitecatalyst/config.js.jsp generiert, wird jetzt für alle Seiten, die ein Adobe Analytics-Framework verwenden, in die Datei analytics.sitecatalyst.js eingefügt.
Fügen Sie den JavaScript-Code hinzu, den Sie im s_doPlugins
und klicken Sie dann auf Alle speichern.
Wenn Text im Freiform-JavaScript des Frameworks einer Seite vorhanden ist (auch nur Leerzeichen), wird config.js.jsp ignoriert.
Rufen Sie den JavaScript-Code für Adobe Analytics-Plug-ins ab und integrieren Sie sie in Ihr Adobe Analytics-Framework in AEM. Fügen Sie den Code einem Client-Bibliotheksordner der Kategorie hinzu. sitecatalyst.plugins
damit sie für Ihren benutzerdefinierten JavaScript-Code verfügbar sind.
Wenn Sie beispielsweise die getQueryParams
-Plug-in können Sie das Plug-in aus dem s_doPlugins
-Funktion Ihres benutzerspezifischen JavaScript-Elements verwenden. Der folgende Beispielcode sendet die Abfragezeichenfolge in "pid" von der URL des Referrers 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.
Erstellen Sie einen Client-Bibliotheksordner für Ihre Plug-ins. Fügen Sie keine Plug-ins zum Ordner /libs/cq/analytics/clientlibs/sitecatalyst/plugins
hinzu. Dadurch wird sichergestellt, dass Ihre Beiträge zur Kategorie sitecatalyst.plugins
bei erneuten Installationen oder Upgrades von AEM nicht überschrieben werden.
Führen Sie die folgenden Schritte aus, um den Client-Bibliotheksordner für Ihre Plug-ins zu erstellen. Sie müssen diesen Vorgang nur einmal ausführen. Über das darauffolgende Verfahren können Sie ein Plug-in zum Client-Bibliotheksordner hinzufügen.
Öffnen Sie CRXDE Lite in einem Webbrowser. (http://localhost:4502/crx/de)
Klicken Sie mit der rechten Maustaste auf den Ordner /apps/my-app/clientlibs und klicken Sie auf „Erstellen“ > „Knoten erstellen“. Geben Sie die folgenden Eigenschaftswerte ein und klicken Sie dann auf „OK“:
Name: ein Name für den Client-Bibliotheksordner, z. B. „meine-plug-ins“
Typ: cq:ClientLibraryFolder
Wählen Sie den von Ihnen erstellten Client-Bibliotheksordner aus und verwenden Sie die untere rechte Eigenschaftenleiste, um die folgende Eigenschaft hinzuzufügen:
Klicken Sie im Eigenschaftsfenster auf „OK“, um den Eigenschaftswert zu bestätigen.
Klicken Sie mit der rechten Maustaste auf den von Ihnen erstellten Client-Bibliotheksordner und klicken Sie auf Erstellen > Datei erstellen . Geben Sie als Dateinamen „js.txt“ ein und klicken Sie dann auf „OK“.
Klicken Sie auf „Alle speichern“.
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.
Melden Sie sich mit Ihrem Adobe Analytics-Konto bei sc.omniture.com an.
Navigieren Sie auf der Landingpage zu Hilfe > Hilfe-Startseite.
Klicken Sie im Inhaltsverzeichnis auf der linken Seite auf Plug-ins für Implementierungen.
Klicken Sie auf den Link zum Plug-in, das Sie hinzufügen möchten. Suchen Sie beim Öffnen der Seite den JavaScript-Quellcode für das Plug-in, wählen Sie den Code aus und kopieren Sie ihn.
Klicken Sie mit der rechten Maustaste auf Ihren Client-Bibliotheksordner und klicken Sie auf Erstellen > Datei erstellen . Geben Sie als Dateinamen den Namen des zu integrierenden Plug-ins gefolgt von .js ein und klicken Sie auf OK. Wenn Sie z. B. das Plug-in getQueryParam integrieren, nennen Sie die Datei „getQueryParam.js“.
Wenn Sie die Datei erstellen, wird sie zur Bearbeitung geöffnet.
Fügen Sie den JavaScript-Code des Plug-ins in die Datei ein, klicken Sie auf "Alle speichern"und schließen Sie dann die Datei.
Öffnen Sie die Datei js.txt aus dem Client-Bibliotheksordner.
Fügen Sie in einer neuen Zeile den Namen der Datei ein, die das Plug-in enthält, z. B. getQueryParam.js. Klicken Sie dann auf „Alle speichern“ und schließen Sie die Datei.
Stellen Sie bei der Verwendung von Plug-ins sicher, dass Sie auch unterstützende Plug-ins integrieren. Andernfalls erkennt das Plug-in-JavaScript die Aufrufe, die es an die Funktionen im unterstützenden Plug-in sendet. Beispielsweise benötigt das Plug-in getPreviousValue() das Plug-in split() , um ordnungsgemäß zu funktionieren.
Den Namen des unterstützenden Plug-ins müssen Sie ebenfalls in die Datei js.txt einfügen.