---
title: Omnichannel Recommendations Reporting Requests
slug: engine-api/recs-reporting
description: How to obtain Product Recommendations action-related data in Monetate Engine API requests
image:  https://archbee-image-uploads.s3.amazonaws.com/ceIfEvQHzQk1IVxoRWUh7/K9eTL4jKm7UQINb6zNziJ-20250912-181225.png
docTags: 
createdAt: 2024-05-15T19:09:07.107Z
---

When using the Engine API for recommendations, you must make subsequent requests when products are visually presented to the customer and when a customer clicks or taps any of the recommended products. This request is necessary to record the applicable item impressions and item clicks.

- Use [monetate\:record\:RecImpressions](docId\:VgkeZ_Dw5gcpO7DpqFW41) whenever products are presented to the customer or whenever a customer swipes along a carousel to see additional recommendations.
- Use [monetate\:record\:RecClicks](docId\:mb-dQXgU5doQcbjiqRlQy) whenever a customer clicks or taps a product recommendation so that Monetate can record the click.

:::hint{type="warning"}
The `monetate:record:EndcapImpressions` and `monetate:record:EndcapClicks` events are deprecated. Use `monetate:record:RecImpressions` and `monetate:record:RecClicks` instead.
:::

Complete the following steps to report product recommendations.

1. In the initial request, send the relevant product IDs [depending on the recommendation strategy that you're using](docId\:lhDbnL69OdDxYRG0MqJTj).
2. Find the unique `recToken` in the initial response. The response contains a unique `recToken` for each product within the recommendation strategy for that experience, such as the one in this example: `"recToken": "rt.1.WzL4LjI3NTQsICIwNDkwNTMiLCAiLDQ5LDUzIiwgMTQ4ODYsIDAsICIyMDIxLTExLTA0VDExOj"`
3. Send the `recToken` in a second request when the impression occurs, followed by a third request when the click occurs.

:::CodeblockTabs
Example Request for Product Recommendations Impressions

```json
{
  "channel": "a-927c8120/p/example.com",
  "monetateId": "xyz",
  "events": [
    {
      "eventType": "monetate:record:RecImpressions",
      "recImpressions": [
        "rt.1.WzL4LjI3NTQsICIwNDkwNTMiLCAiLDQ5LDUzIiwgMTQ4ODYsIDAsICIyMDIxLTExLTA0VDExOjQ4OjIyLjExNjM2NVoiXQ",
        "rt.1.yyy"
      ]
    }
  ]
}
```
:::

:::CodeblockTabs
Example Request for Product Recommendations Clicks

```json
{
  "channel": "a-927c8120/p/example.com",
  "monetateId": "xyz",
  "events": [
    {
      "eventType": "monetate:record:RecClicks",
      "recClicks": [
        "rt.1.WzL4LjI3NTQsICIwNDkwNTMiLCAiLDQ5LDUzIiwgMTQ4ODYsIDAsICIyMDIxLTExLTA0VDExOjQ4OjIyLjExNjM2NVoiXQ",
        "rt.1.yyy"
      ]
    }
  ]
}
```
:::