Work with Adobe Experience Manager Content Fragments aem-fragments

Configure the Dispatcher: To enable Journey Optimizer to access Adobe Experience Manager Content Fragments via the Content Fragment Management API, you must first configure the Dispatcher. This is a prerequisite for the integration.

Create and author: Content is created and configured in Adobe Experience Manager as Content Fragments.

Tagging: Content Fragments must be tagged with the Journey Optimizer-specific tag (ajo-enabled:{OrgId}/{SandboxName}).

Publish: Content Fragments are published in Adobe Experience Manager, making them available to Journey Optimizer.

Access: Journey Optimizer fetches and displays available Content Fragments from Adobe Experience Manager publish instance in real-time.

Integration: Content Fragments are selected and integrated into campaigns or journeys.

Go to Tools > Tagging.

Create a nested tag structure so the full tag ID matches the format above:

1. At the root level, create a folder named ajo-enabled.

2. Under ajo-enabled, create a tag for your organization ID, for example, 123A12A123A123A12A@AdobeOrg.

3. Under that organization tag, create a tag for your sandbox, for example, prod.

The combined path yields a tag ID such as ajo-enabled:123A12A123A123A12A@AdobeOrg/prod.

To apply it to a Content Fragment, open the Content Fragment in the editor.

In Properties, add the tag you created.

Save the fragment.

Create your Campaign or Journey.

To access your AEM content fragment, click within any text field, or open the source code through an HTML content component.

From the AEM Content Fragment menu in the left-pane, click Open AEM Content Advisor.

Browse the list and select a Content Fragment to import into your Journey Optimizer content.

Click Show filters to fine tune your Content Fragments list.

By default, the Content Fragment filter is preset to display only approved Content.

After selecting your Content Fragment, click Select to add it.

Click View fragment to display your Fragment information. Note that opening the Fragment Info menu places the editor in read-only mode.

Select Preview from the right-hand menu to view your fragment in Adobe Experience Manager.

Click to access the advanced menu of your Fragment:

• Swap fragment
• Explore references
• Open in AEM

Choose the desired fields from your Fragment to add to your content.

To surface an image URL that is stored in a Content Fragment attribute, e.g. a path or URL field from the fragment model, insert it in your HTML with an <img> tag and the fragment attribute as the source, for example:

<img src="[insert your AEM Content Fragment attribute here]">

Select Pills: Off to enable the pills experience to improve readability by hiding long attribute paths.

To use personalization placeholders authored in Adobe Experience Manager inside your fragment text, define them in the Content Fragment in Adobe Experience Manager as follows: {{name}}.

In Journey Optimizer, those tokens are placeholders. With the pills experience on, they appear in the AEM Content Fragment section of the right rail alongside fragment fields.

To enable real-time personalization, all placeholders used within a Content fragment must be explicitly declared by the user as parameters in the fragment helper tag. Map those placeholders to profile attributes, contextual attributes, static strings, or predefined variables as follows:

1. Profile or Contextual Attribute Mapping: Assign the placeholder to a profile or contextual attribute, e.g. name = profile.person.name.firstName.

2. Static String Mapping: Assign a fixed string value by placing it within double quotes, e.g. name = “John”.

3. Variable Mapping: Reference a variable declared earlier within the same HTML, e.g. name = ‘variableName’.
   In this case, ensure variableName is declared before adding the fragment ID, using following syntax:

   code language-html
   {% let variableName = attribute name %}

In the example below, the month placeholder is mapped to the profile.person.birthDate attribute within the fragment.

{modal="regular"}

Click Save. You can now test and check your message content as detailed in this section.

Note that the Content Fragment you selected stays active for this message. When you open the Personalization Editor in another field or content block, you can keep working with the same fragment from the AEM Content Fragment section and add more fields without reopening Open AEM Content Advisor.

Open a campaign or journey.

Click in any text field, or open the HTML source from an HTML content component.

From AEM Content Fragment, click Open AEM Content Advisor.

To select a locale-specific Adobe Experience Manager Content Fragment in table view, use Customize table to add the Language column. Locale values are displayed in the table, enabling you to identify and select the appropriate fragment.

Select your Content Fragment.

Click the to open Details menu. If the fragment has one or more published variations, a Variation dropdown appears next to the fragment details.

From the Quick details menu, click Explore references to open related options in Adobe Experience Manager for variation details, preview, and proof when available.

Choose your variation, then click Select.