Source: https://docs.amadalis.ai/optimization/audiences-and-targeted-content/

# Audiences and targeted content

Checked against the product’s code on 7 November 2026.

Learn how to show a different banner to returning visitors, or other content to an audience, in **Optimization** > **Audiences** and **Personalization** > **[Targeted content](https://docs.amadalis.ai/reference/glossary/#targeted-content)** in the site admin. For returning visitors, use the built-in **returning** audience and follow [Create targeted content](https://docs.amadalis.ai/optimization/audiences-and-targeted-content/#create-targeted-content); you do not need a new rule. Consent and **Holdback %** still apply.

An [audience](https://docs.amadalis.ai/reference/glossary/#audience) defines who qualifies. Targeted content defines what those people see. Creating an audience alone does not change a page.

## Build a rule audience

1.  Open **Optimization**.
    
2.  Open **Audiences**.
    
3.  Choose **\+ New audience**.
    
4.  Choose **Build a rule**.
    
5.  Enter the audience’s name in the first field.
    
6.  Choose its conditions from the available fields.
    
    [![Build a rule with Segment name Docs Walk Audience, a Trait condition Viewed page is /docs-walk-first-page, and the preview sentence.](https://docs.amadalis.ai/images/steps/S036-audiences-rule-name-and-viewed-page.png)](https://docs.amadalis.ai/images/steps/S036-audiences-rule-name-and-viewed-page.png "Open full-size image")
    
    Name the audience and add a condition. The preview says it in plain words.
    
    [![The same rule with an AND group set to any of, Channel is Direct or Referral.](https://docs.amadalis.ai/images/steps/S036-audiences-rule-any-of-group.png)](https://docs.amadalis.ai/images/steps/S036-audiences-rule-any-of-group.png "Open full-size image")
    
    A group holds alternatives: any of, all of or none of.
    
7.  Review how the conditions are grouped.
    
8.  Use the form’s save control. A new rule is saved as a draft.
    
    [![Docs Walk Audience page marked Draft, Members not counted yet, and a note that a draft rule is not evaluated for any visitor.](https://docs.amadalis.ai/images/steps/S036-audiences-rule-saved-as-draft.png)](https://docs.amadalis.ai/images/steps/S036-audiences-rule-saved-as-draft.png "Open full-size image")
    
    A saved rule starts as a draft and checks nobody.
    
9.  Open the saved audience.
    
10.  Choose **Activate**.
     
11.  Read **Turn on this audience?**
     
12.  Choose **Turn it on** or **Leave it off**.
     

**Deactivate** turns it off again.

[![Turn on this audience? says no targeted content uses the audience yet, with Leave it off and Turn it on.](https://docs.amadalis.ai/images/steps/S036-audiences-turn-on-card.png)](https://docs.amadalis.ai/images/steps/S036-audiences-turn-on-card.png "Open full-size image")

Turning it on asks first.

[![The audience marked Active with the receipt Turned on Docs Walk Audience, with Undo.](https://docs.amadalis.ai/images/steps/S036-audiences-turned-on-receipt.png)](https://docs.amadalis.ai/images/steps/S036-audiences-turned-on-receipt.png "Open full-size image")

Active, with Undo.

A draft rule is not evaluated for visitors. An active rule is checked on every page view. It shows visitors nothing until targeted content uses it. Editing an active rule changes who qualifies on later page views.

Conditions outside a group must all match. Choose **\+ Any-of group** to add a group, then set it to **any of** or **none of**. An **any of** group needs at least one matching condition. A **none of** group needs no matching condition in that group. Choose fields and values the product actually offers rather than assuming a visitor fact exists.

**Region** and **City** come from the request itself, and are read only for visitors who allowed personalization. Enter a region as its code, such as `US-MA`. A rule with **City** also needs **Country** or **Region**, because many places share a city’s name. A city comes from the visitor’s network location, which is often wrong on mobile and office networks.

## Understand the audience list

The list includes rule audiences and audiences based on [affinity](https://docs.amadalis.ai/reference/glossary/#affinity) signals. Choose **Affinity signal** when the audience should come from a scored interest. That path needs the affinity engine’s setup and relevant activity first.

A rule’s member count can say **not counted yet**. The product checks the rule on page views and does not keep a running count for every rule. That message is not a count of zero people.

Affinity audience details offer **Definition**, **Members & why** and **Analytics**. Use the definition and membership reasons to understand that audience before targeting it.

### Create an affinity audience

Editors and Admins can create an audience from a real catalog interest. First complete [the affinity engine’s setup](https://docs.amadalis.ai/optimization/affinity-settings/) and check the relevant [catalog attributes](https://docs.amadalis.ai/optimization/content-catalog/). Membership comes from recorded interest as it rises and fades, not visitor identifiers you type in.

1.  Ask the copilot: “Create a draft affinity audience for visitors interested in \[existing catalog attribute and value\].”
2.  Read the saved draft and condition. Creating it needs no approval; a draft has no members.
3.  Ask: “Activate \[audience name\].”
4.  Read **Change this audience’s status?**, including the effect on content already targeted to it.
5.  Choose **Change audience status** if that is intended.
6.  Open the audience and read **Members & why** before using it for targeted content.

To stop using that affinity audience, ask to archive it and review the same status card. A status change can affect live targeting. Its receipt’s **Undo** restores the previous status only while the audience has not changed again. Creating the draft also has receipt Undo. See [Affinity audience requests](https://docs.amadalis.ai/reference/copilot/audiences-and-targeting/#audience-definitions-and-saved-queries).

## Create targeted content

1.  Open **Optimization**.
2.  Open **Personalization**.
3.  Open **Targeted content**.
4.  Choose **New targeted content**.

Choose the kind of change:

| Choice | What it changes |
| --- | --- |
| **Content swap** | Different content in one section for an audience. |
| **Arrangement** | The order of sections on a page for an audience. |
| **Time-boxed offer** | A live offer triggered during a visit, with an expiry. |

For a first change, use **Content swap**:

A section field name identifies one editable value, such as its headline. Use the exact name in the linked section reference when creating a content swap. The readable field label and its code name can differ.

1.  Enter a name in the field at the top of the form, such as `studio-hero`. This is required.
    
    [![New targeted content with Content swap chosen, Name docs-walk-swap and Description Docs Walk Swap.](https://docs.amadalis.ai/images/steps/S038-audiences-targeted-content-name-and-type.png)](https://docs.amadalis.ai/images/steps/S038-audiences-targeted-content-name-and-type.png "Open full-size image")
    
    Choose Content swap and name it.
    
2.  Choose the **Audience**. It starts on the built-in **returning** audience, so change it unless that is the audience you want.
    
3.  Choose the page where the change belongs.
    
4.  Choose its **Section**.
    
5.  Under **3 · What**, type a field name on a row. The form does not list the section’s fields. Find the exact names in the [section reference](https://docs.amadalis.ai/reference/sections/). Each name must match one of that section’s fields, or the value is not shown.
    
6.  Type its new value.
    
7.  Use **\+ add a field** for more, repeating the name and value steps.
    
8.  Review **Holdback %**. It starts at 10, so 10 percent of matching visitors keep seeing the default as a comparison group. At 0 nobody is held back and the lift cannot be measured. The nearby hint keeps showing the initial percentage, so read the number in the field after editing it.
    
    [![Who: Docs Walk Audience, holdback 0; Where: Docs Walk First Page, Hero selected; What: headline DOCS WALK TARGETED.](https://docs.amadalis.ai/images/steps/S038-audiences-targeted-content-who-where-what.png)](https://docs.amadalis.ai/images/steps/S038-audiences-targeted-content-who-where-what.png "Open full-size image")
    
    Pick the audience, the page and section, and the field to change.
    
9.  Choose a [goal](https://docs.amadalis.ai/reference/glossary/#goal) under **Measured on** if you want to measure an outcome.
    

Choose one route:

-   **Save as draft** leaves it unpublished.
    
-   To review the proposed change:
    
    1.  Choose **Preview change**.
    2.  Read the consequence card.
    3.  Choose **Approve & make it live** or **Keep as draft**.
    
    [![The exact change (nothing is saved yet): makes Docs Walk Swap live for people in Docs Walk Audience, with Approve & make it live and Keep as draft.](https://docs.amadalis.ai/images/steps/S038-audiences-targeted-content-exact-change.png)](https://docs.amadalis.ai/images/steps/S038-audiences-targeted-content-exact-change.png "Open full-size image")
    
    The exact change is shown before approval.
    
    [![Receipt: Docs Walk Swap is now live for people in Docs Walk Audience, in the page's hero, with Undo.](https://docs.amadalis.ai/images/steps/S038-audiences-targeted-content-live-receipt.png)](https://docs.amadalis.ai/images/steps/S038-audiences-targeted-content-live-receipt.png "Open full-size image")
    
    Live, with Undo.
    

A draft audience cannot be targeted. **Save as draft** and **Preview change** stay off until you activate that audience or choose another one, and the form names the first missing choice beside them.

Targeted content on a page that is not published yet serves nothing until that page is published.

## Keep a useful default

The page’s default content remains necessary. Visitors who do not qualify, visitors held back for measurement and visitors for whom personalization is unavailable can see it.

[![Desktop page shows DOCS WALK TARGETED above its introductory text and Read the care guide button.](https://docs.amadalis.ai/images/steps/S039-audiences-matching-visitor-1440.png)](https://docs.amadalis.ai/images/steps/S039-audiences-matching-visitor-1440.png "Open full-size image")

A visitor in the audience sees the targeted headline.

[![Phone view with DOCS WALK TARGETED as the page headline.](https://docs.amadalis.ai/images/steps/S039-audiences-matching-visitor-390.png)](https://docs.amadalis.ai/images/steps/S039-audiences-matching-visitor-390.png "Open full-size image")

On a phone.

The matching visitor sees “DOCS WALK TARGETED” as the headline at phone width.

[![Desktop page shows the default headline Docs Walk: a first page above Read the care guide.](https://docs.amadalis.ai/images/steps/S039-audiences-default-visitor-1440.png)](https://docs.amadalis.ai/images/steps/S039-audiences-default-visitor-1440.png "Open full-size image")

A visitor outside the audience sees the default.

[![Phone view with the page’s own headline, Docs Walk: a first page.](https://docs.amadalis.ai/images/steps/S039-audiences-default-visitor-390.png)](https://docs.amadalis.ai/images/steps/S039-audiences-default-visitor-390.png "Open full-size image")

On a phone.

The default visitor sees “Docs Walk: a first page” as the headline at phone width.

Visitor consent and Global Privacy Control govern whether personalization may run. An audience rule does not bypass those choices.

Audience rules decide whether someone qualifies for personalised content. To stop a targeted item for its whole audience, open its record in **Personalization** > **Targeted content** and choose **Pause**.

## Review what happened

The targeted content’s receipt offers **Undo** when available. You can **Pause** live targeted content and **Resume** it later. **Archive** stays off while the item is live, so pause it first, and it asks **Really archive?** before it proceeds.

[![Record of docs-walk-swap: Active, with Pause, Edit and Archive; audience, holdback, placement, variant and fallback.](https://docs.amadalis.ai/images/steps/S040-audiences-targeted-item-record.png)](https://docs.amadalis.ai/images/steps/S040-audiences-targeted-item-record.png "Open full-size image")

Each targeted item has a record.

The targeted item is Active, with Pause, Edit and Archive beside its audience and page placement.

[![Stop this targeting? says Docs Walk Audience will see the default content again, with Approve & apply and Cancel.](https://docs.amadalis.ai/images/steps/S040-audiences-stop-targeting-card.png)](https://docs.amadalis.ai/images/steps/S040-audiences-stop-targeting-card.png "Open full-size image")

Pausing asks first.

[![Paused record with the receipt Stopped targeted content Docs Walk Swap, Undo, and Resume.](https://docs.amadalis.ai/images/steps/S040-audiences-stopped-receipt-undo-and-resume.png)](https://docs.amadalis.ai/images/steps/S040-audiences-stopped-receipt-undo-and-resume.png "Open full-size image")

Paused, with Undo and Resume.

Use **Performance** to compare targeted and held back visitors on the chosen goal. A positive difference based on too little activity or unfinished outcome periods is not a final result. Read the report’s messages about who was counted and whether enough results are available.

[![Measurement: exposures targeted 3, holdback 0, default 0; lift cannot be measured without a held-back group; History: activated, then paused.](https://docs.amadalis.ai/images/steps/S040-audiences-targeted-item-measurement-and-history.png)](https://docs.amadalis.ai/images/steps/S040-audiences-targeted-item-measurement-and-history.png "Open full-size image")

What it served, and its history.

The record has three targeted exposures and no held back exposures, so it cannot yet compare the targeted result with that group.

You can also ask the copilot to explain a named campaign’s recorded decisions, or compare its targeted and held-back results. A campaign with no held-back visitors cannot supply that comparison. The explanation request can inspect your own marked test browser; it does not inspect a real visitor’s personal record. See [Targeted content requests](https://docs.amadalis.ai/reference/copilot/audiences-and-targeting/#targeted-content-and-affinity).

For interest scores, decay and recommendations, continue with [The affinity engine, explained](https://docs.amadalis.ai/optimization/affinity-engine/). A rule audience does not require every visitor to have an affinity score.

### Mark your own test browser

Editors and Admins can mark their own browser to check personalization. Use this site’s own admin. The mark creates a fresh visitor identity; it cannot be applied to someone else’s visitor record. Personalization must be allowed in this browser. If the site asks first, or you declined it earlier, allow it on the site’s cookie banner before marking. If the site offers no way to allow it, read the refusal instead. A browser sending Global Privacy Control cannot be marked.

1.  Open **Personalization**.
2.  Open **Targeted content**.
3.  In **Test visitors**, type a label such as “My laptop” in the label field.
4.  Choose **Make this browser a test visitor**.
5.  Find the new row marked **this browser** and read its expiry date.

A label can have 1 to 40 characters. The mark lasts 30 days, with at most ten active test visitors per site. To remove it, choose **Remove** on its row, then **Remove this test visitor**. This removes the mark, not the browser’s recorded visitor history.