Product Feed
A product feed gives Diverge the catalogue information it needs to answer product questions and recommend the right products. In most cases, the same feed you already use for Google Shopping is a good starting point.
Accepted formats
We can work with a feed that is available at a stable URL in any of these formats:
- XML (including Google Shopping feeds)
- JSON
- CSV
The URL should be accessible without an interactive login. If access must be restricted, share the authentication requirements with your Diverge contact.
Required product information
Every product should have the following fields. Field names do not need to match these names exactly, as long as their meaning is clear.
| Field | Description |
|---|---|
| Product ID | A unique, stable identifier for the product. |
| Title | The customer-facing product name. |
| Description | A useful description of the product. |
| Product URL | The canonical page where a customer can view or buy the product. |
| Image URL | A publicly accessible URL for the main product image. |
| Price | The current selling price, including its currency. |
| Availability | Whether the product is currently available to buy. |
Recommended product information
Include as much of the following information as your catalogue supports. More complete data helps the chatbot compare products and give customers useful, accurate answers.
- Brand
- Product type or category
- Additional images
- Sale price and original price
- Colour, size, material, and other product attributes
- SKU, GTIN, EAN, MPN, or other identifiers
- Tags or collections
- Stock status or quantity
- Shipping weight or dimensions
Do not include private customer information, internal credentials, or any data that should not be shown to customers.
Variants
If a product is sold in variants, include the relationship between each variant and its parent product. Each variant should have its own stable identifier and the values that distinguish it, such as size or colour.
Where price, availability, URL, or image differs by variant, provide the variant-specific value.
Languages and markets
Tell us if your catalogue covers more than one language, currency, or market. Ideally, each feed entry should make its language and target market clear. You can provide separate feeds per market or include market-specific values in one feed.
Prices must always include a currency. Product URLs should lead to the appropriate language and market storefront.
Keeping the feed up to date
Provide a stable feed URL that Diverge can fetch repeatedly. Update the file at that URL whenever product details, prices, or availability change instead of creating a new URL.
Tell your Diverge contact:
- How often the feed is updated
- How frequently it should be imported
- Whether access requires authentication or IP allowlisting
- Who to contact if the feed becomes unavailable
Before you send the feed
Use this checklist before sharing your feed:
- Every product has a unique and stable ID
- Titles and descriptions are suitable for customers
- Product and image URLs are absolute and accessible
- Prices include the correct currency
- Availability values are present and up to date
- Variants are linked to their parent products
- Language and market are identifiable
- The feed is available at a stable URL
- No private or sensitive information is included
When it is ready, send the feed URL and any access instructions to your Diverge contact.