# Mail recommendations

This page is intended for customers who do not have the recommendation builder. If you have the recommendation builder, you can consult [this page](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/recommendation-banner/how-to-build-recommendations-recommendation-builder-variant).

Before setting up your first 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 Recommendations Tab <a href="#h_01jdpdne2t4cdpzm0mp29dha8j" id="h_01jdpdne2t4cdpzm0mp29dha8j"></a>

If everything is set up, navigate to the ‘Mail Recommendations’ tab in the left-hand menu.\
If your tools have been connected correctly, this page will allow you to start configuring your first recommendation.

**Troubleshooting Integration Issues**

If you see a message indicating that the integration procedure has not worked:![](https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2Fgit-blob-3ca58f8c6a41c3e7b2b2abc0b02b6307013e8611%2Fcbb8fb34ebb5dd17175bc2d3194c0b16.png?alt=media)

* Double-check your CMS and analytics integration settings.
* Ensure all provided credentials are valid and correctly entered.
* If the issue persists, contact your Customer Success Manager (CSM) for assistance.

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

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

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

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

At the top of the configuration page, click on the bold title to rename your recommendation.\
Choose a clear and descriptive name that will help you identify the recommendation later.

### Configuring Parameters <a href="#h_01jdpds39wmbgmyjbdq5xxb2mg" id="h_01jdpds39wmbgmyjbdq5xxb2mg"></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 you can configure:

* [**Brevo Feed**](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction-1/brevo-feed): Ensure the feed from Brevo is correctly linked to the recommendation.
* [**Product Groups**](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction/products-groups): Define groups of products to include in the recommendation.
* [**Filters**](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction/filters): Apply filters to refine the selection of recommended products.
* [**Product Highlights**](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction-1/products-highlights): Highlight specific products within the recommendation.
* [**Exceptions**](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction/exceptions): Exclude certain products or categories as needed.
* [**Options**](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction/options): Set additional options to customise the behaviour of your recommendation.
* [**Parameters**](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction-1/parameters): Configure advanced parameters for more granular control.
* [**Preview**](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction-1/preview): Check how the recommendation will appear to your audience.

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

## Step 4: Save Your Recommendation <a href="#h_01jdpdyddh4tk35p668ftnn7j2" id="h_01jdpdyddh4tk35p668ftnn7j2"></a>

Once all parameters are set, click on the ‘Save’ button to ensure your configuration is stored.

## Step 5: Preview the Result <a href="#h_01jdpdyfx7pn947qsmppn0xncf" id="h_01jdpdyfx7pn947qsmppn0xncf"></a>

Before finalising, click on the ‘Preview’ button in the top-right corner to see how your recommendation will look in real-world scenarios.

**Additional Notes**

* Taking the time to fully configure each parameter will enhance the relevance and effectiveness of your recommendations.
* If you encounter any issues during the process, refer to the platform’s documentation or contact your CSM for guidance.

Discovery how to [Push recommendations into your Brevo emails](https://docs.abtasty.com/recommendations-and-merchandising_deprecated/recommendations/introduction-1/how-to-push-recommendations-into-your-brevo-emails)


---

# 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/recommendations-and-merchandising_deprecated/recommendations/introduction-1.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.
