You're viewing help content for version:

You can integrate Adobe Experience Manager (AEM) with the Smart Tags cloud service using the Adobe IO unified developer portal (UDP).

First, create a Smart Tags cloud service configuration in AEM to generate a public key. Next, create an integration in Adobe IO UDP and upload this public key. Then, configure your AEM instance using the API key and other credentials that you obtain from the UDP.

Use this configuration to access the Smart Tags cloud service from within AEM. At the back end, the AEM server authenticates your cloud service credentials with the Adobe IO gateway before forwarding your request to the Smart Tags cloud service.

Here are the key tasks for configuring the Smart Tags cloud service:

  • Obtaining public certificate for OAuth integration
  • Creating UDP integration
  • Configuring the AEM instance


Before you can use the Smart Tags cloud service, ensure the following:

  • Your organization is provisioned in Adobe Marketing Cloud.
  • You have an Adobe ID account that has administrator privileges for the organization.
  • The AEM Assets Smart Tags service is enabled for your organization.
  • You have installed the latest service pack for AEM 6.3.

If you believe you haven't fulfilled one or more of these prerequisites, contact Adobe for assistance.

Obtaining public certificate

Before you can create an integration profile in UDP, obtain a public certificate that UPD uses to authenticate your profile. Perform these steps:

  1. From the AEM user interface, tap the AEM logo, and go to Tools > Deployment > Cloud Services.

  2. In the Cloud Services page, tap/click Configure now under Assets Smart Tags.

  3. In the configuration dialog, specify a title and name for the smart tags configuration, and the tap/click Create.

  4. In the AEM Smart Content Service dialog, use the values present in the following fields as is:

    Service URL

    Authorization Server

    Leave the other fields blank and tap/click OK.

  5. Tap/click Download Public Certificate for OAuth Integration, and download the public certificate file AEM-SmartTags.crt.


Creating UDP integration

To be able to use Smart Tags cloud service APIs, create an integration within UDP to generate information, such as API Key, Technical Account Id, Organization Id, and Client Secret.


You require system administrator rights in the Marketing Cloud organization to be able to create UDP integration.

  1. Access UDP from

  2. From the Integrations page, select your organization.

  3. Tap/click New Integration.

  4. In the Create a new integration page, select Access an API, and tap/click Continue.

  5. Under Experience Cloud, select Smart Content, and then tap/click Continue.

  6. In the next page, select New integration and tap/click Continue.

  7. In the Integration Details page,  specify a name for the integration gateway and add a description.

  8. Upload the public certificate file AEM-SmartTags.crt that you downloaded in Obtaining public certificate.


  9. Tap/click Create Integration.

  10. To view integration information, tap/click Continue to integration details.


    Use the values for Technical Account ID, Organization Id, Client Secret, Authorization Server, and API key to configure Smart Tags cloud service in AEM.

Configure Assets Smart Tags cloud service

After you generate the authentication details from UDP, use them to configure the Smart Tags cloud service in your AEM instance. Creating a Smart Tags cloud configuration lets UDP authenticate API requests from the AEM instance. To configure the integration in AEM, perform these tasks:

  • Configure the Smart Tags cloud service in AEM
  • Enable auto-tagging in the Update Asset workflow

Configuring the Smart Tags cloud service in AEM


If you are running an AEM 6.2 instance, you are required to download a feature pack. For details around obtaining the feature pack, contact Adobe Support.

  1. From the AEM user interface, tap/click the AEM logo and navigate to Tools > Deployment > Cloud Service to open the Cloud Services console.

  2. Under the Assets Smart Tags service, open the smart tags configuration you created in Obtaining public certificate.

  3. In the AEM Smart Content Service dialog, use the prepopulated values for the Service URL and Authorization Server fields.

  4. For the fields API Key, Technical Account Id, Organization Id, and Client Secret, use the values you generated in step 10 of UDP Integration.

Enable smart tagging in the Update Asset workflow

  1. From the AEM user interface, tap/click the AEM logo, and go to Tools > Workflow > Models.

  2. From the Models page, select the DAM Update Asset workflow model.

  3. Tap/click Edit from the toolbar.

  4. Drag Smart Tag Asset Process (available under the DAM Workflow section) from side kick, and place it below the Process Thumbnails step.

  5. Open the step in edit mode. Under Advanced Settings, ensure that the Handler Advance option is selected.

  6. In the Arguments tab, select Ignore Errors if you want the workflow to complete even if the automatic tagging step fails.


    To tag assets when they are uploaded irrespective of whether smart tagging is enabled on folders, select Ignore Smart Tag Flag.

  7. Tap/click OK to close the process step, and then save the workflow.

Creating Oak indexes

If you upgrade from AEM 6.1 to AEM 6.3, you require to manually create oak indexes for smart tags. AEM 6.3 includes these indexes out of the box.

  1. Open the CRX repository.

  2. Navigate to the node /oak:index/damAssetLucene/indexRules/dam:Asset/properties.

  3. Using the index structure specified in the attached XML file as reference, create the following nodes and configure their properties as mentioned below:


    • simsearchVersion
      • jcr: primaryType: nt:unstructured
      • name: jcr:content/metadata/simsearchVersion
      • nullCheckEnabled: true
      • propertyIndex: true
    • predictedTags
      • index: true
      • isRegexp: true
      • jcr:primaryType: nt:unstructured
      • name: jcr:content/metadata/predictedTags/*/name
      • propertyIndex: false
    • predictedTagsConfidence
      • index: true
      • isRegexp: true
      • jcr:primaryType: nt:unstructured
      • name: jcr:content/metadata/predictedTags/*/confidence
      • propertyIndex: false


  4. Navigate to /oak:index/ntBaseLucene/indexRules/nt:base/properties/, create a node damAutoTag, and configure its properties as mentioned below:

    • jcr:primaryType: nt:unstructured
    • name: jcr:content/autotag 
    • ordered: false
    • propertyIndex: true
    • type: Boolean
  5. Save the changes.

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy