Magnolia 5.6 reached end of life on June 25, 2020. This branch is no longer supported, see End-of-life policy.
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.
Configuration
The Preview app is configured in Configuration > /modules/personalization-preview-app.
| Node name | Value |
|---|---|
modules | |
personalization-preview-app | |
apps | |
config | |
personaParameterName | persona |
previewParameterPrefix | preview |
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 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 Peter Klang (persona) on June 18, 2015 in the Preview app. Multiple parameters are separated with colon (:) in the Preview app and with ampersand (&) if you request the published page.
previewPersona=/Peter-Klang:previewDate=2015-06-18-00-00-00
Previewing
To preview a page variant:
- Open the Preview app.
- 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.
- 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.
Overview
Content Tools