If you are live with Sponsored Listings, then Constructor will include sponsored labels as part of a search or browse API response. If a result set includes sponsored items, then the API response will include the is_retail_media: true flag for those items. Deciding how sponsored labels will display on a results page is the responsibility of your team.

The response format for a sponsored item is as follows:

{
  "results": [{
    // ...
    "labels": {
      "is_retail_media": true,
      // Optional properties, depending on the provider
      "sl_campaign_id": "349eaf16-d1a0-48ab-a4d8-343a05553778",
      "sl_campaign_owner": "Advertiser Name"
    }
  }]
}

Responses, like the one above, can also include the following optional labels:

• sl_campaign_id: The ID of the campaign from which the product came. It is optional, depending on the provider of the sponsored items.
• sl_campaign_owner: Indicates the advertiser that promoted this product. It is optional, depending on the provider of the sponsored items.

Event tracking for sponsored items

Event tracking for sponsored items will depend on what platform is providing the item—Constructor or a third-party Retail Media platform.

Tracking for a sponsored item from Constructor

For Constructor’s beacon to track events for sponsored items, you must expose the campaign id (sl_campaign_id) and the advertiser (sl_campaign_owner) in your site’s HTML code.

When rendering a search and browse results set, add the data-cnstrc-sl-campaign-id and data-cnstrc-sl_campaign_owner properties to each DOM element representing one item using the data provided in labels as described above.

Learn more about tracking via HTML attributes in our data-driven event tracking documentation.

Tracking for media from a third-party retail media platform

If you’re using a third-party Retail Media platform through Constructor’s Mediation Layer, you will receive a set of properties that the provider uses for tracking in labels. The exact set of properties depends on the provider, but they are prefixed with dsp_. You can then implement tracking with the provider by exposing or sending this data to them as you would if you were integrating with them directly.

Alternatively, you can let Constructor do the work. If you use our beacon for tracking, then we can forward our tracking data to your provider. Please note that provider-specific limitations may exist, and an exact plan will be discussed during implementation.

Displaying sponsored labels

Your team is responsible for designing and rendering the “sponsored” badge for related items on a search results or browse category page. Your region may have legal requirements for how these items are labeled, so please defer to those requirements.

In general, we recommend labeling sponsored products subtly, with text as Sponsored or Featured.

Below are results pages from different companies that show how those companies have chosen to label sponsored items.