[Integratie]{class="badge positive"}

Asset Insights instellen met AEM Assets en tags

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

In deze videoreeks van vijf delen, laten we door de opstelling en configuratie van de Inzichten van Activa voor Experience Manager lopen die via markeringen wordt opgesteld.

Deel 1: Overzicht van asset Insights overview

Overzicht van Asset Insights. Installeer Core Components, Sample Image Component en andere inhoudspakketten om uw omgeving gereed te maken.

Architectuurdiagram architecture-diagram

Architectuurdiagram

CAUTION
Zorg ervoor dat u de nieuwste versie van Core Components voor uw implementatie.

De video gebruikt Core Components v2.2.2. Dit is niet de nieuwste versie. Gebruik de nieuwste versie voordat u verdergaat met de volgende sectie.

Deel 2: Asset Insights Tracking inschakelen voor voorbeeldafbeeldingscomponent sample-image-component-asset-insights

Verbeteringen aan de componenten van de Kern en het gebruiken van volmachtscomponent (de Component van het Beeld van de Steekproef) voor de Inzichten van Activa. Het sjabloonbeleid voor de inhoudspagina bewerken om de voorbeeldafbeeldingscomponent in te schakelen voor de verwijzingssite.

NOTE
De component Image Core bevat de mogelijkheid om UUID-tracking uit te schakelen door het bijhouden van de UUID van het element uit te schakelen (unieke id-waarde voor een knooppunt dat binnen JCR is gemaakt)

De component Core Image gebruikt data-asset-id attribuut binnen het bovenliggende element <div> van een afbeeldingstag om deze functie in of uit te schakelen. Proxy-component negeert de kerncomponent met de volgende wijzigingen.

  • Hiermee verwijdert u de data-asset-id van de bovenliggende div van een <img> element in image.html
  • Toevoegingen data-aem-asset-id rechtstreeks naar het <img> element in image.html
  • Toevoegingen data-trackable='true' waarde voor het <img> element in image.html
  • data-aem-asset-id en data-trackable='true' op hetzelfde knooppuntniveau worden gehouden
NOTE
data-aem-asset-id='image.UUID' en data-trackable='true' Dit zijn de belangrijkste kenmerken die aanwezig moeten zijn voor Asset Impressions. Voor Asset Click Insights moet de bovenliggende tag, naast de bovenstaande gegevenskenmerken in de <img> tag, een geldige href-waarde hebben.

Deel 3: Adobe Analytics — Report Suite maken, gegevensverzameling in realtime mogelijk maken en AEM Assets-rapportage adobe-analytics-asset-insights

De reeks van het rapport met gegevensinzameling in real time wordt gecreeerd voor activa het volgen. AEM Assets Insights-configuratie wordt ingesteld met Adobe Analytics-referenties.

NOTE
Real-Time gegevensverzameling en AEM Asset Reporting moeten zijn ingeschakeld voor uw Adobe Analytics Report Suite. Het toelaten AEM de variabelen van de reserveanalyse van Activa het Rapporteren van Activa voor het volgen van activainzichten.

Voor de configuratie van AEM Assets Insights hebt u de volgende referenties nodig

  • Datacenter
  • Naam van analysebedrijf
  • Gebruikersnaam voor Analytics
  • Gedeeld geheim (kan worden verkregen van Adobe Analytics > Admin > Company Settings > Web Service).
  • Rapportsuite (zorg dat u de juiste rapportsuite selecteert die wordt gebruikt voor Asset Reporting)

Deel 4: Tags gebruiken om Adobe Analytics-extensie toe te voegen part-using-launch-by-adobe-for-adding-adobe-analytics-extension

Adobe Analytics-extensie toevoegen, regels voor het laden van pagina's maken en AEM integreren met tags met de technische account van Adobe IMS.

NOTE
Zorg ervoor dat u al uw wijzigingen van de auteur naar de publicatie-instantie dupliceert.

Regel 1: Paginanummering (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>

Paginacontracker implementeert twee callbacks (geregistreerd in asset-embed-code)

  • &lt;code>assetAnalytics.core.assetLoaded&lt;code> : wordt aangeroepen wanneer de gebeurtenis 'load' wordt verzonden voor het element asset-DOM-element.
  • &lt;code>assetAnalytics.core.assetClicked&lt;code> : Wordt aangeroepen wanneer de gebeurtenis 'click' wordt verzonden voor het element asset-DOM-is dit alleen relevant wanneer het element asset-DOM-element een ankertag heeft als bovenliggend element met een geldig extern kenmerk 'href'

Tot slot implementeert Paginacontracker een initialisatiefunctie als.

  • &lt;code>assetAnalytics.dispatcher.init()&lt;code> : wordt aangeroepen om de component Page tracker te initialiseren. Dit DIENT te worden aangeroepen voordat een van de gebeurtenissen asset-inzichten-events (Impressions and/or Clicks) op de webpagina wordt gegenereerd.
  • &lt;code>assetAnalytics.dispatcher.init()&lt;code> : accepteert optioneel een object AppMeasurement — indien opgegeven, wordt niet geprobeerd een instantie van object AppMeasurement te maken.

Regel 2: Afbeeldingsbeheer — Actie 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: Afbeeldingsbeheer — Handeling 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() : wordt aangeroepen tijdens het laden van de pagina en activeert Asset Impressions voor alle trackable images
  • Analysevariabele die de geladen elementenlijst draagt: contextData['c.a.assets.idList']
  • assetAnalytics.core.assetClicked() : wordt aangeroepen wanneer het element element element element element element element element element element van elementDOM een ankertag met geldige href-waarde heeft. Wanneer op een element wordt geklikt, wordt een cookie gemaakt met de waarde van het aangeklikte element-id.(Naam cookie: a.assets.clickdid)
  • Analysevariabele die de geladen elementenlijst draagt: contextData['c.a.assets.clickdid']
  • Oorsprong: contextData["c.a.assets.source"]

Foutopsporingsinstructies voor console 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");

Twee Google Chrome-browserextensies worden in de video gebruikt als manieren om fouten op te sporen in Analytics. Soortgelijke extensies zijn ook beschikbaar voor andere browsers.

Deel 5: Testen van gegevens over het analytisch bijhouden en synchroniseren van het inzicht analytics-tracking-asset-insights

Rapport AEM Asset Reporting Job Scheduler en Assets Insights-rapporten configureren

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