Product Integration
Where Can I See the Products I Sent?
Platform UI
- Navigate to Dashboard → Advertisers → Products to view active products.
Data Source Logs
- If you're using the Data Source option for integration, you can find the update logs in the Data Source section.
Why Can’t I See a Specific Product?
Possible reasons include:
Missing Required Fields
- Products lacking mandatory fields (
category,price,name,currency,SKU) will fail integration.
Inactive Status
- Only products with an ACTIVE status are displayed by default.
Advertiser Mismatch
- Products linked to non-existent advertisers (
advertiser not found) are skipped during integration.
Omitted from Latest Feed
- Products absent in the latest feed are automatically marked as inactive.
How Frequently Should Product Data Be Updated in the Feed?
| Integration Method | Recommended Frequency | Reasoning |
|---|---|---|
| Airflow XML Feed | Match DAG schedule (every 15 min) | Regular synchronization prevents stale data. |
| Direct API (JSON) | Immediately upon data change | Ensures real-time accuracy for critical data (e.g., stock, pricing). |
How Is Product Sorting Determined on the Platform?
Default Sorting
- By default, products are sorted based on insertion order (id).
Explicit Sorting (via API/UI)
- Sorting can be explicitly defined using API/UI parameters:
{
"sortField": "price",
"sortOrder": "ASC"
}
Supported sort fields:
price,stock_count,created_at,name,
What Happens If Category Data Is Missing in the Feed?
CATEGORY_INTEGRATION_OFF Setting | Category Data Missing? | Result |
|---|---|---|
| Enabled (default) | Yes | Product skipped (validation error logged). |
| Disabled | Yes | Product integrated with category=null. |
Recommendation:
Consistently provide category data or request disabling of CATEGORY_INTEGRATION_OFF.
Common Error Messages Quick Reference
| Error Message | Explanation | Resolution |
|---|---|---|
| missing keys: [...] | Mandatory fields are missing | Include all required fields |
| advertiser not found | Invalid or inactive advertiser | Correct advertiser ID |
| duplicate sku | Same external_sku used multiple times | Ensure SKUs are unique |
| database constraint violation | Data violates business logic (e.g., negative price) | Validate data prior to submission |