Integrating with Adobe Target

Hinweis

The Adobe Analytics and Target opt-in wizard simplifies the procedures that are described on this page.

As part of the Adobe Marketing Cloud, Adobe Target lets you increase content relevance through targeting and measuring across all channels.

Adobe Target is used by marketers to design and execute online tests, create on-the-fly audience segments (based on behavior) and automate the targeting of content and online experiences.

Adobe Target puts control directly in the hands of marketers to quickly and continually execute multiple A/B testing and multivariate (MVT) testing, measure effectiveness and relevance of content across any online channel and increase content relevance through segmentation, targeting and automated personalization.

With AEM, your site can be seamlessly integrated with Adobe Target, allowing you to do the following:

  • Create campaign offers with AEM and manage them with Adobe Target.
  • Submit Client Context data to Adobe Target when visitors interact with your pages.
  • Implement landing page campaigns.
  • Perform A/B testing.
  • Track conversion rates.

A typical integration with Target involves the following steps:

  1. Register with Adobe Target to create an account.
  2. Create a Target configuration in AEM. 
  3. Create a Target framework that identifies the visitor data that you want to track. 
  4. Associate the framework with your web pages. 
  5. Add code to your web pages so that it can access the Adobe Target infrastructure.  (See Developing for Targeted Content.)
  6. Enable the Target replication agent.
  7. Create marketing activities and offers, and author targeted content.
  8. Manage the generated data in Adobe Target.

You can also use the Opt-in wizard to easily perform the integration.

If required, you can customize the default behavior of the integration with Adobe Target. (See Developing for Targeted Content.)

This section describes how to integrate with Target. For more information on developing targeted content, see Developing for Targeted Content.


For information about authoring targeted content, see Authoring Targeted Content Using Targeting Mode.

Hinweis

If a custom mbox is defined in a Target configuration, everyone must have read access to/etc/cloudservices on publish servers. Without this access, loading mbox.js files on publish website results in a 404 error. 

In addition, the ACLSetupService component also requires the folowing change as it sets a deny ACE on /etc/cloudservices everytime the security bundle is restarted or refreshed:

/libs/cq/security/config.publish/com.day.cq.security.ACLSetup should have entry 15 removed.

Background Information Sources

Integrating AEM with Adobe Target requires knowlege of Adobe Target, AEM Activities management, and visitor segmentation. You should be familiar with the following information:

Configuring External URLs

AEM uses the CQ Link Externalizer service to generate links that Adobe Target uses for accessing AEM campaigns. You must ensure that this service is configured correctly so that the link URLs do not use localhost.

For information about configuring the service, see Externalizing URLs. For general information about configuring OSGi services, see Configuring OSGi.

Setting Up your Site with Target

Use the following procedures to integrate your AEM website with Adobe Target.

Registering with Target

To integrate AEM with Adobe Target, you must have a valid Adobe Target account. This account must have approver level permissions at a minimum. When you register with Adobe Target, you receive a client code. You need the client code and your Adobe Target login name and password to connecting AEM to Adobe Target.

The Client Code identifies the Adobe Target customer account and is used as a sub-domain in the URL when calling the Adobe Target server. 

Before proceeding, ensure your credentials allow you to login here: https://testandtarget.omniture.com/.

Creating a Target Configuration in AEM

To enable AEM to interact with Adobe Target, create a Target cloud configuration in AEM. To create the configuration, you provide the Adobe Target client code and user credentials.

You create the Target cloud configuration only once because you can associate the configuration with multiple AEM campaigns. If you have several Adobe Target client codes, create one configuration for each client code.

You can configure the cloud configuration to synchronize segments from Adobe Target. If you enable synchronization, segments are imported from Target in the background as soon as the cloud configuration is saved.

Use the following procedure to create a Target cloud configuration in AEM:

  1. Go to the Tools page and select Cloud Services. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)

    The Adobe Marketing Cloud overview page opens.

  2. In the Adobe Target section, click Configure Now.

  3. In the Create Configuration dialog:

    1. Give the configuration a Title.
    2. Select the Adobe Target Configuration template.
    3. Click Create.

    The edit dialog opens for the new configuration page.

    file
  4. In the dialog, provide values for the properties:

    1. Client Code: the Target account Client Code
    2. E-Mail: the Target account email.
    3. Password: the Target account password.
    4. Synchronize Segments from Adobe Target: Select this option to download segments that defined in Target to use them in AEM.
    5. Custom mbox.js: Leave blank to use the default mbox.js. Otherwise upload your custom mbox.js.
  5. Click Connect to Target to initialize the connection with Target. If the connection is successful, the message Connection successful is displayed. Click OK on the message and then OK on the dialog. The configuration page now looks like this:

    file

Add a Framework

After you configure the Target connection, add an analytics framework. The framework identifies the default parameters that are sent to Adobe Target from the targeted components (mboxes) on your AEM pages:

You can create multiple frameworks for a single Target configuration. However, a web page can use only one framework at a time.

  1. On your Target configuration page, click the + (plus sign) next to Available Frameworks.

    file
  2. In the Create Framework dialog, specify a Title, select the Adobe Target Framework, and click Create.

    file

    The framework page opens. Sidekick provides components that represent information from the Client Context that you can map.

    file
  3. Drag the component that represents the data that you want to use for mapping to the drop target.

    For example, to use Profile Data about your site vistors to control your Target campaign, drag the Profile Data component to the page. The profile data variables that are available for mapping to Target parameters appear. 

    file
  4. Select the variables that you wish to make visible to the Target system.

    file

    Hinweis

    Synchronizing the campaign parameters is one way only - from AEM to Adobe Target.

Your framework is created. Perform the following procedure to replicate the framework to the publish instance:

  1. Open the Tools console (http://localhost:450s/miscadmin#/etc).

  2. Below the Tools folder, select Adobe Target/<your configuration>

  3. In the list of frameworks, select your framework and click Activate.

    file

Linking the Target Framework with your Site

After you create a Target framework in AEM, associate your web pages with the framework. The Target components on these pages send the framework-defined data to Adobe Target for analysis.  (See Content Targeting.)

When you associate a page with the framework, the child pages inherit the association.

  1. In the Websites console, in the websites tree, select the folder or parent page of the site that you wish to configure.

  2. In the list of pages, right-click the page and click Properties.

  3. Select the Cloud Services tab.

  4. Click Add Service, select Adobe Test&Target and click OK.

  5. Use the Adobe Test&Target drop-down menu to select your T&T framework.

    Hinweis

    Make sure that you select the specific framework that you created and not the general T&T configuration under which it was created.

    file
  6. Click OK to save the changes.

  7. Activate the root page of the website to replicate it to the publish server. (See How To Publish Pages.)

Enabling the Target Replication Agent

The Test and Target replication agent must be enabled on the author instance. Note that this replication agent is not enabled by default if you used the nosamplecontent run mode for installing AEM.

  1. On the AEM home page, click or tap Tools > Operations > Replication.

  2. Click or tap Agents On Author.

  3. Click or tap the Test and Target (test and target) replication agent, and then click or tap Edit.

  4. Select  the Enabled option, then click or tap OK.

Content Targeting

After your campaign is associated with a Target configuration, you can author targeted content that sends visitor data to Adobe Target.

Hinweis

Page components require specific code to enable content targeting. (See Developing for Targeted Content.)

​