Exporting Content Fragments to Adobe Target exporting-content-fragments-to-adobe-target

CAUTION
  • The AEM Content Fragments are exported into the default workspace of Adobe Target.
  • AEM must be integrated with Adobe Target according to the instructions under Integrating with Adobe Target.

You can export Content Fragments, created in Adobe Experience Manager as a Cloud Service (AEM), to Adobe Target (Target). They can then be used as offers in Target activities, to test and personalize experiences at scale.

There is the option available for exporting a content fragment to Adobe Target:

  • JSON: Support for headless content delivery

To prepare your instance for exporting AEM Content Fragments to Adobe Target you need to:

After that you can:

Content Fragments can be exported to the default workspace in Adobe Target, or to user-defined workspaces for Adobe Target.

NOTE
The Adobe Target workspaces do not exist in Adobe Target itself. They are defined and managed in Adobe IMS (Identity Management System), then selected for usage across solutions using Adobe Developer Console.
NOTE
Adobe Target workspaces can be used to allow members of an organization (group) to create and manage offers and activities for this organization only; without giving access to other users. For example, country-specific organizations within a global concern.

Prerequisites prerequisites

The following action is required:

Add the Cloud Configuration add-the-cloud-configuration

Before exporting a fragment you need to add the Cloud Configuration for Adobe Target to the fragment, or folder. This also enables you to:

  • specify the format option(s) to be used for the export
  • select a Target workspace as destination
  • select an externalizer domain for rewriting references in the Content Fragment (optional)

The required options can be selected in Page Properties of the required folder, or fragment, or both; the specification is inherited as necessary.

  1. Navigate to the Assets console.

  2. Open Page Properties for the appropriate folder or fragment.

    note note
    NOTE
    If you add the cloud configuration to the Content Fragment parent folder, the configuration is inherited by all the children.
    If you add the cloud configuration to the Content Fragment itself, the configuration is inherited by all variations.
  3. Select the Cloud Services tab.

  4. Under Cloud Service Configuration, select Adobe Target from the drop-down list.

    note note
    NOTE
    The JSON format of a Content Fragment offer can be customized. To do this define a customer Content Fragment component and then annotate how to export its properties in the component Sling Model.
    See the core component: Core Components - Content Fragments
  5. Under Adobe Target select:

    • the appropriate configuration
    • the required format option
    • an Adobe Target workspace
    • if necessary - the externalizer domain
    note caution
    CAUTION
    The externalizer domain is optional.
    An AEM externalizer is configured when you want the exported content to point to a specific publish domain. For more details see Configuring the AEM Link Externalizer.
    Also note that Externalizer Domains are only relevant to the content of the Content Fragment that is sent to Target, and not metadata such as View Offer Content.

    For example, for a folder:

    Folder - Cloud Services

  6. Save & Close.

Add the Legacy Configuration add-the-legacy-configuration

IMPORTANT
Adding a new Legacy configuration is a special case scenario that is only supported for the export of Content Fragments.

After adding the Cloud Configuration to use Launch by Adobe, to initially integrate AEM with Adobe Target, you also need to manually integrate with Adobe Target using a legacy configuration.

Creating a Target Cloud Configuration creating-a-target-cloud-configuration

To enable AEM to interact with Adobe Target, create a Target cloud configuration. 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. Navigate to Legacy Cloud Services via the AEM logo > Tools > Cloud Services > Legacy Cloud Services.
    For example: (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)

    The Adobe Experience 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.

