Einrichten von Asset Insights mit AEM Assets und Adobe Experience Platform Launch

In dieser 5-teiligen Videoreihe werden wir durch die Einrichtung und Konfiguration von Asset Insights für Experience Manager, der über Adobe Launch bereitgestellt wird, geleitet.

Teil 1: Überblick über Asset Insights

Asset Insights - Überblick. Installieren Sie Kernkomponenten, Beispielbildkomponente und andere Inhaltspakete, um Ihre Umgebung fertig zu machen.

Architekturdiagramm

Architekturdiagramm

VORSICHT

Laden Sie die neueste Version der Kernkomponenten für Ihre Implementierung herunter.

Das Video verwendet Kernkomponenten v2.2.2, die nicht mehr die neueste Version sind. Stellen Sie sicher, dass Sie die neueste Version verwenden, bevor Sie mit dem nächsten Abschnitt fortfahren.

Teil 2: Aktivieren der Asset Insights-Verfolgung für die Beispielbildkomponente

Verbesserungen an Kernkomponenten und Verwendung der Proxy-Komponente (Beispielbildkomponente) für Asset Insights. Bearbeiten der Vorlagenrichtlinien für die Inhaltsseite, um die Beispielbildkomponente für die Referenz-Site zu aktivieren.

HINWEIS

Die Bild-Core-Komponente bietet die Möglichkeit, die UUID-Verfolgung zu deaktivieren, indem das Tracking der UUID des Assets deaktiviert wird (eindeutiger Identifikationswert für einen innerhalb von JCR erstellten Knoten).

Die Kernbildkomponente verwendet das Attribut data-asset-id innerhalb des übergeordneten <div> eines Bild-Tags, um diese Funktion zu aktivieren/deaktivieren. Die Proxy-Komponente überschreibt die Kernkomponente mit den folgenden Änderungen.

  • Entfernt data-asset-id aus dem übergeordneten div eines <img> -Elements innerhalb der image.html
  • Fügt data-aem-asset-id direkt zum <img>-Element innerhalb der image.html hinzu.
  • Fügt den Wert data-trackable='true' zum <img>-Element innerhalb der image.html hinzu.
  • data-aem-asset- idand data-trackable='true' werden auf derselben Knotenebene beibehalten
HINWEIS

data-aem-asset-id='image.UUID' and data-trackable='true' sind die Schlüsselattribute, die für Asset-Impressionen vorhanden sein müssen. Für Asset Click Insights muss das übergeordnete <a> -Tag zusätzlich zu den oben genannten Datenattributen, die im <img> -Tag vorhanden sind, über einen gültigen href-Wert verfügen.

Teil 3: Adobe Analytics - Erstellen von Report Suites, Aktivieren der Echtzeit-Datenerfassung und AEM Assets-Berichterstellung

Für die Asset-Verfolgung wird eine Report Suite mit Echtzeit-Datenerfassung erstellt. Die AEM Assets Insights-Konfiguration wird mit Adobe Analytics-Anmeldeinformationen eingerichtet.

HINWEIS

Die Echtzeit-Datenerfassung und AEM Asset-Berichterstellung müssen für Ihre Adobe Analytics Report Suite aktiviert sein. Durch Aktivierung AEM Asset Reporting werden Analysevariablen zur Verfolgung von Asset-Einblicken reserviert.

Für die AEM Assets Insights-Konfiguration benötigen Sie die folgenden Anmeldedaten

  • Rechenzentrum
  • Analytics-Unternehmensname
  • Analytics-Benutzername
  • Gemeinsamer geheimer Schlüssel (erhältlich unter Adobe Analytics > Admin > Unternehmenseinstellungen > Webdienst).
  • Report Suite (Stellen Sie sicher, dass Sie die richtige Report Suite auswählen, die für die Asset-Berichterstellung verwendet wird)

Teil 4: Verwenden von Adobe Experience Platform Launch zum Hinzufügen der Adobe Analytics-Erweiterung

Hinzufügen der Adobe Analytics-Erweiterung, Erstellen von Seitenladeregeln und Integrieren von AEM in Launch mit dem technischen Adobe IMS-Konto.

HINWEIS

Stellen Sie sicher, dass Sie alle Ihre Änderungen von der Autoreninstanz zur Veröffentlichungsinstanz replizieren.

Regel 1: Seitenverfolgung (pagetracker.js)

//For AEM 6.3
<script type="text/javascript" src="http://localhost:4503/etc/clientlibs/foundation/assetinsights/pagetracker.js"></script>
//For AEM 6.4
<script type="text/javascript" src="http://localhost:4503/etc.clientlibs/dam/clientlibs/assetinsights/pagetracker.js"></script>

Seitenverfolgung implementiert zwei Rückrufe (registriert in Asset-Einbettungscode)

  • &lt;code>assetAnalytics.core.assetLoaded&lt;/code> <code><code>: aufgerufen, wenn das Ereignis "load"für das Asset-DOM-Element gesendet wird.</code></code>
  • &lt;code>assetAnalytics.core.assetClicked&lt;/code> <code><code>: aufgerufen wird, wenn das "click"-Ereignis für das Asset-DOM-Element gesendet wird, ist dies nur relevant, wenn das Asset-DOM-Element über ein Anker-Tag verfügt, das mit einem gültigen, externen "href"-Attribut übergeordnet ist.</code></code>

