[Integration]{class="badge positive"}

Einrichten von Asset Insights mit AEM Assets und Tags

[AEM Assets as a Cloud Service, AEM Assets 6.5]{class="badge informative"}

In dieser fünfteiligen Videoreihe führen wir Sie durch die Einrichtung und Konfiguration von Asset Insights für mit Tags durchgeführte Experience Manager-Bereitstellungen.

Teil 1: Überblick über Asset Insights overview

Überblick über Asset Insights Installieren Sie die Kernkomponenten, die Beispielbildkomponente und andere Inhaltspakete, um Ihre Umgebung einsatzbereit zu machen.

Architekturdiagramm architecture-diagram

In dem Video werden die Kernkomponenten v2.2.2 verwendet, die nicht mehr der neuesten Version entsprechen. Stellen Sie sicher, dass Sie die neueste Version nutzen, bevor Sie zum nächsten Abschnitt gehen.

Teil 2: Aktivieren von Asset Insights-Tracking für die Beispielbildkomponente sample-image-component-asset-insights

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.

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

Teil 3: Adobe Analytics – Erstellen einer Report Suite, Aktivieren der Echtzeit-Datenerfassung und von AEM Assets-Reporting adobe-analytics-asset-insights

Zum Asset-Tracking wird eine Report Suite mit Echtzeit-Datenerfassung erstellt. Die AEM Assets Insights-Konfiguration wird mit Adobe Analytics-Anmeldeinformationen eingerichtet.

Für die AEM Assets Insights-Konfiguration sind die folgenden Anmeldeinformationen erforderlich:

Teil 4: Verwenden von Tags zum Hinzufügen der Adobe Analytics-Erweiterung part-using-launch-by-adobe-for-adding-adobe-analytics-extension

Hinzufügen der Adobe Analytics-Erweiterung, Erstellen von Seitenladeregeln und Integrieren von AEM mit Tags in das technische Adobe IMS-Konto:

Regel 1: Seitenverfolgung (pagetracker.js) rule-page-tracker-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>

Mit der Seitenverfolgung werden zwei Rückrufe implementiert (registriert in asset-embed-code).

Schließlich wird mit der Seitenverfolgung eine Initialisierungsfunktion implementiert.

Regel 2: Bildverfolgung – Aktion 1 (asset-insights.js) rule-image-tracker-action-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) rule-image-tracker-action-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)
        });
    }
});

Konsolen-Debug-Anweisungen console-debug-statements

// Tags build info
_satellite.buildInfo

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

//Asset Insight JavaScript Object
assetAnalytics

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

Im Video wird auf zwei Google Chrome-Browser-Erweiterungen als Möglichkeit zum Debugging von Analytics verwiesen. Ähnliche Erweiterungen sind auch für andere Browser verfügbar.

Teil 5: Testen der Analytics-Verfolgung und Synchronisieren von Insights-Daten analytics-tracking-asset-insights

Konfigurieren des AEM Asset Reporting-Synchronisationsauftragsplaners und des Assets Insights-Berichts