Prezeráte obsah pomocníka verzie:

If you are an Adobe Marketing Cloud customer, you can integrate with the Unified Developer portal (UDP) to utilize the Smart Tagging cloud service from within Adobe Experience Manager (AEM).

First, create an integration public key in UDP using a public gateway. Next, create a profile at your AEM instance using the appplication ID that you obtain from the gateway.

Use this configuration to utilize UDP APIs for the Smart Tagging cloud service within AEM. At the backend, the AEM server authenticates your profile with the gateway and then allocates a port to communicate with UDP.

Here are the key tasks involved in configuring the Smart Tagging cloud service:

  • Creating UDP integration
  • Configuring AEM instance
  • Optional settings

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

  • You must have your organization provisioned in Adobe Marketing Cloud.
  • You must have an AdobeID account that has Administrator privileges on this organization.
  • AEM Assets Smart Tags Service is enabled for your organization.

If you think you have one or more of these prerequisites missing, contact Adobe to fulfill the requirements.

Creating UDP Integration

To be able to use Smart Tagging cloud service APIs, first create an integration within UDP to generate information, such as API Key, Technical Account Id, Organization Id, and Client Secret that you will use in your integration profile within AEM.

Poznámka:

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

  1. Access UDP from https://www.adobe.io/console.

    chlimage_1
  2. From the Integrations page, select your organization.

    chlimage_1
  3. Tap/click New Integration.

  4. In the Create a new integration page, tap/click Continue.

  5. Select Smart Content, and then tap/click Continue.

    chlimage_1
  6. In the next page, tap/click Continue

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

    chlimage_1
  8. Use the following command to create a public key:

      openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout private.key -out smart-tags-adobe-io.crt

    For more information around how to create public keys, see Creating a self-signed certificate.

  9. Upload the file smart-tags-adobe-io to the integration service.

    chlimage_1
  10. Tap/click Create Integration. The integration is created.

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

    chlimage_1

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

Configure Assets Smart Tagging Cloud Service

After you generate the authentication details from UDP, use them to configure Smart Tagging cloud service in your AEM instance. Creating an Smart Tagging cloud configuration lets UDP authenticate API requests from AEM instance. Configuring the integration in AEM includes:

  • Enabling the AEM Smart Tag Assets feature flag
  • Configuring the Smart Tagging cloud service in AEM
  • Enabling auto-tagging in the Update Asset workflow 

Enabling the AEM Smart Tag Assets feature flag

  1. Access Configuration Manager from http://<Server>:<Port>/system/console/configMgr.

  2. From the list of configurations, open the AEM Smart Tag Assets Feature Flag configuration.

  3.  Select the Is Active option.

    chlimage_1
  4. Click Save.

Configuring the Smart Tagging cloud service in AEM

Poznámka:

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 UI, navigate to Tools > Deployment > Cloud Service to open the Cloud Services console.

  2. Create a new Assets Smart Tags configuration.

  3. Set the appropriate URL for the authorization server. Use the host name for the aud key in the payload of the integration that you created earlier.

    "aud" :  "https://ims-na1.adobelogin.com" //This implies the auth server is https://ims-na1.adobelogin.com

    Poznámka:

    Enter only the first part of the URL, for example, enter “https://ims-na1.adobelogin.com” for “https://ims-na1.adobelogin.com/xxxxx."

  4. Set the other values, for example the API Key, Technical Account Id, Organization Id, and Client Secret that you generated in step 10 of UDP Integration.

  5. To create a keystore from the generated keys, run the following command:

    $ cat private.key certificate_pub.crt > private-key-crt
  6. Use the following command to set the alias as similaritysearch and a non-empty keystore password.

    $ openssl pkcs12 -export -in private-key-crt -out keystore.p12 -name similaritysearch -noiter -nomaciter

    You can validate the keystore using a tool, such as KeyStore Explorer.

  7. To add the keystore to dam-update-service, go to Tools > Security > Users and open dam-update-service.

  8. Click Create Key Store, and create a key store.

  9. Click Manage Key Store, and then click Add Private Key from Key Store file to add the keystore.p12 file.

  10. Set the key pair alias to similaritysearch.

  11. Provide the keystore password (the password you provided when generating the keystore), private key password, and the private key alias similaritysearch. Then, click Submit to import the keystore.

  12. Review the screen after the keystore is created, and verify the information from the keystore file.

Enable smart tagging in the Update Asset workflow

  1. From the AEM Assets UI, go to Tools > Workflow > Models.

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

  3. Click Edit.

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

    chlimage_1
  5. Double-click the step to edit it.

  6. Under Advanced Settings, ensure that the Handler Advance option is selected.

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

    chlimage_1

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

    chlimage_1
  8. Click OK to close the process step, and then save the workflow.

Optional Settings

You can optionally configure the following functionalities for Smart Tags cloud services within AEM:

  • Assets Smart Tags service
  • Assets Smart Tags Periodic Job

Configuring the Assets Smart Tags service

  1. Access Configuration Manager from http://<Server>:<Port>/system/console/configMgr.

  2. From the list of configurations, open Assets Smart Tags Service.

  3. Set the following parameters:

    • Indexed rendition: Can be set to any rendition type
    • max.tags.name: Maximum number of smart-tags that can be associated with an asset
    • min.tag.confidence.name: The threshold confidence level below which the tags are ignored
    chlimage_1

    Poznámka:

    To obtain an optimal threshold for your use case, Adobe encourages you to experiment with the value of min.tag.confidence.name.

  4. Save the changes.

Configure Assets Smart Tags periodic job

  1. Access Configuration Manager from http://<Server>:<Port>/system/console/configMgr.

  2. Open the Assets Smart Tags Periodic Job configuration.

  3. To trigger the smart tagging workflow on all the folders with the value of autotag set to true at the path /crx/de/index.jsp#/content/dam/{folder_path}/jcr/content, specify a valid cron job expression for scheduler.expression.name.

    chlimage_1
  4. Save the changes.

Bulk smart-tagging batch size

When the periodic tagging workflow is triggered for folders that include a large number of assets, it consumes significant system resources, which can slow down other operations on your AEM instance. For optimal performance of your instance, you can configure the maxmimun number of assets that the workflow can process each time it runs. This way, you can perform other operations normally on your instance even when the periodic tagging workflow runs in the background.

  1. Access Configuration Manager from http://<Server>:<Port>/system/console/configMgr.

  2. Open the Assets Smart Tags Management Service configuration.

  3. In the Bulk Smart-tagging batch size box, specify the maximum number of assets for which the the periodic tagging workflow can apply smart tags each time it runs.

    Bulk Smart-tagging batch size
    chlimage_1
  4. Save the changes.

Creating Oak indexes

When you upgrade from AEM 6.1 to 6.3, you should manually create oak indexes for smart tags. These indexes are shipped with 6.3.

  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:

    Prevziať

    • 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

     

    jcr:content/metadata/predictedTags/*/confidence
    jcr:content/metadata/predictedTags/*/confidence
    jcr:content/metadata/predictedTags/*/confidence
    jcr:content/metadata/predictedTags/*/confidence
  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.

Licencia na používanie tohto diela sa poskytuje v súlade s podmienkami licencie Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Na príspevky v sociálnych sieťach Twitter™ a Facebook sa nevzťahujú podmienky licencií Creative Commons.

Právne upozornenia   |   Zásady ochrany osobných údajov online