Hinzufügen von Adobe Analytics

Die Konfiguration der Erweiterung, die die grundlegenden Bibliothekseinstellungen von AppMeasurement.js verwaltet und globale Variablen festlegen kann

Regelaktionen für folgende Funktionen:

1. Variablen festlegen
2. Variablen löschen
3. Analytics-Beacon senden

Navigieren Sie zu Erweiterungen > Katalog

Suchen Sie nach der Adobe Analytics-Erweiterung.

Klicken Sie auf Installieren

Geben ​ unter „Bibliotheksverwaltung > Report ​" die Report Suite-IDs ein, die Sie für jede Tag-Umgebung verwenden möchten. Wenn Ihre Benutzerinnen und Benutzer Zugriff auf Adobe Analytics haben, beachten Sie, dass beim Eingeben in das Feld eine vorausgefüllte Liste aller Ihrer Report Suites angezeigt wird. (In diesem Tutorial können Sie eine Report Suite für alle Umgebungen verwenden. Doch in der Praxis sollten Sie verschiedene Report Suites verwenden, wie in der Abbildung unten gezeigt.)

Geben ​ unter „Allgemein > Tracking-" Ihren Tracking-Server ein, z. B. tmd.sc.omtrdc.net. Geben Sie Ihren SSL-Trackingserver ein, wenn Ihre Site https:// unterstützt.

Legen ​ im Abschnitt „Globale ​" unter Zusätzliche Einstellungen die Variable Seitenname mithilfe Ihres Page Name Datenelements fest. Klicken Sie auf das Symbol , um das Modal zu öffnen und das Page Name-Seitendatenelement auszuwählen.

Klicken Sie auf In Bibliothek speichern

Gehen Sie zum Abschnitt Regeln im linken Navigationsbereich und klicken Sie dann auf Regel hinzufügen

Geben Sie einen Namen für die Regel ein All Pages - DOM Ready.

Klicken Sie auf Ereignisse > Hinzufügen, um den Event Configuration zu öffnen

Wählen Sie Ereignistyp > DOM bereit (beachten Sie, dass die Reihenfolge der Regel „50“ lautet).

Klicken Sie Änderungen beibehalten

Klicken Sie unter „Aktionen“ auf , um eine neue Aktion hinzuzufügen.

Wählen Sie Erweiterung > Adobe Analytics

Wählen Sie Aktionstyp > Beacon senden

Behalten Sie bei „Tracking“ s.t() bei. Beachten Sie: Wenn Sie einen s.tl()-Aufruf in einer Klickereignis-Regel vornehmen möchten, können Sie auch die Aktion „Beacon senden“ verwenden.

Klicken Sie auf Schaltfläche Änderungen beibehalten

Klicken Sie auf In Bibliothek speichern und erstellen

Öffnen Sie die Site „Luma“ in Ihrem Chrome-Browser.

Klicken Sie auf das Debugger-Symbol , um den Adobe Experience Cloud-Debugger zu öffnen

Stellen Sie sicher, dass der Debugger die Tag-Eigenschaft Ihre zuordnet, wie in der Lektion beschrieben

Klicken Sie, um die Registerkarte „Analytics“ zu öffnen.

Erweitern Sie den Namen Ihrer Report Suite, um alle Anfragen anzuzeigen.

Vergewissern Sie sich, dass die Anfrage mit der Variablen „Seitenname“ und dem zugehörigen Wert ausgelöst wurde.

Klicken Sie linken Navigationsbereich auf Datenelemente“

Klicken Sie Datenelement hinzufügen

Nennen Sie das Datenelement Page Type.

Wählen Sie Datenelementtyp > JavaScript-Variable

digitalData.page.category.type als JavaScript-Variablennamen verwenden

Aktivieren Sie die Optionen Text und Kleinbuchstaben erzwingen.

Klicken Sie auf In Bibliothek speichern

Klicken Sie linken Navigationsbereich auf Datenelemente“

Klicken Sie Datenelement hinzufügen

Nennen Sie das Datenelement Product Id.

Wählen Sie Datenelementtyp > JavaScript-Variable

digitalData.product.0.productInfo.sku als JavaScript-Variablennamen verwenden

Aktivieren Sie die Optionen Text und Kleinbuchstaben erzwingen.

Klicken Sie auf In Bibliothek speichern

