Log in to Adobe Analytics (either via a marketing cloud org or via sc.omniture.com)
Environment
AEM 6.2
Steps
I. Configure Adobe Analytics:
-
-
Go to Admin => Report Suites
-
Create a Report Suite for Asset Insights
-
Select the new Report Suite and go to Edit Settings => Conversion => Conversion Variables
-
Add eVar3 (See evar3 screenshot [3]) and save
-
Go to Edit Settings => Conversion => Success Events
-
Configure event7 and event8 (See screenshot event vars [4]) and save
-
Go to Edit Settings => Conversion => List Variables
-
Configure list1 (See screenshot [5] below) and save
-
On the same Report Suites screen above, select your report suite again
-
Go to Edit Settings => Real-Time
-
Turn on Enable Real-Time
-
Step text
-
Step text
II. Configure AEM:
-
Go to this URL in AEM: /mnt/overlay/dam/gui/content/assetinsights/wizard/configure.html
-
Enter the credentials, authorize, set the report suite to the one you created earlier and use the default configuration (see asset insights config [6])
Asset Click Success Event Name *
event7
Asset Click eVar *
eVar3
Asset Impression Success Event Name *
event8
Asset Impression listVar *
listvar1
หมายเหตุ:For the list var, on AEM, the variable would always be referred to as listvar# and on Analytics, it would list#.
-
Go to /crx/packmgr/index.jsp
-
Upload and install the package "insightsDemo.zip"
III. Generate Traffic
-
Once you have it all configured, then you should generate some traffic. In the attached zip file, find DemoSite.zip and unzip the contents.
-
Open index.html in a text editor
-
Search and replace all occurrences of "http://localhost:4502/" in the html with the base url to your test site, for example: http://dev-aem-author:4502/
-
Go to line 15
assetAnalytics.dispatcher.init("","","","listvar1", "eVar3", "event8","event7");
-
Update the code with your own site's report suite, API host, and variables. For example, see below (replace with your Asset Insights report suite and with your analytics company id:
assetAnalytics.dispatcher.init("",".or1.sc.omtrdc.net","","listvar1", "eVar3", "event8","event7");
-
Open index.html in a browser, if all goes well, then this would generate some traffic.
IV. Run the Synchronization Asset Performance Report Sync Job
Now data should be getting reported to Adobe Analytics. The next step is to get AEM to download the report data. By default AEM only downloads the data from Analytics once every night. However, you can modify the configuration to make it run more frequently. For testing purposely only, we would set it to run every minute.
-
Go to this URL on the AEM host http://aem-host:port/system/console/configMgr/com.day.cq.dam.performance.internal.AssetPerformanceReportSyncJobnal.AssetPerformanceReportSyncJob
-
Backup the default value and set this as the cron expression "0 0/1 * 1/1 * ? *" to make it run once every minute
-
Monitor the AEM logs for any errors, however, if it is working properly, then you would see this message in the logs [1]. If it fails, then you would see this message [2].
-
If the job fails then the most common cause is that the report suite got unset. Go here to set the report suite id again: http://aem-host:port/etc/cloudservices/sitecatalyst/assetinsights/performance.html
See the documentation page for 6.2 Asset Insights for more details:
https://docs.adobe.com/docs/en/aem/6-2/author/assets/managing-assets-touch-ui/asset-insights.html
[1]
15.07.2017 00:32:14.199 *INFO* [sling-default-2583-com.day.cq.dam.performance.internal.AssetPerformanceReportSyncJob.39255] com.day.cq.dam.performance.internal.AssetPerformanceReportSyncJob Asset Insight report sync from SiteCatalyst completes.
[2]
27.06.2017 22:39:01.788 *ERROR* [sling-default-9186-com.day.cq.dam.performance.internal.AssetPerformanceReportSyncJob.7035] com.day.cq.dam.performance.internal.AssetPerformanceReportSyncJob Exception while syncing the report from SC
[3] events screenshot
[4] eVar screenshot
[5] list-var screenshot
[6] asset insights
You can download the zip files(insightsDemo.zip,DemoSite.zip) by going to the Demo Package page.