Hinzufügen von Adobe Analytics

In dieser Lektion implementieren Sie die Adobe Analytics-Erweiterung und erstellen Regeln, um Daten an Adobe Analytics zu senden.

Adobe Analytics ist eine branchenführende Lösung, mit der Sie Ihre Kunden besser verstehen und Ihr Geschäft mit Customer Intelligence steuern können.

NOTE
Adobe Experience Platform Launch wird als eine Suite von Datenerfassungstechnologien in Adobe Experience Platform integriert. In der Benutzeroberfläche wurden mehrere terminologische Änderungen eingeführt, die Sie bei der Verwendung dieses Inhalts beachten sollten:

Lernziele

Am Ende dieser Lektion können Sie:

  1. die Adobe Analytics-Erweiterung hinzufügen
  2. Globale Variablen mithilfe der Erweiterung festlegen
  3. Das Seitenansichts-Beacon hinzufügen
  4. Zusätzliche Variablen mithilfe von Regeln hinzufügen
  5. Klicktracking und andere ereignisbasierte Beacons hinzufügen
  6. Analytics-Plugins hinzufügen

Es gibt viele Dinge, die für Analytics in Tags implementiert werden könnten. In dieser Lektion werden nicht alle Elemente aufgezählt, sie bietet aber einen umfassenden Überblick über die wichtigsten Verfahren zur Implementierung auf Ihrer eigenen Site.

Voraussetzungen

Sie sollten bereits die Lektionen in Konfigurieren von Tags und Hinzufügen des Identity Service abgeschlossen haben.

Darüber hinaus benötigen Sie mindestens eine Report Suite-ID sowie Ihren Trackingserver. Wenn Sie nicht über eine Report Suite für Tests/Entwicklung verfügen, die Sie für dieses Tutorial verwenden können, erstellen Sie eine. Weitere Hilfestellung und Anweisungen finden Sie in der Dokumentation. Sie können Ihren Trackingserver aus Ihrer aktuellen Implementierung abrufen oder bei Ihrem Adobe-Berater oder Kundenbetreuer erfragen.

Hinzufügen der Analytics-Erweiterung

Die Analytics-Erweiterung besteht aus zwei Hauptteilen:

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

  2. Regelaktionen für folgende Funktionen:

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

Hinzufügen der Analytics-Erweiterung

  1. Navigieren Sie zu Erweiterungen > Katalog

  2. Suchen Sie nach der Adobe Analytics-Erweiterung.

  3. Klicken Sie auf Installieren

    Installieren der Analytics-Erweiterung

  4. 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.)

    Report Suite-IDs eingeben

    note tip
    TIP
    Es wird empfohlen, die Option Bibliothek für mich verwalten als Bibliotheksverwaltung zu verwenden, da es dadurch wesentlich einfacher wird, die AppMeasurement.js-Bibliothek auf dem neuesten Stand zu halten.
  5. 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.

    Trackingserver eingeben

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

  7. Klicken Sie auf In Bibliothek speichern

    Seitennamenvariable festlegen und speichern

