Setting up a Sooqr Feed

Sooqr enables businesses to optimize on-site search functionality by leveraging detailed product data. To utilize Sooqr within Channable, a properly structured data feed is required. This guide will walk you through setting up your Sooqr feed, ensuring it meets all necessary criteria for optimal search performance.

Table of contents

1. Types of Sooqr feeds
2. Setting up your Sooqr feed
3. Activate your feed and copy the URL

Types of Sooqr feeds

1. Incremental feed (Product feed):

The incremental feed is ideal for data that frequently changes, such as stock status or prices. It allows you to update only specific parts of your data instead of the entire feed. Ensure that attribute names and unique IDs in the incremental feed match those in the main feed to update the correct items. To remove an item, include only its ID in the feed, and Sooqr will delete it from the system.

2. Content feed:

A content feed is used for non-product information like contact details, FAQs, blog posts, or "About Us" pages. While similar in structure to product feeds, content feeds omit product-specific attributes like price and brand. It’s crucial to use unique IDs across both product and content feeds and to match attribute labels exactly to avoid issues with searching, filtering, and sorting.

Setting up your Sooqr feed

Follow these steps to set up your Sooqr feed:

1. Navigate to Feeds > Add new feed and search for 'Sooqr'.
   
2. Now fill in the following information:
   • Target country
   • Type of market (Product or Content)
   • Name the feed
     Then click on Continue to create the new feed.
3. Categorization: Categorization is not required for Sooqr, and can be skipped.
4. Rules: Create different Rules to optimize your product data. For example, take a look at our common rules support article
5. Finalize: Link the right attributes in the Finalize step.
   Tip! For a description of the channel attributes, hover over the gray question mark icons with your cursor.
6. Check your feed in the Quality and Preview tabs. If there are any errors for mandatory attributes, solve these first by optimizing your product data with rules and/or connecting the right attributes in the Finalize step. Repeat if needed.
   

Additional requirements for Sooqr

For Sooqr there are some additional requirements, we list them below:

• Basic attributes: Every item should have at least an ID, title, and URL.
• Unique ID: Each item must have a unique alphanumeric ID, You can link this attribute in the 'Finalize' step
• HTML content: Avoid using HTML in your data. Sooqr will attempt to clean up any HTML present, but it is best to remove it beforehand.
• Date format: Use the RFC3339 format, with all timings in UTC.
• URLs: Use absolute URLs including the protocol and domain name.
• CDATA sections: URLs and markup-containing values should be within CDATA nodes.
• Comprehensive metadata: The feed should encompass all the information you wish to make searchable and filterable, as well as the details you want to display to users.
  • Filters: What product filters are used on your site?
  • Menu structure: How is your product catalog organized?
  • Product details: What information is shown on product detail pages?
  • Business rules: What rules guide your catalog structure?
  • Ranking attributes: What attributes affect product ranking, such as stock status, review scores, or return rates?

Activate your feed and copy the URL

Once the Sooqr feed is set up, activate it in the Settings tab. Then run the feed, copy the URL from the Preview step. If you encounter errors when importing your feed, refer to the error logs in your Sooqr account for detailed information. Common issues include incorrect XML formatting, data size limits, and misconfigured indices.