Schließlich implementiert Pagetracker eine Initialisierungsfunktion als .

  • &lt;code>assetAnalytics.dispatcher.init()&lt;/code> <code><code>: aufgerufen, um die Seitentracker-Komponente zu initialisieren.</code></code> Diese MUSS aufgerufen werden, bevor eines der Asset-Insights-Ereignisse (Impressionen und/oder Klicks) von der Webseite generiert wird.
  • &lt;code>assetAnalytics.dispatcher.init()&lt;/code> <code><code>: Akzeptiert optional ein AppMeasurement-Objekt - sofern angegeben, wird nicht versucht, eine neue Instanz des AppMeasurement-Objekts zu erstellen.</code></code>

Regel 2: Bildverfolgung — Aktion 1 (asset-insights.js)

/*
 * AEM Asset Insights
 */

var sObj = window.s;
_satellite.notify('in assetAnalytics customInit');
(function initializeAssetAnalytics() {
 if ((!!window.assetAnalytics) && (!!assetAnalytics.dispatcher)) {
 _satellite.notify('assetAnalytics ready');
 /** NOTE:
  Copy over the call to 'assetAnalytics.dispatcher.init()' from Assets Pagetracker
  Be mindful about changing the AppMeasurement object as retrieved above.
  */
 assetAnalytics.dispatcher.init(
                                "",  /** RSID to send tracking-call to */
                                "",  /** Tracking Server to send tracking-call to */
                                "",  /** Visitor Namespace to send tracking-call to */
                                "",  /** listVar to put comma-separated-list of Asset IDs for Asset Impression Events in tracking-call, e.g. 'listVar1' */
                                "",  /** eVar to put Asset ID for Asset Click Events in, e.g. 'eVar3' */
                                "",  /** event to include in tracking-calls for Asset Impression Events, e.g. 'event8' */
                                "",  /** event to include in tracking-calls for Asset Click Events, e.g. 'event7' */
                                sObj  /** [OPTIONAL] if the webpage already has an AppMeasurement object, please include the object here. If unspecified, Pagetracker Core shall create its own AppMeasurement object */
                                );
 sObj.usePlugins = true;
 sObj.doPlugins = assetAnalytics.core.updateContextData;
}
 else {
 _satellite.notify('assetAnalytics not available. Consider updating the Custom Page Code', 4);
 }
})();

Regel 2: Bildverfolgung — Aktion 2 (image-tracker.js)

/*
 * AEM Asset Insights
 */

document.querySelectorAll('[data-aem-asset-id]').forEach(function(element) {
    assetAnalytics.core.assetLoaded(element);
    var parent = element.parentElement;
    if (parent.nodeName == "A") {
        parent.addEventListener("click", function() {
            assetAnalytics.core.assetClicked(this)
        });
    }
});
  • assetAnalytics.core.assetLoaded() : wird beim Abschluss des Seitenladevorgangs aufgerufen und ist Trigger Asset Impressions für alle nachverfolgten Bilder
  • Analytics-Variable, die die geladene Asset-Liste enthält: contextData['c.a.assets.idList']
  • assetAnalytics.core.assetClicked() : wird aufgerufen, wenn das Asset-DOM-Element über ein Anker-Tag mit einem gültigen href-Wert verfügt. Wenn auf ein Asset geklickt wird, wird ein Cookie mit der angeklickten Asset-ID als Wert erstellt.(Cookie-Name: a.assets.clickedid)
  • Analytics-Variable, die die geladene Asset-Liste enthält: contextData['c.a.assets.clickedid']
  • Ursprungsquelle : contextData['c.a.assets.source']

Debugging-Anweisungen für Konsolen

//Launch Build Info
_satellite.buildInfo

//Enables debug messages
_satellite.setDebug(true);

//Asset Insight JS Object
assetAnalytics

//List of trackable images
document.querySelectorAll(".cmp-image__image");

Im Video werden zwei Google Chrome-Browsererweiterungen als Möglichkeiten zum Debugging von Analytics referenziert. Ähnliche Erweiterungen sind auch für andere Browser verfügbar.

Mit der folgenden Chrome-Erweiterung ist es auch möglich, DTM in den Debug-Modus zu wechseln: Launch und DTM Switch. Dies erleichtert die Überprüfung von Fehlern bei der DTM-Bereitstellung. Darüber hinaus können Sie DTM über alle Browser Entwicklertools -> JS Console manuell in den Debugging-Modus wechseln, indem Sie das folgende Snippet hinzufügen:

Teil 5: Testen von Analytics-Tracking und Synchronisierung von Insight-Daten

Konfigurieren AEM Asset Reporting Sync Job Scheduler und Assets Insights Report

Auf dieser Seite