Umbraco Engage
CMSCloudHeartcoreDXP
13.latest (LTS)
13.latest (LTS)
  • Umbraco Engage Documentation
  • Release Notes
  • Support
  • Installation
    • System Requirements
    • Installation
    • Licensing
    • Verify your Engage installation
  • Upgrading
    • Upgrade Umbraco Engage
    • Version specific Upgrade Notes
    • Migrate from uMarketingSuite
  • Getting Started
    • Getting Started
    • For Marketers and Editors
      • Cockpit
      • Marketing Resources
    • For Developers
      • Infrastructure sizing
      • Load Balancing and CM/CD Environments
      • Content Delivery Network recommendations
      • Cockpit
      • Content Security Policy nonce configuration
      • Troubleshooting installations
  • Marketers and Editors
    • Introduction
      • The Umbraco Engage Section
      • Content Apps
      • The Umbraco Engage Cookie
    • Analytics
      • What is measured by default
      • Client-side Events
      • Types Of Clients
      • Campaigns
      • Device Type
      • Location
      • Referral Traffic
      • Forms
      • Videos
      • Scroll Heatmap
      • Google Analytics vs Umbraco Engage
      • Search Terms
    • A/B Testing
      • What is A/B testing
      • Types of A/B Tests
        • Single-page A/B Test
        • Multiple Pages Test
        • Document Type Test
        • Split URL Test
      • Setting up the A/B Test
      • Previewing an A/B Test
      • Monitor the A/B Test
      • A/B Test Distribution Algorithm
      • Front end Rendering
      • Finish an A/B Test
    • Personalization
      • Creating a Segment
      • Setting up Personalization
      • Cockpit Insights
      • Implicit and Explicit Personalization
        • Setting up the customer journey
        • Personas
        • Implicit Personalization scoring explained
        • Content Scoring
        • Campaign Scoring
        • Referral Scoring
    • Profiling
      • Profile detail
      • External profile data
    • Reporting
    • Settings
      • Goals
      • IP Filtering
      • Configuration
      • Permissions
  • Developers
    • Introduction
      • Dataflow Pipeline
        • Data Collection
        • Data Storage
        • Data Parsing
        • Reporting
      • The Umbraco Engage Cookie
        • Module Permissions
      • Performance
    • Analytics
      • Request tracking
      • Bot detection
      • Capture location data
      • Extending forms
      • Video tracking
      • Scroll Heatmap
      • Client-side events
        • Additional measurements with analytics scripts
        • Bridging Library for Google Analytics
        • Bridging Library for Google Tag Manager
        • Google Analytics Blocker Detection
        • Create your own events
      • Extending Analytics
        • Getting the Correct IP Address
        • Sending data to the GTM Datalayer
    • A/B testing
      • Retrieving A/B test variants in C#
    • Personalization
      • Implement your own segment parameters
      • Retrieve segment information from code
      • Add custom scoring
    • Profiling
      • External Profile Data
    • Reporting
    • Settings
      • Custom goals scoring
      • Configuration
    • Headless
      • Using the Engage API
      • Headless Example
  • Security and Privacy
    • Security and privacy
    • Retention periods of data
    • Anonymization
    • GDPR & EU regulation
      • How to become GDPR compliant using cookiebot
    • How it works
  • Tutorials
    • Overview
    • How to Get Started with Personalization
    • How to Create a Persona
    • Create a Personalized Popup in 5 minutes
    • How to set up an A/B Test
    • Marketing Resources
      • Generic Topbar Template
      • Generic Popup Template
      • Generic Exit Intent Popup Template
Powered by GitBook
On this page
  • Tutorial Content
  • Step 1: Define Your Target Audience
  • Step 2: Score Your Content
  • Step 3: Build Segments
  • Step 4: Collect Data
  • When is enough data collected?
  • Step 5: Create Personalized Content
  • Next steps
  • Edit an existing variant
  • Configure the status of a variant

Was this helpful?

Edit on GitHub
Export as PDF
  1. Tutorials

How to Get Started with Personalization

To personalize the content on your website you need to get to know your target audience better. Follow this tutorial to get started.

PreviousOverviewNextHow to Create a Persona

Last updated 6 months ago

Was this helpful?

Personalization in Umbraco Engage, and in general, requires building personas, segmenting visitors, and collecting lots of data. Follow this tutorial to get started with all of this.

A big part of personalizing your website content is collecting data to use as a base for personalization. Steps 1-4 take you through setting Enage up to collect the required data. You need to collect enough data to move on to step 5.

Tutorial Content

Step 1: Define Your Target Audience

Before starting to personalize your website, you need to define personas. These are the types of visitors you want to target through the content on your website.

Try to narrow down the visitors into smaller puzzle pieces that can be combined within a persona group. This can be ‘Profiles’, ‘Job titles’, ‘Industry types’, and the like. The groups are the ingredients that will be used to personalize your content.

Follow the before moving on to the next step.

Step 2: Score Your Content

  1. Navigate to the Content section.

  2. Open a content item that you want to score.

  3. Select the Personalization content app.

  1. Go to Content scoring.

  2. Use the sliders to give the content a score of 1-10 for each persona.

  3. Click Save scoring when you are done.

  4. Repeat steps 2-5 for each content item you want to score based on your personas.

Avoid scoring generic content, such as the main landing page, as it does not help identify the website visitors intention.

Step 3: Build Segments

When you have decided which groups to focus on, it is time to build the segments. You segment visitors based on implicit or explicit scoring of their behavior and personas.

