[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 werden die Einrichtung und Konfiguration von Asset Insights für Experience Manager, der über -Tags bereitgestellt wird, erläutert.

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

Architekturdiagramm

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

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.

NOTE
Die bildbezogene Kernkomponente bietet die Möglichkeit, das UUID-Verfolgung zu deaktivieren, indem das Tracking der Asset-UUID (eindeutiger Kennungswert für einen innerhalb von JCR erstellten Knoten) deaktiviert wird.

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:

  • data-asset-id wird aus dem übergeordneten div eines <img>-Elements innerhalb der Datei „image.html“ entfernt.
  • data-aem-asset-id wird direkt zum <img>-Element innerhalb der Datei „image.html“ hinzugefügt.
  • Der data-trackable='true'-Wert wird zum <img>-Element innerhalb der Datei „image.html“ hinzugefügt.
  • data-aem-asset-id und data-trackable='true' werden auf derselben Knotenebene beibehalten.
NOTE
data-aem-asset-id='image.UUID' und data-trackable='true' sind die Schlüsselattribute, die für Asset-Impressions 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 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.

NOTE
Echtzeit-Datenerfassung und AEM Asset-Reporting müssen für Ihre Adobe Analytics Report Suite aktiviert sein. Durch Aktivierung der AEM Asset Reporting-Funktion werden Analytics-Variablen zum Tracking von Asset-Erkenntnissen reserviert.

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

  • Rechenzentrum
  • Analytics-Unternehmensname
  • Analytics-Benutzername
  • Gemeinsamer geheimer Schlüssel (abrufbar über Adobe Analytics > Admin > Unternehmenseinstellungen > Webservice).
  • Report Suite (die richtige, für das Asset-Reporting verwendete Report Suite auswählen!)

Teil 4: Verwendung 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 mit dem technischen Adobe IMS-Konto.

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

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

  • &lt;code>assetAnalytics.core.assetLoaded&lt;code>: Wird aufgerufen, wenn das Ladeereignis für das asset-DOM-Element gesendet wird.
  • &lt;code>assetAnalytics.core.assetClicked&lt;code>: Wird aufgerufen, wenn das Klickereignis für das asset-DOM-Element gesendet wird. Dies ist nur relevant, wenn das asset-DOM-Element über ein Anker-Tag als übergeordnetes Element mit einem gültigen, externen href-Attribut verfügt.

Schließlich wird mit der Seitenverfolgung eine Initialisierungsfunktion implementiert.

  • &lt;code>assetAnalytics.dispatcher.init()&lt;code>: Wird aufgerufen, um die Seitenverfolgungskomponente zu initialisieren. Der Aufruf muss erfolgen, bevor eines der asset-insights-Ereignisse (Impressions und/oder Klicks) von der Web-Seite generiert wird.
  • &lt;code>assetAnalytics.dispatcher.init()&lt;code>: Akzeptiert optional ein AppMeasurement-Objekt. Sofern angegeben, wird nicht versucht, eine neue Instanz des AppMeasurement-Objekts zu erstellen.

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)
        });
    }
});
  • assetAnalytics.core.assetLoaded(): Wird beim Abschluss des Seitenladevorgangs aufgerufen und löst Asset-Impressions für alle nachverfolgbaren Bilder aus.
  • 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']

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

recommendation-more-help
a483189e-e5e6-49b5-a6dd-9c16d9dc0519