Omnichannel Recommendations Reporting Requests

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 whenever products are presented to the customer or whenever a customer swipes along a carousel to see additional recommendations.
Use monetate:record:RecClicks whenever a customer clicks or taps a product recommendation so that Monetate can record the click.

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.

In the initial request, send the relevant product IDs depending on the recommendation strategy that you're using.
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"
Send the recToken in a second request when the impression occurs, followed by a third request when the click occurs.

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

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