NOTE
Globale Variablen können in der Erweiterungskonfiguration oder in Regelaktionen festgelegt werden. Beachten Sie, dass beim Festlegen von Variablen in der Erweiterungskonfiguration die Datenschicht (vor den Tag Einbettungs-Codes definiert werden muss.

Senden des Seitenansichts-Beacons

Nun erstellen Sie eine Regel, die das Analytics-Beacon auslöst, das die in der Erweiterungskonfiguration festgelegte Variable Seitenname sendet.

Sie haben bereits eine Regel „Alle Seiten - Bibliothek geladen“ in der Lektion Datenelement, Regel und Bibliothek hinzufügen dieses Tutorials erstellt, die auf jeder Seite ausgelöst wird, wenn die Tag-Bibliothek geladen wird. Sie könnten diese Regel auch für Analytics verwenden. Diese Einrichtung erfordert jedoch, dass alle im Analytics-Beacon verwendeten Datenschichtattribute vor den Tag-Einbettungs-Codes definiert werden. Um Daten flexibler erfassen zu können, erstellen Sie die neue Regel „Alle Seiten“, die bei „DOM bereit“ ausgelöst wird und wiederum das Analytics-Beacon aktiviert.

Senden des Seitenansichts-Beacons

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

    Regel hinzufügen

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

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

    Benennen der Regel und Hinzufügen des Ereignisses

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

  5. Klicken Sie Änderungen beibehalten
    Konfigurieren des Ereignisses

  6. Klicken Sie unter „Aktionen“ auf Auf das Plussymbol klicken , um eine neue Aktion hinzuzufügen.

    Auf das Plussymbol klicken, um eine neue Aktion hinzuzufügen

  7. Wählen Sie Erweiterung > Adobe Analytics

  8. Wählen Sie Aktionstyp > Beacon senden

  9. 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.

  10. Klicken Sie auf Schaltfläche Änderungen beibehalten

    Auf das Plussymbol klicken, um eine neue Aktion hinzuzufügen

  11. Klicken Sie auf In Bibliothek speichern und erstellen

    Auf „In Bibliothek speichern und erstellen“ klicken

Überprüfen des Seitenansichts-Beacons

Nachdem Sie eine Regel zum Senden eines Analytics-Beacons erstellt haben, sollte die Anfrage in Experience Cloud Debugger angezeigt werden.

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

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

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

    Die Tag-Entwicklungsumgebung wird im Debugger angezeigt

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

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

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

    Überprüfen des Seitentreffers

NOTE
Wenn der Seitenname für Sie nicht angezeigt wird, gehen Sie zurück zu den Schritten auf dieser Seite, um sicherzustellen, dass Sie nichts verpasst haben.

Hinzufügen von Variablen mit Regeln

Als Sie die Analytics-Erweiterung konfiguriert haben, haben Sie die pageName-Variable in der Erweiterungskonfiguration eingegeben. Dies ist ein guter Speicherort, um andere globale Variablen wie eVars und Props zu befüllen, vorausgesetzt, der Wert ist auf der Seite verfügbar, bevor der Tag-Einbettungs-Code geladen wird.

Flexibler können Variablen und Ereignissen in Regeln mithilfe der Aktion Set Variables festgelegt werden. Regeln ermöglichen es Ihnen, unter verschiedenen Bedingungen verschiedene Analysen-Variablen und -Ereignisse festzulegen. Sie könnten beispielsweise das prodView-Ereignis nur auf Produktdetailseiten und das purchase-Ereignis nur auf Bestellbestätigungsseiten festlegen. In diesem Abschnitt lernen Sie, wie Variablen mithilfe von Regeln festgelegt werden.

Anwendungsfall

Produktdetailseiten sind wichtige Punkte für die Datenerfassung auf Einzelhandelssites. Normalerweise möchten Sie, dass Analytics registriert, wenn ein Produkt aufgerufen wird und um welches Produkt es sich gehandelt hat. Das ist hilfreich, um zu ermitteln, welche Produkte bei Ihren Kunden beliebt sind. Auf einer Mediensite können Sie für Artikel- und Videoseiten ähnliche Trackingmethoden wie die hier genutzten verwenden. Beim Laden einer Produktdetailseite könnten Sie diesen Wert in einer „Seitentyp“-eVar ablegen und einige Ereignisse sowie die Produkt-ID festlegen. So können wir in unserer Analyse Folgendes ermitteln:

  1. Wie oft werden Produktdetailseiten geladen
  2. Welche spezifischen Produkte werden angezeigt und wie oft
  3. Inwiefern beeinflussen andere Faktoren (Kampagnen, Suche usw.), wie viele Produktdetailseiten Kunden laden

Erstellen eines Datenelements für den Seitentyp

Zunächst muss erkennbar sein, welche Seiten Produktdetailseiten sind. Dies erfolgt über ein Datenelement.

Erstellen des Datenelements für den Seitentyp

  1. Klicken Sie linken Navigationsbereich auf Datenelemente“

  2. Klicken Sie Datenelement hinzufügen

    Neues Datenelement hinzufügen

  3. Nennen Sie das Datenelement Page Type.

  4. Wählen Sie Datenelementtyp > JavaScript-Variable

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

  6. Aktivieren Sie die Optionen Text und Kleinbuchstaben erzwingen.

  7. Klicken Sie auf In Bibliothek speichern

    Neues Datenelement für Seitentyp hinzufügen

Erstellen eines Datenelements für die Produkt-ID

Erfassen Sie als Nächstes die Produkt-ID der aktuellen Produktdetailseite mit einem Datenelement.

Erstellen des Datenelements für die Produkt-ID

  1. Klicken Sie linken Navigationsbereich auf Datenelemente“

  2. Klicken Sie Datenelement hinzufügen

    Neues Datenelement hinzufügen

  3. Nennen Sie das Datenelement Product Id.

  4. Wählen Sie Datenelementtyp > JavaScript-Variable

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

  6. Aktivieren Sie die Optionen Text und Kleinbuchstaben erzwingen.

  7. Klicken Sie auf In Bibliothek speichern

    Neues Datenelement für Seitentyp hinzufügen

Hinzufügen der Adobe Analytics-Erweiterung „Produktzeichenfolge“

Wenn Sie bereits mit Adobe Analytics-Implementierungen vertraut sind, ist Ihnen die Produktvariable wahrscheinlich bekannt. Die Produktvariable verfügt über eine sehr spezielle Syntax und wird je nach Kontext auf unterschiedliche Weise verwendet. Um die Population der Produktvariablen in Tags zu vereinfachen, wurden bereits drei zusätzliche Erweiterungen im Tag-Erweiterungs-Marketplace erstellt! In diesem Abschnitt fügen Sie eine von Adobe Consulting erstellte Erweiterung für die Verwendung auf der Produktdetailseite hinzu.

Hinzufügen der Adobe Analytics Product String-Erweiterung

  1. Navigieren Sie zur Seite Erweiterungen > Katalog.

  2. Suchen Sie nach der Adobe Analytics Product String von Adobe Consulting Services und klicken Sie auf Installieren
    Adobe Analytics Product String-Erweiterung von Adobe Consulting hinzufügen

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

  4. Klicken Sie auf In Bibliothek speichern

    Erweiterung speichern und für Ihre Bibliothek erstellen

Erstellen von Regeln für Produktdetailseiten

Verwenden Sie jetzt Ihre neuen Datenelemente und Erweiterungen, um die Regel für die Produktdetailseite zu erstellen. Für diese Funktion werden Sie eine weitere Seitenladeregel erstellen, die von „DOM bereit“ ausgelöst wird. Sie werden dazu jedoch eine Bedingung verwenden, damit diese Regel nur auf den Produktdetailseiten ausgelöst wird und die Reihenfolge so festgelegt ist, dass sie vor der Regel ausgelöst wird, durch die das Beacon gesendet wird.

Erstellen der Seitenregel für Produktdetails

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

    Regel hinzufügen

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

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

    Benennen der Regel und Hinzufügen des Ereignisses

  4. Wählen Sie Ereignistyp > DOM bereit

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

  6. Klicken Sie Änderungen beibehalten
    Konfigurieren des Ereignisses

  7. Klicken unter auf das Klicken Sie auf das Pluszeichen , um den Condition Configuration zu öffnen
    Auf das Plussymbol klicken, um eine neue Bedingung hinzuzufügen

    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

      Bedingung definieren

  8. Klicken Sie unter „Aktionen“ auf Auf das Plussymbol klicken , um eine neue Aktion hinzuzufügen.

    Auf das Plussymbol klicken, um eine neue Aktion hinzuzufügen

  9. Wählen Sie Erweiterung > Adobe Analytics Product String

  10. Wählen Sie Aktionstyp > s.products festlegen

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

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

  13. Klicken Sie Änderungen beibehalten

    Produktzeichenfolgenvariable mithilfe der Adobe Analytics Product String-Erweiterung hinzufügen

  14. Klicken Sie unter „Aktionen“ auf Auf das Plussymbol klicken , um eine neue Aktion hinzuzufügen.

    Eine weitere Aktion für die Produktzeichenfolge hinzufügen

  15. Wählen Sie Erweiterung > Adobe Analytics

  16. Wählen Sie Aktionstyp > Variablen festlegen

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

  18. Legen Sie event1 fest, wobei die optionalen Werte leer bleiben

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

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

  21. Klicken Sie Änderungen beibehalten

    Festlegen von Analytics-Variablen in der Produktdetailseiten-Regel

  22. Klicken Sie auf In Bibliothek speichern und erstellen

    Speichern Sie die Regel

Validieren der Daten der Produktdetailseite

Sie haben gerade eine Regel erstellt, die Variablen festlegt, bevor das Beacon gesendet wird. Jetzt sollten die im Treffer ausgehenden neuen Daten im Experience Cloud Debugger angezeigt werden.

Überprüfen der Daten der Produktdetailseite

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

  2. Navigieren Sie zu einer beliebigen Produktdetailseite.

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

  4. Klicken Sie auf die Registerkarte „Analytics“.

  5. Erweitern Sie Ihre Report Suite.

  6. 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.

    Überprüfen des Seitentreffers

Wenn eine Seite geladen wird, löst sie normalerweise über die Funktion s.t() ein Seitenlade-Beacon aus. Dadurch wird automatisch die page view-Metrik für die jeweilige Seite erhöht, die in der pageName-Variablen aufgeführt ist.

Manchmal möchten Sie jedoch nicht die Seitenansichten Ihrer Site erhöhen, da die Aktion, die stattfindet, „kleiner“ (oder eventuell nur anders) ist als ein Seitenaufruf. Verwenden Sie in diesem Fall die Funktion s.tl(), die häufig als „Link verfolgen“-Anfrage bezeichnet wird. Die „Link verfolgen“-Anfrage muss jedoch trotz ihres Namens nicht beim Aufrufen eines Links ausgelöst werden. Er kann durch jedes Ereignisse ausgelöst werden, die Ihnen im Tag Rule Builder zur Verfügung stehen, einschließlich Ihrer eigenen benutzerdefinierten JavaScript.

In diesem Tutorial lösen Sie einen s.tl()-Aufruf mithilfe eines der coolsten JavaScript-Ereignisse aus, einem Enters Viewport-Ereignis.

Anwendungsfall

In diesem Anwendungsbeispiel möchten Sie wissen, ob Personen auf unserer Luma-Startseite weit genug nach unten scrollen, um den Abschnitt Vorgestellte Produkte auf unserer Seite anzuzeigen. Im Unternehmen herrscht Uneinigkeit darüber, ob Benutzer diesen Abschnitt überhaupt sehen oder nicht. Daher sollten Sie Analytics verwenden, um die Wahrheit zu ermitteln.

Erstellen der Regel in Tags

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

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

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

    Regel für vorgestellte Produkte hinzufügen

  4. 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.

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

  6. 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.

  7. 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.

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

    Konfigurieren des Ereignisses „Enters Viewpoint“

  9. 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.
  10. Klicken Sie Änderungen beibehalten
    Konfigurieren des Ereignisses „Enters Viewpoint“

  11. Klicken Sie unter „Bedingungen“ auf Auf das Plussymbol klicken , um eine neue Bedingung hinzuzufügen.

  12. Wählen Sie Bedingungstyp > Wertvergleich

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

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

  15. 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).

  16. Klicken Sie Änderungen beibehalten

    Konfigurieren der Startseiten-Bedingung

  17. Klicken Sie unter „Aktionen“ auf Auf das Plussymbol klicken , um eine neue Aktion hinzuzufügen.

  18. Wählen Sie Erweiterung > Adobe Analytics

  19. Wählen Sie Aktionstyp > Variablen festlegen

  20. Stellen Sie eVar3 auf Home Page - Featured Products ein.

  21. Stellen Sie prop3 auf Home Page - Featured Products ein.

  22. Stellen Sie die Events-Variable auf event3 ein.

  23. Klicken Sie Änderungen beibehalten

    Konfigurieren des Ereignisses „Enters Viewpoint“

  24. Klicken Sie unter „Aktionen“ auf Auf das Plussymbol klicken , um eine weitere neue Aktion hinzuzufügen.

  25. Wählen Sie Erweiterung > Adobe Analytics

  26. Wählen Sie Aktionstyp > Beacon senden

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

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

  29. Klicken Sie Änderungen beibehalten

    Konfigurations-Beacon für vorgestellte Produkte

  30. Klicken Sie auf In Bibliothek speichern und erstellen

    Regel speichern und erstellen

