Skip to content

Product Feeds

The Slider component supports eCommerce creatives powered by external product feeds. Once connected, the slider automatically displays products with correct pricing, images, and availability — no manual configuration needed per product.

Products in the slider look the same as manually added slides and each links to the product page on your website.

Compatible feed formats

Your feed should be an HTTPS endpoint returning data in CSV, JSON, or XML format. Cavai Builder provides field mapping so your feed's field names don't need to match exactly.

Facebook product feeds and most standard eCommerce feeds work out of the box. If your feed isn't compatible, a feed management tool like Channable can help restructure it.

TIP

Feed data is cached by Cavai for performance and refreshed once per hour. Keep this in mind for stock availability.

Feed fields

The following fields can be mapped from your feed:

FieldFormatRequiredDescription
TitleStringYesProduct name
Link URLHTTPS URLYesClickthrough to product page
Image URLHTTPS URLYesProduct image
PriceNumber + currency (e.g. 29.99€)YesCurrent price (shown as discount price if different from Regular Price)
Regular PriceNumber + currencyYesOriginal price
Custom text AStringNoMapped to any feed property for display
Custom text BStringNoMapped to any feed property for display

Connecting your feed

Product feeds are accessed through Cavai's feed proxy, which provides caching, filtering, and field remapping.

Building a proxy URL

Start with the proxy base URL:

https://delivery-0.cavai.com/proxy/remapper/v2?

Add the required parameters:

ParameterRequiredDescription
urlYesYour product feed URL
formatYesFeed format: xml, csv, or json
limitNoMax number of products to return
root_pathNoPath to the items array if nested (e.g. items.item)
sort_keyNoField to sort by
sort_orderNoasc or desc
default[currency]NoDefault currency if not in feed (e.g. NOK, )
delimiterNoForce CSV delimiter if auto-detection fails (e.g. `
filter[field]NoFilter by field value (e.g. filter[category]=Shoes)

Example:

https://delivery-0.cavai.com/proxy/remapper/v2?url=https://files.channable.com/example.xml&format=xml&limit=15&root_path=items.item&sort_key=amount&sort_order=asc&default[currency]=NOK

Advanced filtering

The filter parameter supports multiple operators:

  • Name contains "new": &filter[name][HAS]=new
  • Weight between 100 and 500: &filter[weight][GT]=100&filter[weight][LT]=500
  • Either red or rounded: &filter[OR][0][color]=red&filter[OR][1][shape]=rounded
  • (Red AND square) OR (blue AND rounded): &filter[OR][0][color]=red&filter[OR][0][shape]=square&filter[OR][1][color]=blue&filter[OR][1][shape]=rounded

For the full filter reference, see Feed Proxy Endpoints.

Setting up in Cavai Builder

  1. Add a Slider component to the creative
  2. Open the component's Settings (three-dot menu at the bottom of the component)
  3. Paste the proxy URL into the feed URL field
  4. Map your feed's field names to the slider fields (Title, Image URL, Link URL, Price, etc.)
  5. Preview the creative to verify products display correctly

XML field mapping

For XML feeds, use these mapping patterns:

  • <title>Big Title</title> → map as title
  • <img url="image.png"> → map as img.@_url

If products aren't appearing, double-check that field names are spelled exactly as they appear in your feed.