Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Important
Azure Intelligent Recommendations Retirement and Migration Plan
Azure Intelligent Recommendations will be retired on March 31, 2026.
We're retiring the product due to changes in strategy and focus with the onset of the copilot era. Currently, there are no equivalent services available within the Microsoft stack, so we can't offer a migration plan to a similar service.
Next steps:
- Identify or build an alternative.
- Migrate all your traffic to the chosen alternative.
- Stop calling the Recommendations endpoint before the shutdown date.
- Delete all service endpoints, modeling, and IR accounts in the Azure portal before the shutdown date.
We'll continue to monitor and maintain Azure Intelligent Recommendations during the retirement period. After the product is retired, we'll keep the service data for three months before deleting it.
This article provides guidance on how to configure opted-out users data entities in the Intelligent Recommendations data contract.
Data entities review
A data entity is a set of one or more data text files, each having a list of columns (also called attributes) and rows containing the actual data values.
Intelligent Recommendations defines logical groups of data entities, each with its own purpose.
Note
Data entities are optional, unless explicitly stated otherwise, which means that their data can be empty or missing.
For the full list of data entities, see data entities.
Introduction to opted-out users data entity
*Opted-out users refer to any logged-in users who elected to opt out from the personalized recommendations experience. Intelligent Recommendations takes into account the list of userIds and excludes these users' interaction data from our modeling. Additionally, it doesn't generate personalized recommendations specifically for those users.
There's only one data entity in the opted out users group.
Opted-out users
Data entity name: Reco_OptOutUsers
Description: Users who opted out from personalization
Attributes:
Name | Data type | Mandatory | Default value | Invalid value behavior | Comments |
---|---|---|---|---|---|
UserId | String(256) | Yes | Drop entry | Length limited to 256 characters. | |
LastModifiedDate | DateTime | Yes | See guidelines | See Required data entities per recommendations scenario for DateTime values. |
Guidelines:
- If there's an invalid value for the LastModifiedDate attribute, it's overridden with a DateTime value that represents when the data was ingested into Intelligent Recommendations.
Sample data:
Headers appear for convenience only and shouldn't be part of the actual data.
UserId | LastModifiedDate |
---|---|
User2 | 2019-10-31T22:30:00.000Z |
For the full list of data entities, see data entities.
See also
Data contract overview
Data entities mapping table
Catalog data entities
Interactions data entities
Reco configuration data entities
External lists data entities
Recommendations enrichment data entities
Image to item mapping data entities
Intelligent Recommendations API
Quick start guide: Set up and run Intelligent Recommendations with sample data