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:
| Field | Format | Required | Description |
|---|---|---|---|
| Title | String | Yes | Product name |
| Link URL | HTTPS URL | Yes | Clickthrough to product page |
| Image URL | HTTPS URL | Yes | Product image |
| Price | Number + currency (e.g. 29.99€) | Yes | Current price (shown as discount price if different from Regular Price) |
| Regular Price | Number + currency | Yes | Original price |
| Custom text A | String | No | Mapped to any feed property for display |
| Custom text B | String | No | Mapped 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:
| Parameter | Required | Description |
|---|---|---|
url | Yes | Your product feed URL |
format | Yes | Feed format: xml, csv, or json |
limit | No | Max number of products to return |
root_path | No | Path to the items array if nested (e.g. items.item) |
sort_key | No | Field to sort by |
sort_order | No | asc or desc |
default[currency] | No | Default currency if not in feed (e.g. NOK, €) |
delimiter | No | Force CSV delimiter if auto-detection fails (e.g. ` |
filter[field] | No | Filter 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]=NOKAdvanced 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
- Add a Slider component to the creative
- Open the component's Settings (three-dot menu at the bottom of the component)
- Paste the proxy URL into the feed URL field
- Map your feed's field names to the slider fields (Title, Image URL, Link URL, Price, etc.)
- Preview the creative to verify products display correctly
XML field mapping
For XML feeds, use these mapping patterns:
<title>Big Title</title>→ map astitle<img url="image.png">→ map asimg.@_url
If products aren't appearing, double-check that field names are spelled exactly as they appear in your feed.