Navigieren Sie zur Seite Erweiterungen > Katalog.

Suchen Sie nach der Adobe Analytics Product String von Adobe Consulting Services und klicken Sie auf Installieren

Nehmen Sie sich einen Moment Zeit, um die Anweisungen zu lesen.

Klicken Sie auf In Bibliothek speichern

Gehen Sie zum Abschnitt Regeln im linken Navigationsbereich und klicken Sie dann auf Regel hinzufügen

Geben Sie einen Namen für die Regel ein Product Details - DOM Ready - 40.

Klicken Sie auf Ereignisse > Hinzufügen, um den Event Configuration zu öffnen

Wählen Sie Ereignistyp > DOM bereit

Legen Sie die Reihenfolge auf 40 fest, sodass die Regel vor) Regel ausgeführt wird, die die Aktion Analytics > Beacon senden enthält

Klicken Sie Änderungen beibehalten

Klicken unter auf das , um den Condition Configuration zu öffnen

1. Wählen Sie Bedingungstyp > Wertvergleich

2. Verwenden Sie die Datenelementauswahl und wählen Sie im ersten Feld Page Type aus.

3. Wählen Enthält aus dem Dropdown-Menü des Vergleichsoperators aus.

4. Geben Sie in das nächsten Feld product-page ein (dies ist der eindeutige Teil des Seitentypwerts, der aus der Datenschicht der Produktdetailseiten abgerufen wird).

5. Klicken Sie Änderungen beibehalten

   

Klicken Sie unter „Aktionen“ auf , um eine neue Aktion hinzuzufügen.

Wählen Sie Erweiterung > Adobe Analytics Product String

Wählen Sie Aktionstyp > s.products festlegen

Wählen Sie im Abschnitt Analytics E-Commerce Ereignis“ die Option prodView

Wählen Sie Abschnitt „Datenschichtvariablen für" mit der Datenelementauswahl das Product Id Datenelement aus

Klicken Sie Änderungen beibehalten

Klicken Sie unter „Aktionen“ auf , um eine neue Aktion hinzuzufügen.

Wählen Sie Erweiterung > Adobe Analytics

Wählen Sie Aktionstyp > Variablen festlegen

Wählen Sie eVar1 > Als festlegen geben Sie product detail page ein.

Legen Sie event1 fest, wobei die optionalen Werte leer bleiben

Klicken Sie unter Ereignisse auf die Schaltfläche Weitere hinzufügen

Legen Sie das prodView-Ereignis fest, wobei die optionalen Werte leer bleiben

Klicken Sie Änderungen beibehalten

Klicken Sie auf In Bibliothek speichern und erstellen

Öffnen Sie die Site „Luma“ in Ihrem Chrome-Browser.

Navigieren Sie zu einer beliebigen Produktdetailseite.

Klicken Sie auf das Debugger-Symbol , um Ihren Adobe Experience Cloud-Debugger zu öffnen

Klicken Sie auf die Registerkarte „Analytics“.

Erweitern Sie Ihre Report Suite.

Beachten Sie die Produktdetailvariablen, die sich jetzt im Debugger befinden: eVar1 wurde auf „product detail page“ festgelegt, die Events-Variable auf „event1“ und „prodView“, die Produktvariable auf die Produkt-ID des anzuzeigenden Produkts und der Seitenname weiterhin auf die Analytics-Erweiterung.

Navigieren Sie zum Abschnitt Regeln im linken Navigationsbereich und klicken Sie dann auf Regel hinzufügen

Geben Sie einen Namen für die Regel ein Homepage - Featured Products enters Viewport.

Klicken Sie auf Ereignisse > Hinzufügen, um den Event Configuration zu öffnen

Wählen Sie Ereignistyp > Enters Viewport. Dadurch wird ein Feld eingeblendet, in das Sie den CSS-Selektor eingeben müssen. Damit wird das Element auf Ihrer Seite identifiziert, das die Regel auslöst, wenn es in die Ansicht des Browsers gelangt.

Gehen Sie zurück zur Startseite von Luma und scrollen Sie nach unten zum Abschnitt Vorgestellte Produkte .

Klicken Sie mit der rechten Maustaste auf den Bereich zwischen dem Titel „VORGESTELLTE PRODUKTE“ und den Elementen in diesem Abschnitt, und wählen Sie Inspect aus dem Kontextmenü. Dies ermöglicht die Suche nach dem Element.

