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 /modules/personalization-preview-app.
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.
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.