After completing data planning, proceed to the Product Catalog Integration step. You will find the available Product Catalog Integration options on this page.
Notes on Product Catalog Integration:
- Only XML integration can be completed through the Product Catalog Integration Wizard.
- If you are using Clickstream, the integration will be activated on the Catalog Settings page.
- If you are using the Catalog API, you will complete the integration yourself.
XML Integration Setup
If you are using XML integration, you can proceed with configuring the integration. In this step, you will name the XML integration and choose the XML file type.
- Each XML integration requires an identifier name.
- The XML format can be Criteo, Google Merchant, or Custom. For Criteo and Google Merchant, example XML files are provided on the page.
- You will also need to add the source URL of the XML file.
- XML integrations must be configured at the locale/store level. Select one of the created locales/stores from the data planning step.
XML Integration Settings
In this step, you will complete the XML integration settings, including the URL, locale, product tag, and sync period.
- If you don't send out-of-stock information in the XML file, enable the out-of-stock detection toggle.
- An XML file can store multiple currencies. Select all the currencies that are ingested via the XML.
- For many XML files, the standard product tag is "item." However, if the integrated XML file uses a different product tag, you must enter that tag.
- Additionally, select the sync period for the XML file.
XML File Access Authorization
If your XML files have an access authorization structure, your authentication token information is obtained in this step.
When you integrate your product catalog with Insider via XML, you might need to set up access authorization if your XML file is protected and shouldn’t be publicly accessible. In these cases, you use Header Keys and Header Values (like API keys or tokens) to let Insider’s system access your XML file securely. This ensures that only authorized systems can pull your product data and helps keep your information safe.
You can add these details easily under the Access Authorization section in your XML integration settings. Just click Add Header Values and enter the required Header Key and Header Value. If you need to add more than one header, simply click Add Header Value again for each additional key-value pair. This way, you make sure Insider’s connection works properly and your product data stays up to date without any access issues.
Product Attributes Mapping for XML
Once the XML file is accessible, you must map the values in the XML with the product attributes defined in the Data Planning step.
The functionalities on the XML Integration page will be preserved. Additionally, price-related attributes will be generated based on the selected currencies.
XML Integration Details Confirmation
The last step in the Catalog Integration is to give confirmation. You see all the selections made in the previous steps in a summary form:
- Integration Name
- XML file format
- XML URL
- Locale
- Out-of-stock detection
- Product tag
- Sync-time interval
- Header values
- Product attributes mapping
Control and confirm the configurations.
Integration Status
After confirming the Product Catalog Integration, the integrated XML will be validated and activated. To successfully complete the Catalog Integration part, integrating a validated XML file is required. Once all steps in the Data Planning and Catalog Integration parts are completed, the XML validation will be processed.
If the XML file is not validated, you can update the Data Planning and Catalog Integration steps. If the XML file is validated, it means you are ready to use Smart Recommender and Eureka products.