Integrating with Adobe Target integrating-with-adobe-target
As part of the Adobe Experience 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 export of Experience Fragments and/or Content Fragments to Target, you only need the Adobe Target Configuration and IMS.
Creating the Adobe Target Configuration create-configuration
- Navigate to Tools → Cloud Services.
- Select Adobe Target.
- Select the Create button.
- Fill in the details (see below), and select Connect.
IMS Configuration 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). See IMS Configuration for use when Integrating with Adobe Target and the video Integrating Experience Platform Launch and AEM to learn how to create the Target IMS configuration.
Adobe Target Tenant ID and Adobe Target Client Code tenant-client
When configuring the Adobe Target Tenant ID and Adobe Target Client Code fields, be aware of the following:
- For most customers, the Tenant ID and the Client Code are the same. That is, both fields contain the same information and are identical. Make sure you enter the Tenant ID in both fields.
- For legacy purposes, you can also enter different values in the Tenant ID and the Client Code fields.
In both cases:
- By default, the Client Code (if added first) is also automatically copied into the Tenant ID field.
- If necessary, you can change the default Tenant ID set.
- Backend calls to Target are based on the Tenant ID and the client side calls to Target are 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.
- Reenter the Tenant ID.
- Reconnect to Target.
- Save the configuration.
Editing the Target Configuration edit-target-configuration
To edit the Target configuration, follow these steps:
- Select an existing configuration and click Properties.
- Edit the properties.
- Select Re-connect to Adobe Target.
- Select Save and Close.
Adding a configuration to a site add-configuration
To apply a Touch UI configuration to a site, go to: Sites > Select any site page > Properties > Advanced > Configuration > Select the configuration tenant.
Integrating Adobe Target on AEM sites by using Adobe Launch integrate-target-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 are only rendered by using Launch.
As a general overview, the integration steps are:
- Create a Launch Property
- Add the required extensions
- Create a Data Element(to capture context hub parameters)
- Create a Page Rule
- Build and Publish
Creating a Launch Property create-property
A property is a container that is filled with extensions, rules, data elements.
- Select the New Property button.
- Provide a name for your property.
- As domain, enter the IP/host on which you want to load the launch library.
- Select the Save button.
Adding the required extensions add-extension
Extensions are 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. Add both the Adobe Target and Adobe ContextHub extensions.
- Select the Extension Catalog option, and search for Target in the filter.
- Select Adobe Target at.js and click on the Install option.
- Select the Configure button. Notice the configuration window with the Target account credentials imported, and the at.js version for this extension.
- 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.
- Repeat the steps above to search for the Adobe ContextHub extension and install it (this extension is required for the integration with contexthub parameters, based on which targeting is done).
Creating a Data Element data-element
Data elements are the placeholders to which you can map context hub parameters.
- Select Data Elements.
- Select Add Data Element.
- Provide the name of data element and map it to a context hub parameter.
- Select Save.
Creating a Page Rule page-rule
In Rule, it defines and orders a sequence of actions, which are run on site, to achieve targeting.
- Add a set of actions as exemplified in the screenshot.
- In Add Params to All Mboxes, add the data element configured earlier (see data element above), to the parameter which is sent in the mbox call.
Build and Publish build-publish
To learn how to build and publish, see page.