[Propensity](/docs/ai-hub/predictions/propensity), [Best Fit](/docs/ai-hub/predictions/bestfit) and [Lookalikes](/docs/ai-hub/predictions/lookalikes) prediction models require configuration of AI engine. The Lookalikes model will be ready to use as soon as you select the item feed, however, for the Propensity and Best Fit models you must additionally. There is no option to enable Propensity and Best Fit separately. To configure AI engine, you must perform the following steps in a given order: 1. [Adding item feed](#adding-item-feed) 2. [Selecting an item feed](#selecting-item-feed) 3. [Grouping feed attributes](#grouping-feed-attributes) 1. [Selecting filterable attributes](#selecting-filters) 2. [Enabling propensity and best fit predictions](#enabling-propensity-and-best-fit-predictions)

You can use the same item catalog for lookalikes, propensity, and best fit predictions, AI Search, and recommendations.

## Adding item feed --- The first step is selecting the feed from which items will be sourced. You can either select a catalog that contains a feed or use Google Merchant Feed. Make sure, the item feed includes the following attributes: - `title` - The name of the item - `category` - The category of the item You can read about requirements for item feed: - [uploaded to a catalog](/docs/ai-hub/item-feed/item-feed-in-catalog) - [pulled from an URL](/docs/ai-hub/item-feed/google-merchant-feed) Grouping feed attributes is available for this feed type. If you previously configured a feed which you want to use now, you can omit this step.

- We recommend using Google Merchant XML instead of XML files due to the size limits (an XML file cannot exceed 10 MB). - If you're enabling AI engine for visual similarity recommendation model, select the item feed which contains less than 1,000,000 items.

1. Go to **Settings > AI engine configuration**. 2. Click **Add feed**. **Result**: A pop-up appears.

3. Select the product feed you want to use. - **Catalog** 1. On the pop-up, select the type of catalog: - Data catalog - [Metadata catalog](/docs/ai-hub/item-feed/metadata-catalog) 2. From the dropdown list, select a catalog.

3. Confirm by clicking **Apply**. **Result**: An item feed based on the contents of the selected catalog appears on the list in **Settings > AI Engine configuration**. - **Google Merchant**

Include the [Last-Modified](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Last-Modified) header to enable detection of whether the product feed import is necessary, this will help you reduce data transmission costs.

1. Provide the following information: - the link to the Google Merchant feed (**Feed link**), - the name of the field (**Feed name**), this name will be visible on the list of item feeds in Synerise in **Settings > AI Engine Configuration** - the frequency of pulling updates from the feed to Synerise (**Interval**), - authentication type (**Authentication type**), - username and password (**Basic** authentication type) - username, password, token type, URL (**Bearer** authentication type)

A pop-up with configuration of pulling data from Google Merchant Feed

2. Proceed to the next step by clicking **Next**. 3. If you want to group feed attributes, enable the toggle. Further [grouping settings are defined](#grouping-feed-attributes) after adding the feed. Grouping feed attributes refers to organizing the attributes or fields within an item feed into logical groups. Instead of treating each product variant — such as different sizes or colors — as a separate item in the feed, all variants of a product are combined and grouped into a single item.

A pop-up with enabling grouping feed attributes

This action is irreversible after applying.

4. Confirm by clicking **Apply**. **Result**: The feed appears on the list in **Settings > AI Engine configuration**. ## Selecting item feed --- 1. In **Settings > AI Engine Configuration**, on the list of feeds, click the feed you added according to the [Adding item feed](#adding-item-feed) procedure. The configuration form opens. In the **Item catalog** section, the feed you are configuring is selected automatically and you can proceed to the next part of the configuration.

[Supplemental catalogs](/docs/ai-hub/item-feed/supplemental-catalog) are used exclusively for recommendations. When you [add a supplemental catalog and connect it to an item feed](/docs/ai-hub/item-feed/supplemental-catalog#create-a-supplemental-catalog-feed-linked-to-your-catalog), the attributes from the supplemental catalog become available as [Supplemental attributes](/docs/ai-hub/item-feed/supplemental-catalog#supplemental-attributes) in the [recommendation filters](/docs/ai-hub/recommendations-v2/recommendation-filters).

## Grouping feed attributes ---

This option is available only for feeds from Google Merchant XML files.

Grouping feed attributes organizes attributes or fields within an item feed into logical groups. Instead of treating each product variant — such as different sizes or colors — as a separate item in the feed, all variants of a product are combined and grouped into a single item. During this grouping process, a "base" product is selected as representative. This is done by first gathering all products that share the same `itemGroupId`, then grouping them by category, and finally selecting the first product from the largest category group to serve as the base.

Null values and empty attribute values are not handled and will not appear in the grouped results.

When adding such a feed to Synerise, you must enable the grouping of feed attributes. Please note that enabling grouping is irreversible. 1. In the **Grouping feed attributes** section, click **Show**. **Result**: Grouping rules are shown. The system automatically prepares grouping rules. 2. Verify the proposed grouping rules. When configuring the grouping of feed attributes, you must map source fields to target fields using one of the following aggregators. Each aggregator determines how values from multiple items are combined: | Aggregator | Description | Example | Aggregated Result | |----------------|--------------------------------------------------------------------------------------------------|------------------------------------------------------|----------------------------| | **or** | Performs a logical OR on boolean values. Returns `true` if any value is `true`, otherwise `false`. | `true, false, false` | `true` | | **arrayDistinct** | Aggregates unique, non-null values into an array, removing duplicates. | `"41", "42", "41", "42"` | `["41", "42"]` | | **arrayFlatten** | Flattens nested arrays into a single array combining all elements. | `["123", "456"], ["456", "789"]` | `["123", "456", "456", "789"]` | | **array** | Aggregates values into an array, preserving order. | `"41", "42"` | `["41", "42"]` | | **single** | Selects the first non-null value from the list. For the `availability` attribute, the aggregated result will be a boolean value. | `"PROD123", "PROD124"` | `["PROD123"]` | 3. To add your own rule, click **Add rule**. 1. In the **Source filed** dropdown, select an item attribute from the feed pulled from Google Merchant. 2. From the **Aggregator** dropdown list, select the aggregator based on which attribute values will be combined. 3. In the **Target field** dropdown list, select the attribute which will hold the aggregated values. You can create an attribute. 4. Confirm by clicking **Apply**. ## Selecting filters --- In this part of the process, you will define the attributes for filtering items. Attributes selected in this section become available for use in filters in the Propensity predictions settings and are also accessible in **Decision Hub**.

Every day, attributes added to **Filterable attributes** are automatically deleted if they fulfill all of the following conditions: - They were added to filterable attributes more than 10 days ago. - They are not used in any search or suggestion index configuration. - They are not set as filters or boosting rules in any recommendation campaign. - They are not set as a default filter in any recommendation configuration. - They are not used as additional filters in any recommendation API/SDK request.

1. On the **Filterable attributes** tab, click **Show**. 2. Click **Select attributes**. 3. Select the checkboxes next to the attributes which you want to use for filtering the recommendation results. **Recommended**: Don't use `title` or `description` as filterable attributes. Using these attributes as filterable has a negative impact on performance. 4. Confirm by clicking **Apply**. **Result**: You will be able to filter the items by the attributes you have just added.

Item filter section in the settings of the Propensity prediction

## Enabling propensity and best fit predictions --- In this part of the process, you will enable the usage of items from the product feed for preparing the Propensity and Best Fit predictions. To be able to filter the items for predictions, make sure you [selected attributes which will be available for filtering](#selecting-filters). 1. In the **Propensity and Best Fit** tab, click **Show**. 2. Set the toggle to **Enabled**. ## Removing item feed --- You can remove item feeds from the list. While removing item feeds, any Synerise objects that rely on the feed as a source of information (such as predictions, recommendations, AI search) will be automatically disabled. Prior to confirming the removal operation, you will be presented with a list of objects that are currently using the feed to be removed. The feed will be removed after 7 days from confirming the action. During this transitional period, the feed and the objects associated with it will remain active. In the case of a feed within a catalog, the contents of the catalog will be deleted, while the catalog itself will be retained. 1. Go to **Settings > AI engine configuration**. 2. Next to the name of the feed you want to remove, click

3. From the dropdown list, select **Delete**. **Result**: A pop-up appears with the list of objects that are currently using the feed. 4. To confirm the operation, click **Yes, delete feed**.