Configure Experience Manager for smart tagging of assets

Tagging assets with taxonomy-controlled vocabulary ensures that the assets can be easily identified and retrieved by tag-based searches. Adobe provides Smart Tags that uses artificial intelligence and machine learning algorithms to train images. Smart Tags uses an artificial intelligence framework of Adobe Sensei to train its image recognition algorithm on your tag structure and business taxonomy.

The Smart Tags functionality is available for purchase as an add-on to Experience Manager. After you purchase, an email is sent to the administrator of your organization with a link to Adobe Developer Console. The administrator accesses the link to integrate the Smart Tags with Experience Manager using Adobe Developer Console.

IMPORTANT

The new Experience Manager Assets deployments are integrated with Adobe Developer Console by default. It helps configure the smart tags functionality faster. On the existing deployments, administrators follow these steps to configure it.

Integrate with Adobe Developer Console

Before you can tag the images using SCS, integrate Adobe Experience Manager with the Smart Tags service using Adobe Developer Console. At the back end, the Experience Manager server authenticates your service credentials with the Adobe Developer Console gateway before forwarding your request to the service.

Prerequisites for Adobe Developer Console integration

Before you can use the Smart Tags, ensure the following to create an integration on Adobe Developer Console:

  • An Adobe ID account that has administrator privileges for the organization.
  • The Smart Tags is enabled for your organization.

Obtain a public certificate

A public certificate allows you to authenticate your profile on Adobe Developer Console. You create a certificate from within Experience Manager.

  1. In the Experience Manager user interface, access Tools > Security > Adobe IMS Configurations.

  2. On the Adobe IMS Configurations page, click Create. From Cloud Solution menu, select Smart Tags.

  3. Select Create new certificate. Provide a name and click Create certificate. Click OK.

  4. Click Download Public Key.

    Experience Manager Smart Tags create public key

Create an integration

To use Smart Tags, create an integration in Adobe Developer Console to generate API Key, Technical Account Id, Organization Id, and Client Secret.

  1. Access https://console.adobe.io in a browser. Select the appropriate account and verify that the associated organization role is system administrator.

  2. Create a project with any desired name. Click Add API.

  3. On the Add an API page, select Experience Cloud and select Smart Content. Click Next.

  4. Select Upload your public key. Provide the certificate file downloaded from Experience Manager. A message Public key(s) uploaded successfully is displayed. Click Next.

  5. Create a new Service Account (JWT) credential page displays the public key for the service account just configured. Click Next.

  6. On the Select product profiles page, select Smart Content Services. Click Save configured API. A page displays more information about the configuration. Keep this page open to copy and add these values in Experience Manager when further configuring Smart Tags in Experience Manager.

    In the Overview tab, you can review the information provided for integration.

Configure Smart Tags

To configure the integration, use the values of Payload, Client Secret, Authorization Server, and API key fields from the Adobe Developer Console integration.

  1. In the Experience Manager user interface, access Tools > Security > Adobe IMS Configurations.
  2. Access Adobe IMS Technical Account Configuration page, provide a desired Title.
  3. In Authorization Server field, provide https://ims-na1.adobelogin.com URL.
  4. In API Key field, provide Client ID from the Adobe Developer Console.
  5. In Client Secret field, provide the Client Secret from the Adobe Developer Console. Click Retrieve Client Secret option to see it.
  6. In Adobe Developer Console, in your project, click Service Account (JWT) from the left margin. Click Generate JWT tab. Click Copy to copy the displayed JWT Payload. Provide this value in the Payload field in Experience Manager. Click Create.

Validate the configuration

After you’ve completed the configuration, follow these steps to validate the configuration.

  1. In the Experience Manager user interface, access Tools > Security > Adobe IMS Configurations.

  2. Select the Smart Tags configuration. Click Check Health from the toolbar. Click Check. A dialog with Healthy configuration message confirms that the configuration is working.

Validate Smart Tags configuration

Reconfigure if a certificate expires

When the certificate expires it is no longer trusted. To add a new certificate, follow these steps. You cannot renew an expired certificate.

  1. Log in your Experience Manager deployment as an administrator. Click Tools > Security > Users.

  2. Locate and click dam-update-service user. Click on Keystore tab.

  3. Delete the existing similaritysearch keystore with the expired certificate. Click Save & Close.

    Delete existing similaritysearch entry in Keystore to add a new security certificate

    Figure: Delete the existing similaritysearch entry in Keystore to add a new security certificate.

  4. In the Experience Manager user interface, access Tools > Security > Adobe IMS Configurations. Open the available Smart Tags configuration. To download a public certificate, click Download Public Certificate.

  5. Access https://console.adobe.io and navigate to the existing service in the Project. Upload the new certificate and configure. For more information on configuration, see the instructions in Create Adobe Developer Console integration.

Enable smart tagging for newly uploaded assets (Optional)

  1. In Experience Manager, go to Tools > Workflow > Models.

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

  3. Click Edit from the toolbar.

  4. Expand the Side Panel to display the steps. Drag Smart Tag Asset step that is available in the DAM Workflow section and place it after the Process Thumbnails step.

    Add smart tag asset step after the process thumbnail step in the DAM Update Asset workflow

    Figure: Add smart tag asset step after the process thumbnail step in the DAM Update Asset workflow.

  5. Open the step to configure. Under Advanced Settings, ensure that the Handler Advance option is selected.

    Setting for handler to advance to the next step in the workflow.

  6. In the Arguments tab, select Ignore Errors if you want the workflow to ignore failures when predicting tags. To tag assets when they are uploaded irrespective of whether smart tagging is enabled on folders, select Ignore Smart Tag Flag.

  7. Click OK to close the process step, and then save the workflow. Click Sync.

On this page