1. Affinities

Set up affinities for a site

Important

Feature availability is part of a phased rollout. Your organization may not see this functionality yet. It will become available when your environment is included in the rollout.

Before you can use affinity scores to personalize experiences in SitecoreAI, you must first set up affinities on your site pages.

Affinities describe the interests represented by a page. Each affinity consists of:

  • an Affinity name - the attribute you want to track, for example, product_type, topic, content_type.
  • an Affinity value - a specific value associated with that attribute on the page, for example, electric, suv, compact.

When visitors view pages with assigned affinities, SitecoreAI uses those affinities to calculate affinity scores based on their browsing behavior. These scores indicate how strongly a visitor is interested in each affinity value.

Note

  • You must set up affinities on individual pages within a site.

  • Affinities assigned to pages on one site do not apply to other sites.

  • Each page can have up to 10 affinities.

  • You can use the same affinity name multiple times on a page, as long as each affinity has a different value.

  • Only pages with assigned affinities contribute to affinity score calculations.

Set up affinities on a page

Use affinities to define the attributes and values that represent the interests associated with a page.

Choose affinity names and values that reflect the interests you want to track.

Example

For a page about vehicle models, you might configure the following affinities:

  • Affinity name: product_type and Affinity value: electric
  • Affinity name: model and Affinity value: suv
  • Affinity name: focus and Affinity value: performance

You can also use the same affinity name more than once on a page when each affinity has a different value. For example:

  • Affinity name: model and Affinity value: suv
  • Affinity name: model and Affinity value: sedan

When a visitor views the page, SitecoreAI updates the affinity score for each associated value, helping identify the visitor's interests.

To set up affinities on a page:

  1. In the navigation menu, click Performance.

  2. In the left-hand pane, select Settings > Affinities.

  3. On the Affinities page, select the site where you want to set up affinities. The site pages appear in a list similar to the content tree in Page builder.

  4. Select the relevant page then click Add affinity.

  5. In the Add affinity dialog, specify the affinity name and value:

    • In the Affinity name field, enter the attribute you want to track on the page (for example, product_type, model, focus).
    • In the Affinity value field, enter the specific value associated with that attribute (for example, electric, suv, performance).

    For example, on a vehicle product page, you might add the following affinity:

    • Affinity name: product_type and Affinity value for electric, indicating interest in electric vehicles.

    Tip

    When entering affinity names and values, use a-z0-9, and underscores for spaces.

  6. Click Save.

  7. To add additional affinities to the same page, repeat these steps. You can use the same affinity name with different values. You can add up to 10 affinities per page.

Next steps

After affinities are set up, SitecoreAI starts calculating affinity scores as visitors view your pages.

You can then use these scores to customize experiences based on what each visitor is most interested in. See Personalize a page using affinities.

If you have suggestions for improving this article, let us know!