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

# Product Recommendations

Turn user–item interactions into ranked recommendations and campaign audiences. Items can be products, deals, donation campaigns, or other entities represented in your catalog.

## What you can do

* Recommend relevant items to each user.
* Find items related to another item.
* Find an audience for each item, vendor, or category.
* Rank a user's vendor or category preferences.
* Allocate one campaign audience between targets, with one assignment per customer and a separate recommendation ranking.

The distinction between audiences matters: independent lists per offer can overlap; allocation assigns each selected customer once. Neither an affinity score nor a revenue-based allocation weight is a conversion or revenue forecast.

## How it works

An intelligence learns from your user, item, and interaction models. Recommendation scenarios reuse that trained model with their own scopes, objectives, delivery rules, and schedules. The interface calls these scenarios predictions.

Choose the business identity carefully: recommending a deal is not the same as recommending its vendor. Restrict sources to the population you want to serve and candidates to the items or users allowed in the result.

Results are published to your warehouse and exposed through DinMo models. Review publication, coverage, freshness, and evidence before activating them. Technical success, offline relevance, and campaign impact are separate checks.

## Documentation guide

| Start here                                                                                                | What you will learn                                                            |
| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| [Prepare your data](/intelligence/product-recommendations/prepare-your-data.md)                           | Technical prerequisites, required models, optional mappings, and data quality. |
| [Choose a recommendation use case](/intelligence/product-recommendations/recommendation-use-cases.md)     | Output types, source and candidate segments, and item availability.            |
| [Build and allocate audiences](/intelligence/product-recommendations/audiences-and-allocation.md)         | Overlap, unique assignments, weighted distribution, and companion rankings.    |
| [Configure and refresh](/intelligence/product-recommendations/configure-and-refresh.md)                   | The main configuration choices, training, refresh, and delivery rules.         |
| [Understand performance](/intelligence/product-recommendations/understand-performance.md)                 | Coverage, evaluation metrics, score limitations, and commercial validation.    |
| [Use results and best practices](/intelligence/product-recommendations/use-results-and-best-practices.md) | Output fields, activation checks, and keeping computation focused.             |


---

# 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 dynamically by asking a question.

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

```
GET https://docs.dinmo.io/intelligence/product-recommendations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.