These ingredients can be implicitly scored, explicitly scored, or a combination. With implicit scores, you try to find out why someone visits your website. In the CMS, the pages are scored based on the created personas.

  1. Navigate to the Engage section.

  2. Open the Personalization dashboard and select Segments.

  1. Click Add new segment.

  2. Choose a parameter to base the segment on.

  1. Set up the parameter with the relevant configuration.

  1. Click Save parameter to apply the parameter to the segment.

  2. Repeat steps 2-4 to add more parameters if needed.

  3. Give the segment a title/name and add a description.

  4. Decide whether the segment will be temporary or not.

  5. Adjust the size of the control group under the Advanced settings if relevant.

  6. Click Add segment when you are done.

As soon as you set up a segment, data collection will start. You can create and set up more segments depending on your target audiences.

Repeat steps 3-9 above to create and set up additional segments.

Step 4: Collect Data

When collecting data, it is essential to know if segments are activating and if visitors align with the segments you have set up. With the reporting features within Umbraco Engage, you can measure how a certain segment performs. You can measure the following:

  • How many sessions a certain segment has had compared to the total number of sessions?

  • How many page views does a certain segment have?

  • How many sessions does someone need to fall into a certain segment?

You can use these insights to optimize your segments.

When is enough data collected?

Data will be collected continuously and you will not have to do anything further until enough data has been collected. However, it is recommended to watch the segment reporting as you might want to optimize segments if they are not performing well.

Once visitors fall into the segments you have set up, you will have enough data to personalize your website content.

Step 5: Create Personalized Content

When enough data has been collected it is time to create personalized variants of your content page. This can be done directly on the content item you want to personalize. Follow the steps below to personalize your content.

Only content that uses Document Types which allows property segmentation can be personalized. See the For Developers box below for more details.

For Developers: Allow segmentation on Document Types and Properties

To personalize content, segmentation needs to be allowed on the Document Types and properties used to create it. Follow the steps below to allow segmentation.

  1. Open the Document Type that needs to allow segmentation.

  2. Access the Permissions view.

  3. Check the Allow segmentation option.

  4. Save the Document Types.

  5. Access the Design view for the same Document Type.

  6. Click on ⚙️ next to the property where segmentation should be allowed.

  7. Check the Allow segmentation option.

  8. Submit the changes.

  9. Repeat steps 6-8 for each property that should allow segmentation.

  10. Save the Document Type.

  1. Navigate to the content item you want to personalize.

  2. Open the Personalization dashboard.

  1. Select Add personalized variant to get started with the personalization.

  2. Select the Segment you want to target with this new variant.

  3. Give the variant a Name.

  4. Add a Description.

  1. Click on Add new variant to start editing the variant.

The content opens in a split-view format when all configuration required for the new variant is added. You can add content to the variant while seeing what is currently available by default.

Only fields allowed for segmentation can be edited in the variant. Fields not configured for segmentation will use the values from the default content. When you leave a field blank on the variant, it automatically uses the values from the default content.

  1. Add content for the new variant.

  2. Select Save and publish... when you are done editing.

  3. Select the variants you want to publish and click Save and publish.

The first personalized variant of your content has now been published. Your visitors will now start getting personalized content when visiting your website.

Next steps

Now that you have collected data and the first personalized variant published, you can start expanding the personalization further. Personalization is a continuous process and you can always make adjustments to improve your website performance. Monitor the performance of your segments, add more variants, and keep personalizing your website content.

Find some guides below to make adjustments to your personalized content.

Edit an existing variant

After setting up a personalized variant of a content item, you can add custom CSS and JavaScript. Follow the steps below to learn how.

  1. Navigate to the content item with the variant you want to edit.

  2. Open the Personalization view.

  3. Select Edit on the variant you want to make changes to.

  4. Click on the Edit variant button below the Page Title.

  5. Add your custom CSS and/or JavaScript.

  1. Save and close to persist the changes.

  2. Save and publish the content item.

Configure the status of a variant

In some cases, you might want to change the status of a variant. Follow the steps below to set a variant status to inactive.

  1. Navigate to the content item with the variant you want to edit.

  2. Open the Personalization view.

  3. Select Edit on the variant you want to edit.

  4. Click on the Edit variant button below the Page Title.

  5. Use the toggle at the bottom of the pop-up to change the variant status.

  1. Save and close to persist the changes.

  2. Save and publish the content item.

With the Persona groups and Personas in place, it is time to evaluate and score your content for each persona. Giving content a high score for a persona means that this content is especially relevant for that persona. By scoring your content, you will be able to find the true intention of your visitor. .

Learn more about content scoring in the Personalization section
How to Create Personas tutorial
Step 1: Define Your Target Audience
Step 2: Score Your Content
Step 3: Build Segments
Step 4: Collect Data
Step 5: Create Personalized Content
Next Steps
Score content for each Persona from the Personalization Content App on each content item.
Create segments from the Personalization dashboard in the Umbraco Engage section of the backoffice.
Choose which parameter you want to base your new segment on.
Select the specific persona and whether they should be included or excluded.
Create personalized versions of content items from the Personalization dashboard.
To add a new personalization variant you need to select a segment and add a name and a description.
Use the split-view to personalize the fields in the variant that has been configured for segmentation.
Edit the variant to add custom CSS and/or JavaScript to the variant.
Edit the variant to toggle the status in case you want to make a variant active/inactive.