Implement the Mediation Layer

Constructor’s Mediation Layer allows you to leverage your preferred retail media network (RMN) for campaign management while simultaneously taking advantage of the optimization available through Constructor’s ranking algorithms.

Integrate the Mediation Layer with designated RMN

Integrating Constructor’s Mediation Layer with your RMN is a straightforward process.

  1. Provide the Constructor team with the sandbox and production URLs for your RMN spaces. You can give this information to your Customer Success Manager.
  2. Let the Constructor team know the preferred configuration of a PLP:
    • Sponsored grid: Can be fixed or fluid.
    • Sponsored products per page: Can include sponsored items on the first or multiple pages.
  3. Ensure requests to Constructor include RMN-specific parameters. Constructor will pass these fields to your RMN for use in that platform.
    • For example, a parameter that specifies the customer ID. /browse/abc?...&sl[customer_id]=123&sl[category_ids]=456&sl[retailer_visitor_id]=7890
  4. Make sure the RMN returns as many products as possible.
    • Why is this important? The more products Constructor has to rank for a user, the more value we can provide in terms of optimizing for your key metrics.
  5. If necessary, ensure you render sponsored badges for those products Constructor returns with the label ad_id.

Event tracking with the Mediation Layer

Tracking with the Mediation Layer has two parts: Constructor tracking and RMN tracking.

Constructor tracking

Constructor’s beacon tracks impressions, clicks, conversions, and other tracking parameters automatically.

You will need to expose the parameter campaign_id to the Constructor beacon through HTML variables. You can take the campaign_id value from one of the labels depending on the RMN you use.

For example, if a Constructor response has the following labels, then the campaign_id value should be 123.

"labels":{
    ad_id: "123",
}

Please consult with your Constructor Implementation Team as to which label you should use for Constructor’s tracking purposes

RMN tracking

Constructor will return everything you need for RMN tracking in its response, using the labels directive. Please refer to your RMN’s documentation for instructions on how to use those parameters.