The Datasource described on this page is an illustrative example. The actual fields, structure, and naming will vary based on your brand’s specific data model and integration. Use this as a reference for the type of data needed, not as an exact specification.
Overview
The Product Catalogue Datasource contains the brand’s full product inventory: SKUs, names, descriptions, prices, images, categories, and attributes. This is the foundation for product recommendation and enables displaying accurate, real-time product information within personalised Content.
Key Fields
| Field | Type | Description | Example values |
|---|
product_id | String | Unique product/SKU identifier | "SKU-12345" |
name | String | Product name | "Classic White Sneaker" |
description | String | Product description | "Minimalist leather sneaker with rubber sole" |
price | Currency | Current price | €129.00 |
original_price | Currency | Price before discount (if applicable) | €159.00 |
category | String | Product category | "Shoes > Sneakers" |
image_url | URL | Primary product image | "https://cdn.brand.com/products/12345.jpg" |
attributes | Object | Product attributes (size, colour, material) | {color: "white", size: ["38","39","40"]} |
in_stock | Boolean | Current availability | true |
new_arrival | Boolean | Whether recently added | true |
brand | String | Product brand (for multi-brand retailers) | "Veja" |
Connected Use Cases
| Use Case | How Product Catalogue is used |
|---|
| Enriched Product Recommendation | Product selection pool with attributes for matching |
| 1:1 Personalised Digest | Product blocks within the digest |
| Drive to Store / Web / App | Product availability by location |
| Lifecycle Banner | Product-based incentives (new arrivals for VIPs) |
Data Requirements
| Requirement | Details |
|---|
| Update frequency | Daily minimum — ideally real-time for price/stock changes |
| Minimum fields | product_id, name, price, image_url, category |
| Recommended fields | All listed above for full recommendation quality |
| Format | JSON or CSV via Datasources API |
| Volume | Full catalogue (typically 1,000–500,000 products) |
Integration Notes
The Product Catalogue is typically sourced from the brand’s PIM (Product Information Management) system or e-commerce platform. Key considerations:
- Price must reflect the current selling price (including any active promotions)
- Images should be optimised for email display (max 600px width recommended)
- Category taxonomy should be consistent for affinity calculations
- Multi-language product names and descriptions enable locale-based rendering
