Skip to content

Storefront changes

To support sponsored products in the storefront, the following is needed:

  • Send impression events when sponsored products are viewed
  • Make sponsored products visually distinct
  • Ensure correct metadata is included in requests

Impression tracking

Whenever sponsored resources become visible to storefront visitors, impression notifications must be triggered. This is done by firing an impression notification. Send an impression notification, using the product's ticket, for every sponsored product that is rendered in:

  • Primary lists with sponsored products.
  • Search results with sponsored products.
  • Recommendation lists with sponsored products.

Sponsored products have the field sponsored set to true.

Changed behaviour for primary lists

Previously, only one impression notification was required per primary list — triggered when the first sponsored product became visible. This has changed: an impression notification must now be sent for each individual sponsored product that is seen.

When to send notifications

The general guideline is to send a notification when 50% of the sponsored product has been on screen for at least a second, but this is not a rule.

Refreshing the page or filtering the product selection might cause sponsored segments to change. In this case you may send a new impression notification, though this is not required.

Distinguishing sponsored resources

Although Voyado does not require it, you may need to clearly label sponsored content to comply with local advertising or consumer protection regulations.

To support this, sponsored products have the field sponsored set to true, allowing you to make them visually distinct.

Metadata

In order to identify non-human traffic, it is important to add valid request headers in the call to Elevate. The headers needed are:

  • User-Agent: with the user agent of the storefront visitor.
  • X-Forwarded-For: with the IP address of the storefront visitor.

Without valid values in the request headers, sponsored content will not be served.

Response caching

Do not cache responses from the Elevate Retail Media service. Each response represents a real-time bid decision that is based on the current context and user activity. If responses are cached:

  • Fill rate will decrease: cached responses may no longer be valid when reused, leading to missed opportunities.
  • Revenue will be lost: reusing a previous bid response without new auction logic prevents fresh competition and accurate pricing.
  • User experience may degrade: showing outdated ads can reduce relevance and engagement.

To ensure accurate bidding and maximum revenue, always request a new response from Elevate for every advertising placement.

×
Copyright

This online publication is intellectual property of Voyado Lund AB. Its contents can be duplicated in part or whole, provided that a copyright label is visibly located on each copy and the copy is used in conjunction with the product described within this document.

All information found in these documents has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither Voyado Lund AB nor the authors shall be held liable for possible errors or the consequences thereof.

Software and hardware descriptions cited in these documents might be registered trademarks. All trade names are subject to copyright restrictions and may be registered trademarks. Voyado Lund AB essentially adheres to the manufacturer’s spelling. Names of products and trademarks appearing in this document, with or without specific notation, are likewise subject to trademark and trade protection laws and may thus fall under copyright restrictions.

CLOSE