# Adaptive Search

Adaptive Search personalizes search results for each visitor. Rank and filter results based on predicted intent and affinities.

<figure><img src="/files/gQnAjvEPtvRu4Nbh1Uc4" alt=""><figcaption></figcaption></figure>

## What adaptive search does

Standard search treats all visitors the same. Adaptive search customizes results:

* **Rank by intent** - Predict what visitors want to find
* **Boost by affinity** - Highlight products matching interests
* **Filter by context** - Show relevant subsets
* **Personalize facets** - Sort filters by relevance

## How it works

1. **Visitor signals** - AdaptiveCX collects behavior, affinities, and predictions
2. **Search query** - Visitor enters a search term
3. **Real-time ranking** - Results scored and ranked for this visitor
4. **Personal delivery** - Results shown in optimal order

## Adaptive search list

Track performance of each search configuration:

* **Status** - Active or archived
* **Uplift** - Improvement vs baseline
* **Sessions** - Total searches
* **Conversion impact** - Effect on purchases

### Tabs

* **Ongoing Adaptive Searches** - Active configurations
* **Archived Adaptive Searches** - Inactive configurations

## Create adaptive search

{% stepper %}
{% step %}

#### Open Adaptive Search

Go to `Activate` > `Adaptive Search` and click **Create New Adaptive Search**.

<figure><img src="/files/XyrKiMSEKheuZaoq6kjx" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Configure basic settings**

Set up the search configuration:

* **Name** - Give your search a descriptive name
* **Schedule** - Choose when to start (immediately or scheduled)
* **Live QA** - Enable quality assurance testing

In the **What To Show** section:

* **Number of suggestions** - How many results to display (default: 7)
* **Prioritize by** - Most recent, relevance, or custom rule
* **Categories & Keywords** - Select affinity categories to boost
* **Colors** - Enable color-based recommendations
* **Brands** - Enable brand-based recommendations

In the **When To Show** section:

* **Until visitor types** - Show suggestions until visitor types N characters
* **Always show** - Always display personalized suggestions
  {% endstep %}

{% step %}
**Set targeting rules**

In the **Who To Target** section:

* **Traffic Source** - Target visitors from specific sources
* **Device** - Target by device type (mobile, desktop, tablet)
* **Audience** - Target specific audiences

Click **Edit** to configure targeting conditions.

Use **Terms to Promote/Exclude** to specify keywords that should always be boosted or hidden.
{% endstep %}

{% step %}
**Configure test/control split**

Set the percentage split between test (personalized) and control (baseline) groups:

* Move slider to allocate traffic
* 100% test means all visitors see personalized results
* Lower percentages create a control group for comparison
  {% endstep %}

{% step %}
**Add custom code (optional)**

Click **Next** to access the **Custom Code** tab:

* Add JavaScript for custom ranking logic
* Implement client-side personalization hooks
* Integrate with third-party search providers
  {% endstep %}

{% step %}
**Save and publish**

Click **Save as Draft** to save without activating, or publish to go live.
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.abtasty.com/adaptivecx/getting-started/activate/adaptive-search.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.