[AEM Assets]{class="badge positive" title="Applies to AEM Assets)."}
Assets Insights asset-insights
Assets Insights functionality lets you track usage statistics of images that are used in third-party websites, marketing campaigns, and Adobe’s creative solutions. It helps provide insights about performance and popularity of the images.
Assets Insights captures user activity details, such as the number of times an image is clicked and impressions (number of times an image is loaded on the website). It assigns scores to images based on these statistics. You can use the scores and performance statistics to select popular images for inclusion in catalogs, marketing campaigns, and so on. You can even formulate archival and license renewal policies based on these statistics.
Assets Insights now supports Adobe Analytics 2.0 API
Assets Insights in AEM Admin View now supports the Adobe Analytics 2.0 API with OAuth Server-to-Server authentication, enabling continued access to current asset usage insights following the retirement of the Adobe Analytics 1.4 API. You can reconfigure Assets Insights integration to resume synchronization of impressions and clicks from Adobe Analytics, including data collected during the transition period, without losing existing insights data.
You must have an Adobe Analytics license to use this feature.
View statistics for an image viewing-statistics-for-an-image
You can view the Assets Insights scores from the metadata page.
-
From the Assets user interface, select the image and then click Properties from the toolbar.
-
From the Properties page, click Insights.
-
Review the usage details for the asset in the Insights tab. The Score section describes the total asset usage and performance scores of an asset.
Usage score describes the number of times an asset is used in various solutions.
The Impressions score is the number of times the asset is loaded on the website. The number displayed under Clicks is the number of times the asset is clicked.
-
Review the Usage Statistics section to know which entities the asset was part of and which creative solutions recently used it. The higher the usage, the greater the chances that the asset is popular among users. Usage data is displayed under the following heads:
-
Asset: The number of times the asset was part of a collection or compound asset.
-
Web & Mobile: The number of times the asset was part of websites and apps.
-
Social: The number of times the asset was used in other solutions such as a Adobe Campaign.
-
Email: The number of times the asset was used in email campaigns.
note NOTE Because the Assets Insights feature typically fetches the Solutions data from Adobe Analytics in a periodic manner, the Solutions section may not display the most recent data. The time period for which the data is displayed depends the schedule of the fetch operation that Assets Insights runs to retrieve Analytics data. -
-
To view performance statistics for the asset graphically over a period of time, select period in the Performance Statistics section. Details, including clicks and impressions are displayed as trend lines of a graph.
note NOTE Unlike the data in the Solutions section, the Performance Statistics section displays the most recent data. -
To obtain the embed code for the asset that you include in websites to get performance data, click Get Embed Code below the asset thumbnail.
View aggregate statistics for images viewing-aggregate-statistics-for-images
You can view scores of all assets within a folder simultaneously using Insights View.
-
In the Assets user interface, navigate to the folder containing the assets for which you want to view insights.
-
Click the Layout option from the toolbar, and then choose Insights View.
-
The page displays usage scores for the assets. Compare the ratings of the various assets and draw insights.
Impact of the Adobe Analytics API retirement api-retirement-impact
Configure Assets Insights configure-assets-insights
Experience Manager Assets fetches usage data around digital assets used by third-party websites from Adobe Analytics. To enable Assets Insights to retrieve this data and generate insights, configure the integration with Adobe Analytics using an Adobe IMS Configuration and an OAuth Server-to-Server credential.
Prerequisites prerequisites
Before configuring Assets Insights, ensure that the following requirements are met:
- Your AEM as a Cloud Service environment has received the update that provides the Asset Insights Cloud Solution.
- AEM Assets Reporting is enabled for the Adobe Analytics report suite used for Assets Insights.
- You have an active Adobe Analytics entitlement.
- You have access to Adobe Developer Console and can create an OAuth Server-to-Server credential.
Create an OAuth Server-to-Server credential create-oauth-credential
-
Create an OAuth Server-to-Server credential in Adobe Developer Console.
-
Open an existing project for the IMS Org used with Adobe Analytics, or create a new project.
-
Add the Adobe Analytics API to the project.
-
Select OAuth Server-to-Server as the credential type. Do not create a new Service Account (JWT) credential for this integration.
-
Open the credential details and securely save the Client ID, Client Secret, and Scopes values.
-
Confirm that the IMS Org has an active Adobe Analytics entitlement and that the credential has access to the required report suite.
-
Create the Adobe IMS Configuration in AEM create-ims-configuration
-
In Experience Manager, click Tools > Cloud Services > Adobe IMS Configurations > Create.
-
For Cloud Solution, select Asset Insights.
note NOTE If Asset Insights is not available as a Cloud Solution, your AEM as a Cloud Service environment may not yet have received the update that introduces the new integration. Confirm that the required update is available in your environment. Do not create a new legacy configuration. -
Enter the values from the OAuth Server-to-Server credential that you created in Adobe Developer Console:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Field Value Auth Server https://ims-na1.adobelogin.comClient ID Client ID from Adobe Developer Console Client Secret Client Secret from Adobe Developer Console Scopes Scopes copied from the credential details -
Click Save, then use Check Health to confirm that the configuration authenticates successfully through Adobe IMS.
Configure Assets Insights with the IMS integration configure-assets-insights-ims-integration
-
In Experience Manager, click Tools > Assets > Insights Configuration.
-
For IMS Configuration, select the Adobe IMS Configuration that you created in the previous step.
-
In Analytics Company, enter the Adobe Analytics Global Company ID.
note NOTE The Global Company ID is different from the company display name used in the legacy Assets Insights configuration. Do not enter the company display name in this field. Using the display name instead of the Global Company ID can result in an empty report suite list. -
Select the Report Suite used for Assets Insights.
-
If required, enter the Tracking Server and Secure Tracking Server values. If your tag management solution already sends Adobe Analytics beacons, you can leave these fields blank.
-
Click Done to save the configuration.
For more information, see Adobe Analytics Web Services.
Enable AEM Assets Reporting enable-aem-assets-reporting
The Adobe Analytics report suite used for Assets Insights must have AEM Assets Reporting enabled.
-
In Adobe Analytics, go to Admin > Report Suites.
-
Select the report suite used for Assets Insights.
-
Select Edit Settings > AEM > AEM Assets Reporting.
-
Confirm that AEM Assets Reporting is enabled.
This setting provisions the Analytics dimensions and events used for asset impressions, clicks, and asset identifiers.
Verify the configuration and data flow verify-configuration-data-flow
After configuring Assets Insights:
-
Verify that the Adobe IMS Configuration Check Health action succeeds.
-
Confirm that the expected report suite is selected in Insights Configuration.
-
Verify that your existing website instrumentation continues to send asset impressions and clicks to Adobe Analytics.
-
Allow the next scheduled synchronization to complete. Assets Insights synchronizes data daily and can take up to 24 hours to reflect newly available data.
-
After reconfiguration, the next synchronization retrieves available insights data, including data collected during the period when AEM could not retrieve data through the retired API.
-
Open an image asset in Experience Manager and review its Insights tab.
If your existing website instrumentation already sends asset impressions and clicks correctly, you do not need to replace it as part of this configuration change.
Page Tracker page-tracker
After you configure Assets Insights, the Page Tracker code is available for download. To enable Assets Insights to track Experience Manager assets used on third-party websites, include the Page Tracker code in the website code.
The Page Tracker and asset tracking implementation are separate from the Adobe IMS authentication configuration described in Configure Assets Insights. If your website is already instrumented for Assets Insights and successfully sends asset impressions and clicks to Adobe Analytics, you do not need to change the existing tracking implementation as part of this configuration update.
-
In Experience Manager, click Tools > Assets.
-
From the Navigation page, click the Insights Page Tracker card.
-
Click Download to download the page tracker code.
Troubleshooting troubleshooting-assets-insights
The Asset Insights Cloud Solution is not available
If Asset Insights is not available when you create an Adobe IMS Configuration, your AEM as a Cloud Service environment may not yet include the update that introduces the new integration.
Confirm that the required AEM update is available in your environment. Do not create another legacy configuration. If the option remains unavailable after the required update is available, contact Adobe Support.
Check Health fails
Verify the following:
-
The Client ID and Client Secret match the OAuth Server-to-Server credential in Adobe Developer Console.
-
The credential uses OAuth Server-to-Server authentication.
-
The scopes were copied exactly from the credential details.
-
The Adobe Analytics API was added to the Developer Console project.
-
The IMS Org has an active Adobe Analytics entitlement.
The report suite list is empty
Verify the following:
-
The Analytics Company value is the Global Company ID, not the company display name.
-
The OAuth credential has access to the target report suite.
-
The IMS Org in Adobe Developer Console is associated with the Analytics company.
-
AEM Assets Reporting is enabled for the report suite.
AEM is not showing current data
After completing the configuration:
-
Allow up to 24 hours for the scheduled synchronization.
-
Confirm that new asset impressions or clicks are visible in Adobe Analytics.
-
Confirm that the asset identifier is being sent by the existing tracking implementation.
-
Confirm that the selected report suite is the one receiving the asset activity.
Frequently asked questions frequently-asked-questions-assets-insights
Will asset impressions and clicks stop being collected?
No. The retirement affects the legacy AEM-to-Adobe Analytics retrieval path. Existing website instrumentation continues to send asset activity to Adobe Analytics.
Will data be lost?
No. Existing data is not deleted. Data collected during the temporary gap remains available in Adobe Analytics and can be retrieved by AEM after the new configuration is completed and synchronization resumes.
Does Assets Insights automatically switch to the new configuration?
No. After the required AEM update is available, you must manually create the Adobe IMS Configuration and update the Assets Insights configuration to use it.
Are Assets View Insights affected?
No. This change applies to Assets Insights in AEM Admin View. Assets View Insights is not affected by this integration change.
Are Adobe Analytics reports affected?
No. Adobe Analytics continues to receive and store the collected data. The change affects the retrieval and display of refreshed insights data in AEM Admin View.
See also
- Translate Assets
- Assets HTTP API
- Assets supported file formats
- Search assets
- Connected assets
- Asset reports
- Metadata schemas
- Download assets
- Manage metadata
- Manage Dynamic Media templates
- Manage reports in Assets view
- Search facets
- Manage collections
- Bulk metadata import
- Publish Assets to AEM and Dynamic Media