Jetzt möchten Sie sicherstellen, dass dieser Treffer eingeht, wenn Sie auf der Startseite unserer Website zum Abschnitt „Vorgestellte Produkte“ scrollen. Wenn Sie die Startseite zum ersten Mal laden, sollte die Anfrage nicht durchgeführt werden. Wenn Sie aber nach unten scrollen, sollte der Treffer mit den neuen Werten ausgelöst werden.

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

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

  3. Klicken Sie auf die Registerkarte „Analytics“.

  4. Erweitern Sie den Treffer Ihrer Report Suite.

  5. 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).

    Debugger mit einer Seitenansicht

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

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

      Debugger mit einer Seitenansicht

Hinzufügen eines Plugins

Ein Plugin ist ein JavaScript-Code, den Sie Ihrer Implementierung hinzufügen können, um eine spezifische Funktion auszuführen, die nicht in das Produkt integriert ist. Plugins können von Ihnen, anderen Adobe-Kunden/-Partnern oder von Adobe Consulting erstellt werden.

Zur Implementierung von Plugins sind drei Schritte erforderlich:

  1. Integrieren Sie die Funktion „doPlugins“, in der auf das Plugin verwiesen wird.
  2. Fügen Sie den Hauptfunktionscode für das Plugin hinzu.
  3. Fügen Sie den Code ein, der die Funktion aufruft, die Variablen festlegt usw.

