Pages

Modification content defines the code that is added to a page to change the contents, appearance, or behavior of the page. The code can consist of HTML, CSS, and JavaScript, in any combination. For example, the content can be a DOM element that is displayed to visitors, such a hero banner or a product carousel, or it can be a script that adds invisible functionality to the page, such as data tracking or event handling.

A modification can have one or more variations. Variations are different content versions of the same modification. If a modification has only one variation, all visitors get that variation. If a modification has multiple variations, you can define how the variations are distributed among visitors, that is, what percentage of visitors gets which variation.

Apart from multi-armed bandit modifications, a visitor is assigned a specific variation until they clear their browser cache, open a new window in incognito mode, or visit the site from another device.

You can create three types of variations:

  • Custom content. The content is defined directly in the variation. The content is only available to that variation.
  • Content template. The content is defined outside the modification in a template. A variation links to the template for its content. The template, and therefore the content, is also available to other modifications and variations on the site.
  • Original content. No content is defined for the modification. The variation is used for tracking the performance of the original page content. This allows you to compare how the other variations perform against the original content.

On this page:

Creating a variation

To define content for your modification, you must create at least one variation. The number of variations you can create for a modification depends on the modification case:

CaseVariationsNotes
A/B testMultiple
Multi-armed banditMultiple
Personalization1The variation is pre-created with the modification, and you can modify it, but not remove it.
Non-personalized1

The variation is pre-created with the modification, and you can modify it, but not remove it.

This case is only available when selective profiling is enabled for the site.

The Frosmo Platform automatically places 10% of all visitors in the comparison group. To disable the comparison group for the modification, deactivate the comparison group variation. Non-personalized modifications do not have a comparison group variation.

To create a variation:

  1. In the Frosmo Control Panel, in the sidebar, select Modifications.
  2. In the modifications list, find the modification for which you want to create a variation, and click the modification name.
  3. In the Basic settings view, in the Content section, click Create variation.

    Creating a variation

    If the modification case is Personalization, the modification can only have a single variation. The variation is pre-created with the modification. You cannot add more variations.

  4. Define the content type and content settings for the variation.
  5. When you're done, click Save.

Editing a variation

To edit a variation:

  1. In the Frosmo Control Panel, in the sidebar, select Modifications.
  2. In the modifications list, find the modification whose variation you want to edit, and click the modification name.
  3. In the Basic settings view, in the Content section, find the variation you want to edit, and click the variation name.
  4. Define the content type and content settings for the variation.
  5. When you're done, click Save.

Removing a variation

If the modification case is Personalization, the modification can only have a single variation. The variation is pre-created with the modification. You cannot remove the variation.

To remove a variation:

  1. In the Frosmo Control Panel, in the sidebar, select Modifications.
  2. In the modifications list, find the modification whose variation you want to remove, and click the modification name.
  3. In the Basic settings view, in the Content section, find the variation you want to remove.
  4. Click the quick menu button for the variation, and select Remove.

    Removing a variation

Defining the content type and content settings for a variation

To define the content type and content settings for a variation:

  1. Optionally, enter a title for the variation.

    Entering the variation title

    If your site has a Google Analytics integration with the Frosmo Platform, the variation title is shown as a label in Google Analytics. If you change the title in the Frosmo Control Panel, the label will also change.

  2. Select or change the content type:
    1. Click Select type.
    2. Select the content type.

      Selecting the content type for a variation

    3. Click Select.
  3. Define the content based on the selected content type. The available content settings depend on the selected content type and template.
    1. Custom content: Define your own CSS, HTML, and JavaScript content in a code editor.

      Defining custom content for a variation

      When using CSS and JavaScript in variation content, the code must be wrapped in <style> and <script> elements, respectively.

    2. Original content: Create a variation for tracking the original page content. Since the variation is only used for collecting data, you don't define content for it.

      To track original content, the display method of the selected placement must be Replace content, Replace element, or Hide & replace original. You cannot append a variation to the original content.

    3. Content templates: Define content based on a predefined template.

      Setting template content options for a variation

      To view the JSON object describing the full content options for the variation, expand the Content options object (JSON) section.

      Viewing the JSON object describing the full content options for a variation

  4. When you're done, click Save.

Activating and deactivating a variation

Before activating the modification and thus making it visible on the site, you must activate each variation you want to use.

The Frosmo Platform automatically places 10% of all visitors in the comparison group, which sees the original content of a web page instead of modifications. Once a visitor enters the comparison group, that visitor will not see any modifications on the site that have the comparison group variation enabled. The comparison group is treated as a variation, and you can deactivate it as any other variation.

To activate a variation:

  1. In the Frosmo Control Panel, in the sidebar, select Modifications.
  2. In the modifications list, find the modification whose variation you want to activate, and click the modification name.
  3. In the Basic settings view, in the Content section, find the variation you want to activate.
  4. Click the quick menu button for the variation, and select Activate.

    Activating a variation

To deactivate a variation, click the quick menu button for the variation, and select Deactivate.

Deactivating a variation

Defining the variation distribution for an A/B test modification

You can manually define the variation distribution only when the A/B test modification has at least two active variations (in addition to the comparison group).

To define the variation distribution for an A/B test modification:

  1. In the Frosmo Control Panel, in the sidebar, select Modifications.
  2. In the modifications list, find the modification whose variation distribution you want to define, and click the modification name.
  3. In the Basic settings view, in the Content section, click Define distribution.

  4. Set the distribution between the variations. If you increase the distribution for one variation, the distribution of other variations is automatically adjusted so that the total distribution is 100%.

    If the comparison group variation is enabled for the modification, 10% of visitors do not see the modification, so the total distribution between the other variations is 90%. You can deactivate the comparison group variation in the Basic settings view.

  5. When you're done, click Save.

After defining the variation distribution, you can view the distribution for each variation.

Defining the variation distribution for a multi-armed bandit modification

For a multi-armed bandit modification, you define how to measure variation performance ("reward") and which algorithm to use to automatically optimize the variation distribution. The Frosmo Platform continuously adjusts variation distribution for that modification based on how well the variations perform over time. Performance is measured based on the number of clicks or conversions attributed to each variation.

For more information about the rewards and algorithms, see Multi-armed bandit optimization.

To define the variation distribution for a multi-armed bandit modification:

  1. In the Frosmo Control Panel, in the sidebar, select Modifications.
  2. In the modifications list, find the modification whose variation distribution you want to define, and click the modification name.
  3. In the Basic settings view, in the Content section, click Define distribution.

    Defining the variation distribution for a MAB modification

  4. Select the reward and the algorithm.

    Defining the variation distribution for a MAB modification

  5. When you're done, click Save.

You can view the distribution for each variation when the variations, and the modification, are active. After data starts to accumulate, the distribution changes over time as the platform measures which variation performs the best. The calculation is performed every two hours.

Viewing the current variation distribution for a MAB modification