Suchen Sie direkt dort oder möglicherweise direkt unter dem ausgewählten Bereich nach einem „div“ mit class="we-productgrid aem-GridColumn aem-GridColumn--default--12". Suchen Sie nach diesem Element.

Klicken Sie mit der rechten Maustaste auf dieses Element und wählen Sie Kopieren > Auswahl kopieren

Kehren Sie zu Tags zurück und fügen Sie diesen Wert aus der Zwischenablage in das Feld mit der Bezeichnung Elements matching the CSS selector ein.

1. Nebenbei bemerkt, entscheiden Sie, wie Sie CSS-Selektoren identifizieren können. Diese Methode ist ein wenig fehleranfällig, da durch bestimmte Änderungen auf der Seite der Selektor unbrauchbar werden kann. Beachten Sie dies bei der Verwendung von CSS-Selektoren in Tags.

Klicken Sie Änderungen beibehalten

Klicken Sie unter „Bedingungen“ auf , um eine neue Bedingung hinzuzufügen.

Wählen Sie Bedingungstyp > Wertvergleich

Verwenden Sie die Datenelementauswahl und wählen Sie im ersten Feld Page Name aus.

Wählen Sie Gleich aus dem Dropdown-Menü Vergleichsoperator aus

Geben Sie in das nächste Feld content:luma:us:en ein (dies ist der Seitenname der Startseite, der aus der Datenschicht abgerufen wurde – diese Regel soll in unserem Beispiel nur auf der Startseite ausgeführt werden).

Klicken Sie Änderungen beibehalten

Klicken Sie unter „Aktionen“ auf , um eine neue Aktion hinzuzufügen.

Wählen Sie Erweiterung > Adobe Analytics

Wählen Sie Aktionstyp > Variablen festlegen

Stellen Sie eVar3 auf Home Page - Featured Products ein.

Stellen Sie prop3 auf Home Page - Featured Products ein.

Stellen Sie die Events-Variable auf event3 ein.

Klicken Sie Änderungen beibehalten

Klicken Sie unter „Aktionen“ auf , um eine weitere neue Aktion hinzuzufügen.

Wählen Sie Erweiterung > Adobe Analytics

Wählen Sie Aktionstyp > Beacon senden

Wählen Sie die s.tl() Tracking-Option

Geben Sie Feld Link-Name“ Scrolled down to Featured Products ein. Dieser Wert wird in den Bericht „Benutzerspezifische Links“ in Analytics eingefügt.

Klicken Sie Änderungen beibehalten

Klicken Sie auf In Bibliothek speichern und erstellen

Öffnen Sie die Site „Luma“ in Ihrem Chrome-Browser und stellen Sie sicher, dass Sie sich oben auf der Startseite befinden.

Klicken Sie auf Debugger-Symbol , um Ihren Adobe Experience Cloud-Debugger zu öffnen

Klicken Sie auf die Registerkarte „Analytics“.

Erweitern Sie den Treffer Ihrer Report Suite.

Beachten Sie den normalen Seitenansichtstreffer für die Startseite mit u. a. dem Seitennamen (für eVar3 oder prop3 sind aber keine Einträge vorhanden).

Lassen Sie den Debugger geöffnet, scrollen Sie auf Ihrer Site nach unten, bis Sie den Abschnitt Vorgestellte Produkte sehen

Rufen Sie den Debugger erneut auf. Jetzt sollte ein weiterer Analytics-Treffer angezeigt werden. Dieser Treffer sollte die Parameter des den von Ihnen eingerichteten s.tl()-Treffers enthalten:

1. LinkType = "link_o" (das bedeutet, dass es sich bei dem Treffer um einen benutzerspezifischen Link handelt, nicht um einen Seitenansichtstreffer)

2. LinkName = "Scrolled down to Featured Products"

3. prop3 = "Home Page - Featured Products"

4. eVar3 = "Home Page - Featured Products"

5. Events = "event3"

   

Navigieren Sie zu Erweiterungen > Installiert

Klicken Sie in der Adobe Analytics-Erweiterung auf Konfigurieren