Globale Verfügbarkeit des Analytics-Objekts

Wenn Sie die Funktion „doPlugins“ hinzufügen (siehe unten) und Plugins verwenden möchten, müssen Sie ein Kontrollkästchen aktivieren, um das s-Objekt von Analytics in der Analytics-Implementierung global verfügbar zu machen.

  1. Navigieren Sie zu Erweiterungen > Installiert

  2. Klicken Sie in der Adobe Analytics-Erweiterung auf Konfigurieren

    Konfigurieren von Analytics

  3. 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.
    Tracker global zugänglich machen

Hinzufügen der Funktion „doPlugins“

Um Plugins hinzuzufügen, müssen Sie eine Funktion namens „doPlugins“ einfügen. Diese Funktion wird nicht standardmäßig hinzugefügt. Wird sie aber hinzugefügt, wird sie von der AppMeasurement-Bibliothek verarbeitet und zuletzt aufgerufen, wenn ein Treffer an Adobe Analytics gesendet wird. Daher können Sie diese Funktion verwenden, um JavaScript-Code auszuführen und so auf einfachere Weise Variablen festzulegen.

  1. 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.

  2. Klicken Sie auf Editor öffnen

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

    code language-javascript
    /* Plugin Config */
    s.usePlugins=true
    s.doPlugins=function(s) {
    /* Add calls to plugins here */
    }
    
  4. Lassen Sie dieses Fenster für den nächsten Schritt geöffnet

