Retail Events Guide
Learn how to integrate retail data events for product catalogue management, inventory tracking, and retail operations.
Retail Events Integration Guide
This guide explains how to integrate retail data events with the Zitcha Collect API for product catalogue management, inventory tracking, and retail operations.
Overview
Retail events enable you to keep the Zitcha platform synchronised with your product catalogue, inventory levels, retail locations, and purchase data. These events power the Search API's ability to deliver accurate, up-to-date sponsored product ads.
Product Updates
Product updates synchronise your product catalogue with Zitcha, including pricing, availability, categories, and custom attributes.
Important Notes & Common Questions
Category Path
- ⚠️ Must be caret (
^) separated arrays, not comma-separated. - ⚠️ Supports multiple categories per product.
- 💡 FAQ: Can a product belong to multiple categories? Yes, by sending multiple arrays.
Attributes
- ⚠️ Limit: ~15–20 attributes (TBC).
- ⚠️ Only required if attributes should be returned in Search API responses.
- 💡 FAQ: Do I need to send attributes? Only if extra product details are needed client-side.
Supplier ID
- ⚠️ Useful for grouping brands under one supplier (e.g., Dove + Ben & Jerry's → Unilever).
- Simplifies product set creation and reporting.
Stock Counts
Stock counts update inventory levels for products at specific retail locations.
When to Use
- Sync real-time inventory data
- Enable location-based ad targeting
- Prevent advertising out-of-stock products
Purchases
Purchases record customer transactions for inventory tracking and reporting purposes.
When to Use
- Track product sales across locations
- Reconcile inventory movements
- Generate retail performance reports
Retail Location Updates
Retail location updates manage your store location data including addresses and store information.
When to Use
- Add new store locations
- Update existing store information
- Enable location-based advertising and fulfilment
Related Resources
- Collect API Reference - Complete API specification
- Ad Events Guide - Ad tracking and attribution
- API Environments - Regional endpoints and authentication
Updated about 1 month ago