This guide explains how to generate an XML file containing your entire product catalog, essential for syncing your products with advertising and sales platforms such as Google Merchant Center, TikTok Shop, or Facebook Catalog.
Since the feed generation occurs through a specific web address (URL), the configuration is done by adding parameters to the URL itself.
1. Building the Base URL
To generate the feed, you need to access a specific URL of your site. The base URL depends on the format and target platform.
1. Identify your domain (e.g., https://yourwebsite.com).
2. Add the feed path /api/plugin/ecommerceFeeds/.
3. Choose the type of feed to generate:
| Platform | Feed Type | Example Base URL |
|---|---|---|
| Google Merchant / Standard | standard.xml | https://yourwebsite.com/api/plugin/ecommerceFeeds/standard.xml |
| TikTok Shop | tiktok.xml | https://yourwebsite.com/api/plugin/ecommerceFeeds/tiktok.xml |
> Note: If you access this URL without additional parameters, the complete feed of all active products will be generated.
2. Advanced Feed Configuration (Filters and Variants)
You can customize the feed content by adding configuration parameters after a question mark (?) in the base URL.
2.1. Including Variants (Size, Color, Brand)
If your products have variants (e.g., sizes or colors), you must specify which attributes should be mapped to the standard Google/TikTok fields (color, size, brand).
You need to identify the numeric ID of the attribute representing Size, Color, etc., in your product management system.
| Purpose | Parameter | Example (If ID 5 is Color) |
|---|---|---|
| Color | v[c]=ATTRIBUTE_ID | ?v[c]=5 |
| Size | v[s]=ATTRIBUTE_ID | ?v[s]=12 |
| Brand | v[b]=ATTRIBUTE_ID | ?v[b]=8 |
Example URL with Variants:
If you want to include Size variants (ID 12) and Color variants (ID 5):
.../tiktok.xml?v[s]=12&v[c]=5
2.2. Filtering by Category
You can include or exclude products based on categories by using category IDs.
| Purpose | Parameter | Example |
|---|---|---|
| Include Categories | include_cats=ID1,ID2 | ?include_cats=1,2,5 |
| Exclude Categories | exclude_cats=ID1,ID2 | ?exclude_cats=10,11 |
2.3. Mapping Custom Labels
Custom labels (customlabel0 through customlabel4) are useful for organizing products in advertising campaigns. You can map these labels to:
- Categories: To insert the product's full category hierarchy.
- Attributes: To insert the value of a specific attribute (numeric ID).
- Fixed Text: To insert a fixed string.
| Label | Parameter | Example Value | Description |
|---|---|---|---|
customlabel0 | c[0] | categories | Inserts the full category path. |
customlabel1 | c[1] | 15 | Inserts the value of Attribute with ID 15. |
customlabel2 | c[2] | Summer2024 | Inserts the fixed string "Summer2024". |
3. Generating the Final Feed
To generate the feed, paste the complete URL into your browser (or provide it to the target platform).
Complete URL Example (TikTok Shop):
Generate the feed for TikTok Shop including Size variants (ID 12) and Color variants (ID 5), mapping customlabel0 to category paths:
https://yourwebsite.com/api/plugin/ecommerceFeeds/tiktok.xml?v[s]=12&v[c]=5&c[0]=categories
Once you open this URL, the system will process the data and directly return the XML file (or CSV if requested), which you can save or use for automatic synchronization.
> Important: The feed generation process may take several seconds (up to 120 seconds depending on the number of products) to prevent interruptions.
