Product Catalog and Integration
How do you collect product catalog data?
Insider One provides four different ways of Data Collection:
Click-Stream (ProductFeedETL): Captures data automatically as users browse pages.
XML: Scheduled uploads (hourly to weekly) via an XML file hosted on your end. Best for stable catalogs managed via ERP/PIM.
Catalog API: A REST API for real-time synchronization. Best for large, frequently changing catalogs.
Shopify: A direct, automated sync for stores built on Shopify.
What is the update frequency of the product catalog?
Catalog API: Updates are real-time and immediate.
Shopify: Updates are near real-time.
XML: Dependent on the synchronization period you selected (ranging from 1 hour to 5 days).
Clickstream: Updates occur based on user visits. Popular products update faster than less visited ones.
How are "Out of Stock" items handled?
API/Shopify: Updates are instant.
XML: Updates occur during the next scheduled sync.
Clickstream: Uses Product Hit Check. If a product receives no views during a defined window, the system marks it as out of stock automatically.
Why did my product update fail or get rejected?
Products are rejected if they are missing required attributes (like name, item id, image url or price) or if they fail validation rules (e.g., incorrect data types). If a non-required attribute fails validation, the product is ingested, but that specific attribute is skipped.
Can I rename or change the data type of a custom product attribute?
No. Once a custom attribute is created, you cannot rename it or change its data type (e.g., from Text to Number). You must deactivate the old attribute and create a new one with the correct configuration.
What is the character limit for product attributes?
Most string fields (like name or brand) have a limit of 512 characters. However, description and category fields can hold up to 1,024 characters, and the tags array can hold up to 4,096 characters. You can visit the Product Attributes page to see the character limits.
What happens if I update an active XML file?
You do not need to pause campaigns. The system automatically sets the file to "passive" and begins validation. During this time, the catalog continues to use the last valid data. Once validated, it becomes active automatically.
Do I need a separate integration for each country/language?
Yes. You must establish a product catalog integration for each Locale (e.g., en_US, tr_TR). You can also configure Stores under locales (e.g., en_US:NewYork) to manage inventory segmentation by warehouse or region.
Recommendation Widgets & Campaigns
What does the "Test" status mean for a campaign?
When a campaign status is set to Test, it is not visible to regular visitors. It can only be viewed by generating a Test Link from the InOne panel, which allows you to preview the widget on your site before going live.
Why is my Smart Recommender widget not showing any products?
Common reasons include:
Filters are too strict: No products match the criteria (e.g., filtering for "Red" shoes in a category with no red shoes).
Stock Issues: The matching products are out of stock.
Algorithm Health: The selected algorithm in your strategy lacks sufficient data (check the "Prerequisites" on the Recommendation Algorithms page).
Integration: The Insider Tag or Product Catalog integration is incomplete.
What is the difference between Inline and Overlay widgets?
Inline: Embedded directly into the page layout. Best for seamless browsing.
Overlay: A popup layer. Best for capturing attention before a user leaves.
Why is my widget width not changing in the editor?
The widget's width is inherited automatically from the HTML container on your website where it was appended. You cannot force a width wider than the container it sits in. You can only adjust the spacing and number of cards within the available width.