You can now select the new configuration for editing.

  1. The edit dialog opens.

    config-target-settings-dialog

  2. In the Adobe Target Settings dialog, provide values for these properties.

    • Authentication: this defaults to IMS (User Credentials is deprecated)

    • Client Code: the Target account Client Code

    • Tenant ID: the tenant ID

    • IMS Configuration: select the required configuration from the drop-down list

    • API Type: defaults to REST (XML is deprecated)

    • A4T Analytics Cloud Configuration: Select the Analytics cloud configuration that is used for target activity goals and metrics. You need this if you are using Adobe Analytics as the reporting source when targeting content.

    • Use accurate targeting: By default this check box is selected. If selected, the cloud service configuration will wait for the context to load before loading content. See note that follows.

    • Synchronize Segments from Adobe Target: Select this option to download segments that are defined in Target to use them in AEM. Select this option when the API Type property is REST, because inline segments are not supported and you always need to use segments from Target. (The AEM term of ‘segment’ is equivalent to the Target ‘audience’.)

    • Client library: this defaults to AT.js (mbox.js is deprecated)

      note note
      NOTE
      The Target Library file, AT.JS, is a new implementation library for Adobe Target that is designed for both typical web implementations and single-page applications.
      mbox.js has been deprecated and will be removed at a later stage.
      Adobe recommends that you use AT.js instead of mbox.js as the client library.
      AT.js offers several improvements over the mbox.js library:
      • Improved page load times for web implementations
      • Improved security
      • Better implementation options for single-page applications
      • AT.js contains the components that were included in target.js, so there is no longer a call to target.js
      You can select AT.js or mbox.js in the Client library drop-down menu.
    • Use Tag Management System to deliver client library - Select this option to use the client library from Adobe Launch or another tag management system (or DTM, which is deprecated).

    • Custom AT.js: Browse to upload your custom AT.js. Leave blank to use the default library.

      note note
      NOTE
      By default when you opt into the Adobe Target configuration wizard, Accurate Targeting is enabled.
      Accurate targeting means that the cloud service configuration waits for the context to load before loading content. As a result, in terms of performance, accurate targeting may create a few millisecond delay before loading content.
      Accurate targeting is always enabled on the author instance. However, on the publish instance you can opt to turn accurate targeting off globally by clearing the check mark next to Accurate Targeting in the cloud service configuration (http://localhost:4502/etc/cloudservices.html). You can also still turn accurate targeting on and off for individual components regardless of your setting in the cloud service configuration.
      If you have already created targeted components and you change this setting, your changes do not affect those components. You must make any changes to those component directly.
  3. Click Connect to Adobe 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.

Adding a Target Framework adding-a-target-framework

After you configure the Target cloud configuration, add a Target framework. The framework identifies the default parameters that are sent to Adobe Target from the available ContextHub components. Target uses the parameters to determine the segments that apply to the current context.

You can create multiple frameworks for a single Target configuration. Multiple frameworks are useful when you need to send a different set of parameters to Target for different sections of your website. Create a framework for each set of parameters that you need to send. Associate each section of your website with the appropriate framework. Note t*hat a web page can use only one framework at a time.

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

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

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

  3. Drag the Client Context component that represents the data that you want to use for mapping to the drop target. Alternatively, drag the ContextHub Store component to the framework.

    note note
    NOTE
    When mapping, parameters are passed to an mbox via simple strings. You cannot map arrays from ContextHub.

    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.

  4. Select the variables that you want to make visible to the Adobe Target system by selecting the Share checkbox in the appropriate columns.

    note note
    NOTE
    Synchronizing parameters is one way only - from AEM to Adobe Target.

Your framework is created. To replicate the framework to the publish instance, use the Activate Framework option from the sidekick.

Exporting a Content Fragment to Adobe Target exporting-a-content-fragment-to-adobe-target

CAUTION
For media assets, such as images, only a reference is exported to Target. The asset itself remains stored in AEM Assets and is delivered from the AEM publish instance.
Due to this the Content Fragment, with all related assets, must be published before exporting to Target.

To export a Content Fragment from AEM to Target (after specifying the Cloud Configuration):

  1. Navigate to your Content Fragment in the Assets console.

  2. Select the Content Fragment you would like to export to target.

  3. Select Export to Adobe Target Offers.

    Export to Adobe Target

  4. Select Export without publishing or Publish as required.

    note note
    NOTE
    The actual actions shown are dependent on the status of your fragment and related assets.
    If everything has already been published, and nothing has been modified since, then this step is passed over.
    note note
    NOTE
    Selecting Publish will publish the Content Fragment immediately, and send it to Target.
  5. Select OK in the confirmation dialog.

    Your Content Fragment should now be in Target.

    note note
    NOTE
    Various details of the export can be seen in List View of the console and Properties.
    note note
    NOTE
    When viewing a Content Fragment in Adobe Target, the last modified date that is seen is the date that the fragment was last modified in AEM, not the date that the fragment was last exported to Adobe Target.
NOTE
Alternatively, you can perform the export from the page editor, using comparable commands in the Page Information menu.

Using your Content Fragments in Adobe Target using-your-content-fragments-in-adobe-target

After performing the preceding tasks, the Content Fragment displays on the Offers page in Target. See specific Target documentation to learn about what you can achieve there.

NOTE
When viewing a Content Fragment in Adobe Target, the last modified date that is seen is the date that the fragment was last modified in AEM, not the date that the fragment was last exported to Adobe Target.

Deleting a Content Fragment already exported to Adobe Target deleting-a-content-fragment-already-exported-to-adobe-target

As with exporting, deleting a content fragment from Adobe Target can also be selected from the top toolbar of the Assets console once the fragment has been selected:

Delete in Adobe Target

Deleting a content fragment that has already been exported to Target may cause problems if the fragment is already being used in an offer in Target. Deleting the fragment would render the offer unusable as the fragment content is being delivered by AEM.

To avoid such situations:

  • If the Content Fragment is not being currently used in an activity, AEM allows the user to delete the fragment without a warning message.

  • If the Content Fragment is currently in use by an activity in Target, an error message warns the AEM user about possible consequences that deleting the fragment will have on the activity.

    The error message in AEM does not prohibit the user from (force-)deleting the Content Fragment. If the Content Fragment is deleted:

    • The Target offer with AEM Content Fragment may show undesired behavior

      • The offer will likely still render, as the Content Fragment was pushed to Target
      • Any references in the Content Fragment may not work correctly if referenced assets were deleted in AEM as well.
    • Of course, any further modifications to the Content Fragment are impossible as the Content Fragment does not exist anymore in AEM.

Further Resources further-resources

For more information, see the following:

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab