Integrating with Adobe Target

As part of the Adobe Marketing Cloud, Adobe Target lets you increase content relevance through targeting and measuring across all channels. Integrating Adobe Target and AEM as a Cloud Service requires:

  • using the Touch UI to create a Target Configuration in AEM as a Cloud Service (IMS configuration required).
  • adding and configuring Adobe Target as an extension in Adobe Launch.

Adobe Launch is necessary for managing client-side properties for both Analytics and Target in AEM pages (JS libraries/tags). That said, the integration with Launch is needed for “experience targeting”. For the Experience Fragments export to Target, you only need the Adobe Target Configuration and IMS.

NOTE

Adobe Experience Manager as a Cloud Service customers who do not have an existing Target account, can request access to the Target Foundation Pack for Experience Cloud. The Foundation Pack provides volume limited use of Target.

Creating the Adobe Target Configuration

  1. Navigate to ToolsCloud Services.
    Navigation
  2. Select Adobe Target.
  3. Select the Create button.
    Create
  4. Fill in the details (see below), and select Connect.
    Connect

IMS Configuration

An IMS configuration for both Launch and Target is necessary to properly integrate Target with AEM and Launch. While the IMS configuration for Launch is preconfigured in AEM as a Cloud Service, the Target IMS configuration must be created (after Target is provisioned). Refer to this video and this page to learn how to create the Target IMS configuration.

Adobe Target Tenant ID and Adobe Target Client Code

When configuring the Adobe Target Tenant ID and Adobe Target Client Code fields, please be aware of the following:

  1. For most customers, the Tenant ID and the Client Code are the same. This means that both fields contain the same information and are identical. Make sure you enter the Tenant ID in both fields.
  2. For legacy purposes, you can also enter different values in the Tenant ID and the Client Code fields.

In both cases, be aware that:

  • By default, the Client Code (if added first) is also automatically copied into the Tenant ID field.
  • You have the option to change the default Tenant ID set.
  • Accordingly, the backend calls to Target will be based on the Tenant ID and the client side calls to Target will be based on the Client Code.

As stated previously, the first case is the most common for AEM as a Cloud Service. Either way, make sure that both fields contain the correct information depending on your requirements.

NOTE

If you want to change an existing Target Configuration:

  1. Re-enter the Tenant ID.
  2. Re-connect to Target.
  3. Save the configuration.

Editing the Target Configuration

To edit the Target configuration, follow these steps:

  1. Select an existing configuration and click Properties.
  2. Edit the properties.
  3. Select Re-connect to Adobe Target.
  4. Select Save and Close.

Adding a configuration to a site

To apply a Touch UI configuration to a site, go to: SitesSelect any site pagePropertiesAdvancedConfiguration → Select the configuration tenant.

Integrating Adobe Target on AEM sites by using Adobe Launch

AEM offers an out of the box integration with Experience Platform Launch. By adding the Adobe Target extension to Experience Platform Launch, you can use the features of Adobe Target on AEM web pages. Target libraries will only be rendered by using Launch.

NOTE

Existing (legacy) frameworks still work, but cannot be configured in the Touch UI. It is advisable to rebuild the variable mapping configurations in Launch.

As a general overview, the integration steps are:

  1. Create a Launch Property
  2. Add the required extensions
  3. Create a Data Element(to capture context hub parameters)
  4. Create a Page Rule
  5. Build and Publish

Creating a Launch Property

A property is a container that is filled with extensions, rules, data elements.

  1. Select the New Property button.
  2. Provide a name for your property.
  3. As domain, enter the IP/host on which you want to load the launch library.
  4. Select the Save button.
    Launchproperty

Adding the required extensions

Extensions is the container that manages the core library settings. The Adobe Target extension supports client-side implementations by using Target JavaScript SDK for the modern web, at.js. You must add both the Adobe Target and Adobe ContextHub extensions.

  1. Select the Extension Catalog option, and search for Target in the filter.
  2. Select Adobe Target at.js and Click on the Install option.
    Target Search
  3. Select the Configure button. Notice the configuration window with the Target account credentials imported, and the at.js version for this extension.
  4. Select Save to add the Target extension to your Launch property. You should be able to see the Target extension listed under the Installed Extensions list.
    Save Extension
  5. Repeat the steps above to search for the Adobe ContextHub extension and install it (this is required for the integration with contexthub parameters, based on which targeting will be done).

Creating a Data Element

Data elements are the placeholders to which you can map context hub parameters.

  1. Select Data Elements.
  2. Select Add Data Element.
  3. Provide the name of data element and map it to a context hub parameter.
  4. Select Save.
    Data Element

Creating a Page Rule

In Rule we define and order a sequence of actions, which are executed on site, to achieve targeting.

  1. Add a set of actions as exemplified in the screenshot.
    Actions
  2. In Add Params to All Mboxes add the data element configured earlier (see data element above), to the parameter which will be sent in the mbox call.
    Mbox

Build and Publish

To learn how to build and publish please refer to this page.

Changes in content structure between Classic and Touch UI configurations

Change Classic UI Configuration Touch UI Configuration Consequences
Location of the Target Configuration. /etc/cloudservices/testandtarget/ /conf/tenant/settings/cloudservices/target Earlier multiple configurations were present under /etc/cloudservices/testandtarget but now a single configuration is present under a tenant.
NOTE

Legacy configurations are still supported for existing customers (without the option to edit or create new ones). Legacy configurations will be part of content-packages uploaded by customers using VSTS.

On this page