Canvas personalization

Uniform personalization is built directly into the composition process. You can add, change and remove personalization in a composition from within Canvas. Once configured, no developer is required.


See personalization for background information, what personalization is, and examples of how it used.


Before you can assign personalization criteria to a component, you must have classification configured and a component defined. For information on how to configure classification, see the classification guide. For information on how to define a component, see the components guide.

  1. In Uniform, edit a component with the slot that you want to add personalized components to.

  2. Click Edit Component.

  3. Navigate to the slot.

  4. In the section Allowed Components, select the component Personalization.

    This configuration allows testimonials components to be personalized in the slot.

    About this step

    You must have other components selected on the slot. Those will be the component types that can be personalized in this slot.

  5. Click OK.

  6. Save the component.


Next you must update your composition to use personalized components.

  1. In Uniform, open a composition that has a component you have enabled personalization for.

  2. Click the component.

  3. Click the button Personalize This.

    About this step

    A new component Personalization is added to the slot, and the component is moved into that component. In this way personalization works the same as testing and localization.

  4. Select the new component Personalization.

  5. Enter the following values:

    Analytics tracking nameUniform tracks personalization activity and allows you to pass that activity to external analytics systems. The value you enter here acts as a label for the activity that's captured so you can identify which instance of personalization was triggered.
    Number of variations to showEach component has its own personalization criteria assigned. it's possible that more than 1 component has criteria that matches the visitor. This value allows you to control the maximum number of matching components that are displayed. If no value is specified, 1 variation is displayed.Matches are used in the order they're evaluated. In other words, Uniform doesn't attempt to determine which criteria is the best match.
  6. Save the composition.

  7. To assign personalization criteria to the original component, select the component.


    About this step

    The original component is now the default component because it doesn't have any personalization criteria assigned to it. This means this component will be used if no other component has personalization criteria that matches the visitor.

    You can leave it as the default component and add another component under the Personalization component and assign personalization criteria to it.

  8. Set a value for the field Variation Name.

    About this step

    This value is the companion value to the Analytics tracking name parameter on the Personalization component. When personalization is triggered, that event is captured. The name of the event is the Analytics tracking name. The value for the event is the Variation Name.

    If your component has its Title Parameter set, that value will be default variation name. However, if you don't have a Title Parameter set on the component, Uniform will generate a variation name for you. This isn't a user-friendly name - e.g. pz-01-event - so you to change it.

  9. Click + Add Criteria.

  10. You must configure 3 values:

    DimensionAvailable dimensions depend on classification is configured.
    OperatorThis determines how Uniform compares the value you specify to the visitor's profile. For more information on operators, see the operators reference.
    ValueA numeric value that you want to compare to the value of the dimension in the visitor's profile.
  11. Add more components under the component Personalization and assign personalization criteria to each component you add.


    About this step

    For more information about the format Uniform uses to store personalization criteria, see the personalization reference.

  12. You must publish your composition before the personalization instructions you've configured are available to the front-end.


Next steps: Personalization is already integrated into Canvas, so there are no front-end code changes you need to make. After you publish your composition, personalization should be activated.

This personalization happens on the client. You can run personalization instructions in other places, including on a CDN. For more information on how to get personalization instructions to execute in other environments, see the personalization activation guide.