Preview app

The Preview app allows you to test personalized content. You can impersonate a visitor to verify that the correct page variant is served. The impersonated visitor can be a persona or a mix of local traits. The Preview app looks just like the preview in the Pages app but it has a sidebar for selecting the persona and traits.

Preview app

Configuration

The Preview app is configured in /modules/personalization-preview-app.

Preview app configuration

Properties:

previewParameterPrefix

URL parameters used for personalization have a special prefix that sets them apart from other parameters. The previewParameterPrefix identifies a parameter as a preview parameter. When you choose a persona or traits in the Preview app, Magnolia appends your choices as parameters to the page URL. You can test variant delivery also by typing the parameter in the browser address bar yourself. The default prefix is preview, for example previewPersona or previewCountry.

personaParameterName

A URL parameter that identifies the persona. Magnolia sets the parameter value to the name of the persona you select in the Preview app. The default parameter name is persona, for example previewPersona=/Peter-Klang

Example: Previewing a page as Wang Fang (persona) on August 10, 2019 in the Preview app. Multiple parameters are separated with colon (:) in the Preview app and with ampersand (&) if you request the published page.

previewPersona=/Wang-Fang:previewDate=2019-08-10-00-00-00

Previewing a page to a persona from the UK

Previewing

To preview a page variant:

  1. Open the Preview app.

  2. In the Preview app, go to a page that has a variant. If the original page is served instead of the variant this is probably because you are impersonating an anonymous user by default. The anonymous user likely does not match the audience of the variant.

  3. Select a persona that matches the audience or select local traits that match the audience. The variant is now served.

See My first personalized campaign for a full hands-on tutorial that includes previewing page variants.

Feedback

DX Core

×

Location

This widget lets you know where you are on the docs site.

You are currently perusing through the DX Core docs.

Main doc sections

DX Core Headless PaaS Legacy Cloud Incubator modules