Hinzufügen des Funktionscodes für das Plugin

Sie werden in diesem Code zwei Plugins aufrufen, aber eines davon ist in der AppMeasurement-Bibliothek integriert, sodass Sie für dieses nicht die aufzurufende Funktion hinzufügen müssen. Für das zweite Plugin müssen Sie jedoch auch den Funktionscode hinzufügen. Es handelt sich um die Funktion getValOnce().

Das getValOnce()-Plugin

Dieses Plugin soll verhindern, dass Werte fälschlicherweise im Code dupliziert werden, wenn ein Besucher eine Seite aktualisiert oder die Zurück-Schaltfläche des Browsers verwendet, um zu einer Seite zurückzukehren, auf der ein Wert festgelegt wurde. In dieser Lektion verwenden Sie es, um zu verhindern, dass das clickthrough-Ereignis dupliziert wird.

Der Code für dieses Plugin befindet sich in der Analytics-Dokumentation und ist hier zum einfachen Kopieren/Einfügen ebenfalls aufgeführt.

  1. Kopieren Sie den folgenden Code:

    code language-javascript
    /* 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""};
    
  2. 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.

    Plugin-Code hinzufügen

Sie können dieses Plugin jetzt aus „doPlugins“ heraus aufrufen.

Aufrufen von Plugins aus doPlugins heraus

Der Code ist jetzt eingefügt und kann referenziert werden. Somit können Sie die Aufrufe an Plugins innerhalb der Funktion „doPlugins“ ausführen.

Rufen Sie zunächst ein Plugin auf, das in die AppMeasurement-Bibliothek integriert wurde und deshalb als „Dienstprogramm“ bezeichnet wird. Das Plugin trägt die Bezeichnung s.Util.getQueryParam, da es Teil des s-Objekts und ein integriertes Dienstprogramm ist und Werte basierend auf einem Parameter aus der Abfragezeichenfolge in der URL abruft.

  1. Kopieren Sie den folgenden Code:

    code language-javascript
    s.campaign = s.Util.getQueryParam("cid");
    
  2. 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.

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

    code language-javascript
    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).

    Plugins in doPlugins aufrufen

  4. Speichern Sie das Codefenster.

  5. Klicken Sie auf In Bibliothek speichern und erstellen

    Plugins in doPlugins aufrufen

Überprüfen der Plugins

Jetzt können Sie sicherstellen, dass die Plugins funktionieren.

Überprüfen der Plugins

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

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

  3. Klicken Sie auf die Registerkarte „Analytics“.

  4. Erweitern Sie Ihre Report Suite.

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

  6. 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.

    Abfragezeichenfolge hinzufügen

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

    getQueryParam, Schritt 1

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

  9. Ü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.

    getQueryParam, Schritt 1

  10. 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.

    note note
    NOTE
    Es gibt mehrere Möglichkeiten, einen Parameter aus der Abfragezeichenfolge der URL zu erfassen, darunter die Konfiguration der Analytics-Erweiterung. Die anderen Optionen – ohne Verwendung von Plugins – bieten jedoch nicht die Möglichkeit, unnötige Duplikate zu verhindern, wie wir es hier mit dem getValOnce-Plugin getan haben. Dies ist die bevorzugte Methode des Autors. Sie sollten aber selbst bestimmen, welche Methode für Sie und Ihre Bedürfnisse am besten geeignet ist.

Gut gemacht! Sie haben die Analytics-Lektion abgeschlossen. Natürlich gibt es viele andere Dinge, die Sie tun können, um unsere Analytics-Implementierung zu verbessern, aber hoffentlich hat Ihnen dies einige der Kernkompetenzen vermittelt, um den Rest Ihrer Anforderungen zu erfüllen.

Weiter "Adobe Audience Manager hinzufügen“ >

recommendation-more-help
45774420-d03e-4a6b-94b5-cd639ae825b2