> For the complete documentation index, see [llms.txt](https://docs.abtasty.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction.md).

# Web recommendation

## Prerequisites

Before setting up your first web recommendation, ensure the following prerequisites are completed:

* **CMS Integration:** Verify that your CMS is properly connected to the platform.
* **Analytics Integration:** Ensure your analytics tool is successfully integrated.

## Step 1: Access the Web Recommendations Tab <a href="#h_01jdphk77fevdrg1mbarj2396k" id="h_01jdphk77fevdrg1mbarj2396k"></a>

1. Once the integrations are complete, navigate to the ‘Web Recommendations’ tab in the left-hand menu.
2. If your tools have been correctly connected, you will see the configuration page, allowing you to start creating your first recommendation.

![](https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2Fgit-blob-30272f40d4caf31e41c08faf5c99e59cf8f91675%2F5874791b34663fef02f3ea21f7b04ce9.png?alt=media)

### Troubleshooting Integration Issues <a href="#h_01jdphkst304bcjy04j25gc15y" id="h_01jdphkst304bcjy04j25gc15y"></a>

If an error message appears indicating that the integration procedure has not worked:

* Double-check the integration settings for your CMS and analytics tool.
* Verify that all provided credentials are valid and correctly entered.
* Contact your Customer Success Manager (CSM) for support if the issue persists.

## Step 2: Create a New Recommendation <a href="#h_01jdphn1va1mwa4dqkker1xycw" id="h_01jdphn1va1mwa4dqkker1xycw"></a>

1. Click on the ‘New Recommendation’ button.
2. You will be redirected to the recommendation configuration page.

![](https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2Fgit-blob-0454e2e107e3a8bf13b2ba22a89d5999be123b7e%2Faccf782159ae13e0eff8b81fed79e22d.png?alt=media)

## Step 3: Name Your Recommendation <a href="#h_01jdphmyj8erzk8wjbh4saz50s" id="h_01jdphmyj8erzk8wjbh4saz50s"></a>

1. At the top of the configuration page, click on the bold title to rename your recommendation.
2. Choose a clear and descriptive name to make it easy to identify later.

![](https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2Fgit-blob-56c1e850684ac3dec4f53f462bb4766e929ef943%2F80d5d303ac56f00f2e97fe34b3c8f380.png?alt=media)

## Step 4: Configure Recommendation Parameters <a href="#h_01jdphmvekafaw773x5f8m972f" id="h_01jdphmvekafaw773x5f8m972f"></a>

To create a recommendation, you need to define several key parameters. While not all parameters are mandatory, the more detailed your configuration, the better the results.

Here are the main parameters to configure:

* [**Placement**](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction/placement.md): Define where the recommendation will appear on your website.
* [**Product Groups:**](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction/products-groups.md) Specify the groups of products to include in the recommendation.
* [**Filters:**](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction/filters.md) Apply filters to refine the product selection based on criteria like price, category, or stock.
* [**Products Highlight:**](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction-1/products-highlights.md) Pin specific products to feature them prominently in the recommendation.
* [**Exceptions:** ](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction/options.md)Add dynamic rules to tailor recommendations based on specific triggers or conditions.
* [**Options:**](https://support.abtasty.com/hc/en-us/articles/17090034039324) Customise additional settings, such as excluding cart items or setting a fixed number of products.

\
For detailed guidance on configuring each parameter, refer to the corresponding help pages within the platform.

## Save Your Configuration <a href="#h_01jdphq4xjhf6m5mcr2t4cfc5m" id="h_01jdphq4xjhf6m5mcr2t4cfc5m"></a>

After completing the setup, click the ‘Save’ button to ensure your changes are applied.

## Preview Your Recommendation <a href="#h_01jdphq0j2vh66fd4w9qtw6r1s" id="h_01jdphq0j2vh66fd4w9qtw6r1s"></a>

Use the ‘Preview’ button in the top-right corner to visualise the recommendation and verify that it meets your expectations.

## Additional Notes <a href="#h_01jdphq2n9v5qnf2fmrs8w0dj8" id="h_01jdphq2n9v5qnf2fmrs8w0dj8"></a>

* Taking the time to configure all parameters ensures that your recommendations are highly relevant and effective.
* Regularly preview and test your configuration to ensure optimal performance.
* If you encounter issues, consult the platform documentation or contact your Customer Success Manager (CSM) for personalised assistance.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
