Creating personalizations in Page Composer

November 14, 2023

You can create personalized experiences directly in Jahia using Page Composer. This can be done either for:

  • individual content items on a page
  • list of content items 
  • the entire page itself. 

New content items added to a personalization are called variants. You then specify the conditions under which variants display to different visitors.

Personalizing content on a page

You can apply a personalization to a content item in Page Composer.

To create a personalized experience:

  1. Navigate to page composer
  2. On the page, right-click on the content where you want to create a personalized experience. Select Add personalization.
    adding_personalization_to_content_01.png

    A box surrounds the content and a toolbar displays.
    adding_personalization_to_content_02.png
  3. Next, add other content items inside the personalized section. To add content, click the button at the top-right of the content item. In this example, the News entry button displays.
  4. In the New Content page, enter information for the new page.
    Note: When you add content, the number in the toolbar updates.
  5. Use the previous and next arrows to navigate between content items. The name of the current item displays in a button.
  6. To edit content, right-click and select Edit to open the content in Page Composer.
  7. Click Save.

Next, specify conditions that define when a variant displays.

Personalizing content lists

You can apply a personalization to a content list in Page Composer.

To personalize a list:

  1. Navigate to page composer
  2. On the page, right-click on the content where you want to create a personalized experience. Select Convert to personlized list.
    convert-to-personalize-list.png

    A new action "edit personalization" is displayed
    edit-personalized-list-1.png

Next, specify conditions that define when a variant displays.

Personalizing a page

You can apply a personalization at the page level in Page Composer.

To personalize a page:

  1. From Jahia, right-click on the page that you want to personalize. Then select Add personalization.
    A toolbar displays at the top-right of the page.
  2. To add a new page variant, click Add. The existing page is copied as a new page variation.
  3. To edit the properties of the new page variation, click Edit Variant Name. You can also use the left and right arrows on the toolbar to navigate between variants.
    Adding variant personalization
  4. To specify how the pages display to users, you must edit the first page variant. Select Edit from the Page Options menu at the top right of the page.
    Page Options
  5. In the Edit Content page, modify the page and click Save.

Next, specify conditions that define when a variant displays.

Specifying how a variant displays to visitors 

After creating a variant, you define settings that specify when the variant is served to visitors who access the page.

To define a personalization setting for a variant:

  1. To specify how the pages display to users, you must edit the first page variant. Select Edit from the Personalization menu at the top right of the page.
    Variant Edit Personalization
  2. On the Edit page, scroll down to the Options section.
    Naming Variant
  3. Specify the variant's system name, then click Save.

    Field

    Usage

    System name

    Name of the variant in the repository

    Active

    Whether the personalization is active. Selected by default. Deselect to make the personalization inactive.

    Starts on

    The date and time that the personalization will start. If the field is empty, the personalization will start immediately (as soon as the page is published)

    Ends on

    The date and time that the personalization will stop. If the field is empty, the personalization is active unless stopped by a manual action.

  4. To define when the variant displays to users, select the Edit Personalization tab from the same menu as Step 1:
  5. Personalization Menu
  6. From here, you can specify whether the variant is active and start and end dates for the personalization.To specify how variants are evaluated by conditions, choose one of the following from the Display Strategy list:
    select_variant_display_type.png
    • First content matching conditions
      Displays the first item in the Variants list that has a condition that matches the current profile and context.
    • Random content
      Displays content randomly from all items in the Variants list that match conditions specified for the personalization.
    • Sorted by score
      Displays content with the highest score. Each condition must be associated with a score.
  7. To specify the fallback variant, select the check box beside a variant. The fallback variant is the variant that displays if criteria for a visitor does not match any of the variants.
  8. To change the order of variants in the Variants list, drag and drop variants in the Variants list to reorder them.
    Variant Reorder
  9. To specify matching conditions for variants, see Condition builder for more information on how to build conditions on a page.
  10. Click Save.

Understanding the difference between content personalization and personalized lists 

 

Content personalization

Personalized lists

Overall behavior

One content variant is displayed.

It is selected based on the conditions and the display strategy.

The list's content items are either displayed, hidden, or reordered depending on the display strategy and the conditions.

Can be applied on

Any content item (with the mixin jmix:editorialContent or wemmix:experiencable)

Lists of content items (with the mixin: jmix:list)

Display strategy - First Matching condition

Conditions are evaluated in order of the variants.
If one variant’s conditions match, the evaluation stops, and this one variant is displayed.

 

Note: If “no condition” is selected, the conditions are considered to match

Variants' conditions are all evaluated. 

If the variant conditions match, the content is displayed. If conditions don’t match, the variant is hidden. 

If several variants match, they are displayed. 

 

Note: If no variant conditions match at all, then all content items of the list are displayed

Display strategy - Sorted by Score

Variants' conditions are all evaluated. 

The variant with the highest score is displayed. 

 

Note: If “no condition” is selected or if the score is under 0, the variant is ignored.

Variants' conditions are all evaluated and variants are ordered by their score. 

 

Note: If “no condition” is selected or if the score is under 0, the variant is displayed.

How does it work?

It creates a new container wrapping the existing content items so marketers can add variants

Applies personalization on the existing list.