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.

HINWEIS

Adobe Experience Platform Launch wird als eine Suite von Datenerfassungstechnologien in Adobe Experience Platform integriert. In der Benutzeroberfläche wurden verschiedene 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 Elemente, die für Analytics in -Tags implementiert werden können. 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 die Lektionen in Konfigurieren von Tags und Hinzufügen des ID-Diensts bereits 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 Sie unter Bibliotheksverwaltung > Report Suites die Report Suite-IDs ein, die Sie für jede Tag-Umgebung verwenden möchten. Wenn Ihre Benutzer Zugriff auf Adobe Analytics haben, beachten Sie, dass beim Eingeben des Felds eine vorab ausgefüllte Liste aller 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

    TIPP

    Es wird empfohlen, die Option Bibliothek für mich verwalten als die Einstellung für die Bibliotheksverwaltung zu verwenden, da die AppMeasurement.js-Bibliothek dadurch viel einfacher auf dem neuesten Stand gehalten werden kann.

  5. Geben Sie unter Allgemein > Tracking-Server 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 Sie im Abschnitt Globale Variablen unter Zusätzliche Einstellungen die Variable Seitenname mithilfe des Datenelements Page Name 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

HINWEIS

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 Tageinbettungscodes 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 die Regel "Alle Seiten - Bibliothek geladen"bereits in der Lektion Hinzufügen eines Datenelements, einer Regel und einer Bibliothek dieses Tutorials erstellt. Diese Regel wird auf jeder Seite ausgelöst, wenn die Tag-Bibliothek geladen wird. Sie könnten diese Regel auch für Analytics verwenden. Bei dieser Einrichtung müssen jedoch alle im Analytics-Beacon verwendeten Datenschichtattribute vor den Tags-Einbettungscodes 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. Wechseln Sie im linken Navigationsbereich zum Abschnitt Regeln 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 Bildschirm Event Configuration zu öffnen.

    Benennen der Regel und Hinzufügen des Ereignisses

  4. Wählen Sie Ereignistyp > DOM bereit aus. (Beachten Sie, dass der Rang der Regel „50“ ist.)

  5. Klicken Sie auf Ä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 aus.

  8. Wählen Sie Aktionstyp > Beacon senden aus.

  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 die 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 Eigenschaft "tags"der Entwicklungsumgebung Ihrer -Entwicklungsumgebung zuordnet, wie in der früheren Lektion beschrieben.

    Ihre Tags-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

HINWEIS

Wenn Ihnen der Seitenname nicht angezeigt wird, gehen Sie die Schritte auf dieser Seite durch, um sicherzustellen, dass Sie nichts übersehen 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 zum Ausfüllen anderer globaler Variablen wie eVars und Props, sofern der Wert auf der Seite verfügbar ist, bevor der Tageinbettungscode 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 im linken Navigationsbereich auf Datenelemente .

  2. Klicken Sie auf Datenelement hinzufügen.

    Neues Datenelement hinzufügen

  3. Nennen Sie das Datenelement Page Type.

  4. Wählen Sie Datenelementtyp > JavaScript-Variable aus.

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

  6. Aktivieren Sie die Optionen Text bereinigen und Kleinere Groß-/Kleinschreibung 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 im linken Navigationsbereich auf Datenelemente .

  2. Klicken Sie auf Datenelement hinzufügen.

    Neues Datenelement hinzufügen

  3. Nennen Sie das Datenelement Product Id.

  4. Wählen Sie Datenelementtyp > JavaScript-Variable aus.

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

  6. Aktivieren Sie die Optionen Text bereinigen und Kleinere Groß-/Kleinschreibung 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 Marketplace für die Tag-Erweiterung 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-Erweiterung 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. Wechseln Sie im linken Navigationsbereich zum Abschnitt Regeln 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 Bildschirm Event Configuration zu öffnen.

    Benennen der Regel und Hinzufügen des Ereignisses

  4. Wählen Sie Ereignistyp > DOM bereit aus.

  5. Legen Sie für die Reihenfolge den Wert „40“ fest, damit die Regel vor der Regel mit der Aktion „Analytics > Beacon senden“ ausgeführt wird.

  6. Klicken Sie auf Änderungen beibehalten

    Konfigurieren des Ereignisses

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

    1. Wählen Sie Bedingungstyp > Wertevergleich aus.

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

    3. Wählen Sie Enthält aus dem Dropdown-Menü der Vergleichsoperatoren 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 auf Ä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 aus.

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

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

  12. Verwenden Sie im Abschnitt Daten-Layer-Variablen für Produktdaten die Datenelementauswahl, um das Product Id-Datenelement auszuwählen.

  13. Klicken Sie auf Ä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 aus.

  16. Wählen Sie Aktionstyp > Variablen festlegen aus.

  17. Wählen Sie eVar1 > Festlegen als aus und 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 Ereignis prodView fest, wobei die optionalen Werte leer bleiben.

  21. Klicken Sie auf Ä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 den 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. Sie kann durch beliebige der Ereignisse ausgelöst werden, die Ihnen im Regel-Builder für Tags zur Verfügung stehen, einschließlich Ihres eigenen benutzerdefinierten JavaScript-Codes.

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

Anwendungsfall

Für diesen Anwendungsfall möchten Sie wissen, ob Benutzer auf unserer Luma-Startseite nach unten scrollen, um den Abschnitt Empfohlene Produkte auf unserer Seite zu sehen. 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. Wechseln Sie im linken Navigationsbereich zum Abschnitt Regeln 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 Bildschirm Event Configuration zu öffnen.

    Regel für vorgestellte Produkte hinzufügen

  4. Wählen Sie Ereignistyp > Enters Viewport aus. 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 Abstand zwischen dem Titel "FEATURED PRODUCTS" und den Elementen in diesem Abschnitt und wählen Sie Inspect aus dem Kontextmenü aus. 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 > Selector kopieren aus.

    Konfigurieren des Ereignisses „Enters Viewpoint“

  9. Gehen Sie zurück zu den Tags und fügen Sie diesen Wert aus der Zwischenablage in das Feld 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 auf Ä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 > Wertevergleich aus.

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

  14. Wählen Sie Gleich aus dem Dropdown-Menü der Vergleichsoperatoren 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 auf Ä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 aus.

  19. Wählen Sie Aktionstyp > Variablen festlegen aus.

  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 auf Ä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 aus.

  26. Wählen Sie Aktionstyp > Beacon senden aus.

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

  28. Geben Sie in das Feld Linkname die Bezeichnung Scrolled down to Featured Products ein. Dieser Wert wird in den Bericht „Benutzerspezifische Links“ in Analytics eingefügt.

  29. Klicken Sie auf Änderungen beibehalten

    Konfiguration des Beacons für vorgestellte Produkte

  30. Klicken Sie auf In Bibliothek speichern und erstellen.

    Regel speichern und erstellen

Nun sollten Sie sicherstellen, dass dieser Treffer eingeht, wenn Sie auf der Startseite nach unten 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 den 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 "Spezifische 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. Wählen Sie unter Bibliotheksverwaltung das Feld mit der Bezeichnung Make tracker globally accessible aus. 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.
    Globale Zugänglichkeit von Tracker

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:

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

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

    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:

    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.

    HINWEIS

    Es gibt verschiedene Möglichkeiten, einen Parameter aus der Abfragezeichenfolge der URL abzurufen, darunter auch 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 gegeben, die Sie benötigen, um den Rest Ihrer Anforderungen in Angriff zu nehmen.

Weiter mit „Hinzufügen von Adobe Audience Manager“ >

Auf dieser Seite