Aktivieren unter „Bibliotheksverwaltung das Kontrollkästchen mit der Bezeichnung Make tracker globally accessible. Wie Sie der Hilfemeldung entnehmen können, wird der Tracker hierdurch global unter „window.s“ geladen. Das ist wichtig, da Sie in Ihrem Kunden-JavaScript-Code darauf verweisen.

Scrollen Sie, während Sie sich noch in der Analytics-Erweiterung befinden, nach unten und erweitern Sie den Abschnitt mit dem Titel Configure Tracker Using Custom Code.

Klicken Sie auf Editor öffnen

Fügen Sie den folgenden Code in den Code-Editor ein:

/* Plugin Config */
s.usePlugins=true
s.doPlugins=function(s) {
/* Add calls to plugins here */
}

Lassen Sie dieses Fenster für den nächsten Schritt geöffnet

Kopieren Sie den folgenden Code:

/* Adobe Consulting Plugin: getValOnce v2.01 */
s.getValOnce=function(vtc,cn,et,ep){if(vtc&&(cn=cn||"s_gvo",et=et||0,ep="m"===ep?6E4:864E5,vtc!==this.c_r(cn))){var e=new Date;e.setTime(e.getTime()+et*ep);this.c_w(cn,vtc,0===et?0:e);return vtc}return""};

Fügen Sie ihn im Codefenster in der Analytics-Erweiterung unterhalb der doPlugins-Funktion ein (nicht innerhalb davon). Wenn Sie das Fenster nicht mehr geöffnet haben, öffnen Sie es gemäß dem vorherigen Schritt erneut.

Kopieren Sie den folgenden Code:

s.campaign = s.Util.getQueryParam("cid");

Fügen Sie ihn in die Funktion doPlugins ein. Hierdurch sucht die Funktion in der aktuellen Seiten-URL nach einem Parameter namens cid und fügt ihn in die Variable „s.campaign“ ein.

Rufen Sie jetzt die Funktion „getValOnce“ auf, indem Sie den folgenden Code kopieren und ihn direkt unterhalb des Aufrufs von „getQueryParam“ einfügen:

s.campaign=s.getValOnce(s.campaign,'s_cmp',30);

Dieser Code stellt sicher, dass derselbe Wert innerhalb von 30 Tagen nur maximal ein Mal gesendet wird (siehe die Dokumentation für Möglichkeiten zur Anpassung dieses Codes an Ihre Bedürfnisse).

Speichern Sie das Codefenster.

Klicken Sie auf In Bibliothek speichern und erstellen

Öffnen Sie die Site „Luma“ in Ihrem Chrome-Browser.

Klicken Sie auf das Debugger-Symbol , um den Adobe Experience Cloud-Debugger zu öffnen

Klicken Sie auf die Registerkarte „Analytics“.

Erweitern Sie Ihre Report Suite.

Beachten Sie, dass im Analytics-Treffer keine Kampagnenvariable vorhanden ist.

Lassen Sie den Debugger geöffnet, kehren Sie zur Site „Luma“ zurück, fügen Sie ?cid=1234 zur URL hinzu und drücken Sie die Eingabetaste, um die Seite mit der hinzugefügten Abfragezeichenfolge zu aktualisieren.

Stellen Sie sicher, dass im Debugger eine zweite Analytics-Anfrage mit einer Kampagnenvariablen mit dem Wert 1234 vorhanden ist.

Kehren Sie zur Seite „Luma“ zurück und aktualisieren Sie sie erneut, wobei die Abfragezeichenfolge noch in der URL enthalten sein muss.

Überprüfen Sie den nächsten Treffer im Debugger. Die Kampagnenvariable sollte nicht vorhanden sein, da das getValOnce-Plugin sichergestellt hat, dass die Variable nicht dupliziert wird, und auch kein anderer Benutzer über den Kampagnen-Trackingcode erfasst wurde.

BONUS: Sie können dies wiederholt testen, indem Sie den Wert des Parameters cid in der Abfragezeichenfolge ändern. Die Kampagnenvariable sollte nur vorhanden sein, wenn sie die Seite zum ersten Mal mit dem jeweiligen Wert aufrufen. Wenn der Kampagnenwert nicht im Debugger angezeigt wird, ändern Sie einfach den Wert von cid in der Abfragezeichenfolge der URL und drücken Sie die Eingabetaste, um ihn wieder im Debugger anzuzeigen.