SearchSpring FAQs

Recently Google has announced the ability to add a search box to their search results page when someone searches for your site directly.

http://googlewebmastercentral.blogspot.com/2014/09/improved-sitelinks-search-box.html

In this article, we'll walk you through setting this up for your site. Add the following code to the head tag of your templates for all pages. Replace the "url" parameter with the URL of your home page. For the "target" parameter, do a search on your site and take that URL and replace the search term you used to do the search with "{search_term_string}"

<script type="application/ld+json">{

"@context": "http://schema.org",

"@type": "WebSite",

"url": "https://www.mysite.com/",

"potentialAction": {

"@type": "SearchAction",

"target": "http://www.mysite.com/search.html?q={search_term_string}",

"query-input": "required name=search_term_string"

}

}</script>

The dashboard reports provide high-levelvisualizations and breakdowns of your site search performance. They can be used to infer a wide variety of shopper behavioral statistics and can be leveraged to make valuable business decisions.

Date Range

The date selector at the top right of the page is used to change the range of dates for which you'd like to view details of this report.This reporting can be viewed up to two years back from the current date.

Health Status Widgets

The Health Status widgets at the top of the dashboard show a quick view into the status of your store's three most important data connections: Indexing, Google Analytics, and IntelliSuggest.

Learn more about the Health Status Widgets here

Site Search Impact

This section of the dashboard shows you a broad overview of your site's search performance, conveniently visualized ineasy to digest metrics.

Learn more about Site Search Impact here

Daily Revenue Generated by Search

This chart shows you a day-by-day breakdown showing you how much revenue was made on your site by shoppers who used search before completing a transaction.

Search Terms Table

The Search Termstable gives you direct insight into your store's search history. Here you can view specific analytics related to each search query.

Learn more about the Search Terms Table here

If you're reading this article, it may be because you're interested in integrating SearchSpring or because the process is underway and you want to know how to prepare. As part of theproject for enabling SearchSpring on asite, the team here will create a mockup. What is a mockup though? A mockup is a "copy" of your site that will show how SearchSpring is going to function when implemented on a site. It will allow a person to perform test searches and use facets.

To create a mockup, the SearchSpring team should be provided a completed design of either asearch or category results page. With the latest version of the SearchSpring catalog, we create various templates using the page's HTML markup thereby inheriting your site's CSS (or stylesheets).

But what exactly do we mean by a "completed design"? There are a few things (noted below) that we'll be looking for.

Development or Live Site?

If thedesign has not been published live yet, SearchSpring can create a mockup using a design from a development site. While SearchSpring is creating a mockup, there cannotnot be any drastic changes to the development site. To further explain, the SearchSpring Developer will pull down and copy current assets (CSS, JavaScript, HTML, etc.) from theresults page for the mockup. If at any point thesite styles are changed or the HTML markup isaltered, the mockup becomes outdated. This creates delay in receiving a mockup as the SearchSpring team hasto change assets on their end and verify everything is working correctly. And as one might imagine, postponingthe mockup deliveryalso holds backsubsequent stages in the site's project (such as the Revision and Integration stage).

If updates are made in CSS and the URL for that filedoes not change, this won'tbe a problem as we'll inherit the site's styles. The only time a CSS change does make a difference is when there is a caching system in place on the site's assets.

Example

A SearchSpring developer creates a mockup and at the time the site's CSS file was the following:

http://mysite.com/css/site.css?1234

The "?1234" specifies a version number. While the mockup is being worked on, there is a change to the site design that makes a button in the item results blue instead of green. The CSS file now has a new version number like so:

http://mysite.com/css/site.css?5678

The SearchSpring developer does not know this change was made and the delivered mockupwill potentially be inaccurate.

Results

The results portion of a site will usually include products, pagination, sort by, or item per page selections. For a mockup, this section on the page to match should be complete. Questions you might review are:

Is there pricing logic with theMRSP and retail price?

Are there badges/flags on the items to tell a customer is something is "New", "Out of Stock", "On Sale", etc.?

Is there an "Add to Cart" button and does it bring the customer to the product page or does it add an item to a cart?

Is there other native platform functionality like "Quick View" or "Add to Wishlist"?

It is unlikely that the SearchSpring team will not be able toreplicate the design of your results, but in order to ensure the mockup process goes as smoothly as possible, it is necessary for the results to be finalized.Providing examples for logic you would like to see carried over is helpful as well.

Example

A product in the data has a "New" badge assigned to it for testing purposes. Giving us the appropriate product id or link means we do not have to hunt for the correct product to verify logic. This is especially useful if a site has a large amount of products.

Facets

The facet (or sidebar) design can be flexible in comparison to other points discussed in this article. Often we realize that people aren't quite sure what they would like as adding filtering can be a new experience. To begin the facetportion of the mockup, the SearchSpring teamrequires(at minimum)simple HTML markup and a few styles (such as font colors and type) for the facet titles and options.

Example

<div class="facet-container">

<h4>Facet Title</h4>

<ul>

<li><a href="//mysite.com/option-one">Option One</a></li>

<li><a href="//mysite.com/option-two">Option Two</a></li>

<li><a href="//mysite.com/option-three">Option Three</a></li>

</ul>

</div>

Thankfully, SearchSpring has some "stock designs" to improve the look and feel of the facets. These additions (at the time of mockup creation) are at no extra charge and if youlike any of these features, please let your Customer Success Manager or Sales Representative know.

Add-ons:

Checkboxes in a choice of three styles: style 1, style 2, and style 3.

A selected option Filter Summary in two styles: style 1 and style 2.

For mobile and responsive design, we havea flyout filter menu. This will enable customers to use facet options when searching on mobile devices.

A range slider (commonly used with prices). For a slider, data in the feed must be formatted in either decimal or whole number values.

Color palettes using web-safe color values from the feed. Custom colors ("rainbow", "multi-color", etc.) can be used in a palette, but SearchSpring will need either a hex color code or image to map to.

Typically used with "Sizes", we can add grid selections. It is recommended that text values for option be smaller in size - no bigger than fourletters long. For example:SM, LRG, X-LRG, MD.

A toggle button which will hide or show facets beneath the title. There are two styles currently: with a plus/minus icon or with an up/down arrow.

Please note that most of the screenshots above are very basic. If any of these add-ons are requested, we will attempt to match your site's design. Because we have the ability to add extra styles for the sidebar, at the very least, the overall site design hastocontain a basis of colors and fonts that you would like us to use. Heavy customizations or change requests to these stock designs may require Professional Service fees.

Functionality

In regards to functionality, having JavaScript and/or jQuery code as accessible, named functions is always preferable. With the SearchSpring catalog, when we create templates of items and facets, we have to "re-run" functions after the catalog has fully loaded and content is displayed. If functions are named, we can easily execute the code again. Take the below code examples:

if ( jQuery('.an-element').length > 0 ) {

// Execute over 100 lines of code here

}

versus

function myFunction() {

if ( jQuery('.an-element').length > 0 ) {

// Execute over 100 lines of code here

}

}

myFunction();

In the second example, SearchSpring can add one line of codeto run myFunction, whereas in the first example, we can either copy over 100 lines of code or request the clientto name the function.

There are cases of functionality that while we can duplicate, it requires a bit more complexity.

Example

mysite.com has an "Add to Wishlist" button on all items in the results. A customer can click this button and add an item to a wishlist which is visible in the user's control panel. If a product has been added, the button changes color and items can be removed from the wishlistby clicking on the button again. To wrap everything together, SearchSpring will need to know:

Is the user logged in or not?

What items has the user already added to their wishlist?

This information can be relayed to SearchSpring over global variables on the search page. It is added through the cart's templates.

AutoComplete

As SearchSpring has a standard AutoComplete template updated to match your site's design, we do not need anythingto match. Though if there is something special you'd like to see in the AutoComplete modal, you are welcome to address thisto yourCustomer Success Manager or Sales Representative.

The ability to sort search results helps customers find the products that they're seeking. Some popular sorting methods include relevancy, name and price. As an example, your customers may be searching for a particular product name and allowing them to arrange items alphabetically (either ascending or descending in direction) gives them the control they need to find products faster. You can only have up to 15 custom sorting options.

Sorting options can be alteredon the Sorting page in the SearchSpring Management Console.

Suggestions

If you are not sure what fields to add as sorting options, SearchSpring provides suggestions based on Core Field settings. These recommendations have lighter gray colored text and in the Sorting Label column, are appended by the words "We suggest:". These can easily be added by clicking the "Add" link on the right side of the page.

Sometimes we offer suggestions for fields that are not yet mapped in the Core Fieldsettings. In this case, you can hover over the question-mark icon to read more about how to set up the suggestedCore Field.

Adding New Sort Options

In addition to suggestions, you may also add your own custom options. At the bottom of the Sorting page, click the link that says "Add a sort option".

A window will pop up with a few different options.

Sort field label - This is the label that displays when a user selects a sort option. For example: Name (A - Z).

Field name - The values here are populated by your data feed. When viewing this list, if you have set a "Label" on the Field Settings page, that name will show instead of the actual field name in the data feed. For example: If the field "reviewcount" was given a label "Review Count" in Field Settings, look for "Review Count" in the sort drop down instead.

Sort direction - This selects which way you want items to be sorted, either ascending or descending.

Ascending - If the values are text, items will be sorted by alphabetically, A to Z. If the values are numeric, items will be sorted lowest to highest.

Descending - If the values are text, items will be sorted by alphabetically, Z to A. If the values are numeric, items will be sorted highest to lowest.

Edit Options

Once an option has been added, you can make changes to it by clicking on the orange pencil icon to the right. A new window will pop up with the different fields you can edit.

For more information on the fields here, look under the title "Adding New Sort Options" on this same article.

When updating a sort option, you cannot change the "Field name". If you would like to change the selected field, you must delete the option and add a new one. Removing an option can be done by clicking the "Delete" link at the bottom of the "Edit Sort Option" window.

Rearranging Options

The order in which options are displayed to a user can be updated. On the left of any added option, there is an icon that looks like three vertically aligned dots. With your mouse, click and hold on this icon then drag the row higher or lower in the list. Release your mouse click and the option will snap into its new position. This change is automatically saved.

Relevancy

After a user performs a search, SearchSpring adds a default option to sorting called "Relevancy".The "Relevancy" option cannot be removed or rearranged on the Sorting page. The label can, however, be changed by clicking the pencil icon.

The editing window is similar to other edit windows, except that the only thing you can edit for this option is the label itself.

Synonyms make it possible to refine your customer's search by replacing commonly used keywords with terms that are similar in meaning. By doing this, shoppers are shown results for more relevant products. Using Synonyms effectively creates a better shopping experience for your customers by allowing them to focus less on the search terms they use and more on the products they are interested in.

There are two types of synonyms: Grouped and One way Synonyms

Synonyms always need to be re-indexed after making changes

Grouped Synonyms

Grouped synonyms treat all words in the group as equivalent so that when you search for any of the words in the group it will also find any of the other words in the group.

A clothing store is having a sale on "t-shirts", but they use a lot of different words in their product names besides "t-shirt", like "Yellow T Shirt", "Red Tee Shirt", and "Blue Short Sleeve". In order to make the most out of their featured sale, the store sets up synonym logic for the word "t-shirt" and lets SearchSpring know that the words "t shirt", "tee", "short sleeve", "v-neck", "v neck", and "crew cut" should have equal weight when searching.

One-Way Synonyms

One-Way synonyms find alternative words for a search query but the alternative terms are not synonyms of each other.

A search for winter clothes will also find jackets, scarves, gloves, and sweaters.However, you wouldnt want jackets showing up when someone does a search for gloves so a grouped synonym would not work for this situation.One way synonyms are good for more generic words and finding products matching the more specific terms.

Multi-Word Synonyms

Synonyms are intended to offer control over very specific phrasing. Setting up synonyms using multiple words (eg: "warm jacket" and "fleece pullover") have some important caveats:

The user's search has to include both words togetherExample:Searching for "warm winter jacket" would not cause the synonym to take affect, while searching for "winter warm jacket" would.

The product's data needs to include the words together to matchExample: A product with a searchable property value of "fleece zip pullover" would not be shown when searching for "warm jacket". Instead, the product would need to have a property value something like "zip fleece pullover".

Stemming & Synonyms

Normally, SearchSpring will automatically search for plural variations of words a shopper looks for -- called Stemming. Due to the specific scope of Synonyms behavior, stemming works slightly differently when a synonym is applied.

Synonym words only match on their own without doing any stemming. Example:Searching for "shoe" when a synonym is set up for "boot" will look for products with:

Original search word ("shoe")

Stemmed search word ("shoes")

Synonym ("boot")

Notstemmed synonym ("boots")

Add a Synonym

New synonyms may be added by clicking on the Add Synonym button.

A window will pop up. In the "Synonyms" field, multiple words may be listed and separated with a comma. After entering the words, click the "Save changes" button in the bottom right corner.

To instead add a One-Way Synonym, click "One-Way Synonym" in the toggle at the top of the popup. Enter your starting search term for a One way Synonym (Searching For:)and a list of "Synonyms" (words that should be considered the same).

Enable

In order for a synonym to be processed, the Enable checkbox must be checked. This change automatically saves. If you want to disable a synonym, but not delete it, the change is as simple as unchecking this box. Any updates to this checkbox will take effect the next time SearchSpring updates your search index.

Edit

You can Edit any synonyms you have added by clicking on the pencil icon.

Delete

Synonyms may be removed from this list by clicking the Delete icon.

Grouped Synonyms Table

The column labeled "Searching for any keyword in the group returns the same results for all keywords" shows all terms/phrases that are linked together by a single synonym separated by commas.

One-Way Synonyms Table

"Searching for..."

This is the term/phrase that will cause the trigger to take affect when searched by a customer.

"Also finds these words:"

These are the terms/phrases linked to the "Searching for" word. When the "searching for" terms/phrases are searched, SearchSpring will also look for results with these words in products' data.

Tips & Tricks

When adding synonyms, try to make them short and simple. If you notice people are constantly spelling a word wrong in a phrase, don't create a synonym for that entire phrase. Create a synonym for the word that is misspelled.

Listing multiple synonyms separated with a comma is key and will save you a lot of time if you need to edit anything later.

Avoid adding a synonym that has a term in your keyword. For example: If you created an entry for "Batman" to replace "Batman Shirt", the replacement will process, then see "Batman" and try to replace it another time. SearchSpring handles this as well as it can, but it can be messy and confusing.

Synonyms will not affect matches on code fields (such as matching on a product's SKU)

The SearchSpring Suggest API is powerful and flexible endpoint, designed to generate helpful query suggestions based on a shopper's input text. This endpoint powers the mainline AutoComplete feature for all Angular v3 implementations and beyond.

See Also: Response Format

This API does not include product results based on an input query. Please see the Suggest API: Legacy Request for that behavior.

This API includes all query suggestion logic that used to be done on the front-end, so now you can get advanced query suggestions even with custom installations that don't use SearchSpring's v3 module.

Spell-check is baked in, and enabled by default

Doesn't include any front-end formatting (such as HTML <em> tags) in its response, so it can be used more freely.

API Endpoint URL

https://suggest.searchspring.net/api/suggest/query

Request Parameters

Uses POST. Parameters cannot be passed in the URL. JSON objects are accepted.

siteId(Required)

Format

String

Description

The siteId parameter identifies your site. You can find your siteId on the My Account page.

Example Value

"scmq7n"

query (Required)

Format

String

Description

The user's input query, which is used to generate search suggestions.

Example Value

"dres"

language

Format

String

Description

Determines the language model that we will use in spelling correction.

Default Value

"en"

suggestionCount

Format

Integer

Description

The number of suggestions to be returned to show the end user.

Default Value

4

productCount

Format

Integer

Description

The number of products on a site to scan (Name and SKU core fields) in order to find matches against the query.

Default Value

20

Example Request

cURL

curl -X POST https://suggest.searchspring.net/api/suggest/query -H 'Content-Type: application/json' -d '{"siteId": "scmq7n", "query": "dres"}'

The following parameters are hidden from public view for now.

termCount

Format

Integer

Description

The number of popular search queries on the site to scan in order to find matches against the query. Popular search queries are always sorted by most popular first, regardless of this number.

Default Value

20

disableSpellCorrect

Format

Boolean

Description

Disables spelling correction from potentially changing the input query.

Default Value

false

enableMerchandising

Format

Boolean

Description

Allows merchandising to affect the order that products are scanned (See "Product Count" above). If the query matches a merchandising campaign trigger, the product order will be affected with that campaign's rules. The global merchandising campaign will also apply.

Default Value

false

enableElevations

Format

Boolean

Description

Allows IntelliSuggest elevations toaffect the order that products are scanned (See "Product Count" above). If the query is normally affected by IntelliSuggest elevations, the product order will be affected accordingly.

Default Value

false

This parameter shouldnever be public facing, and is only used for internal debugging purposes.

debug

Format

Boolean

Description

If enabled, will return a "debug" array that returns more information explaining logic and context. This includes the list of popular queries and products being scanned for generated suggestions & exact matches.

Default

false

Insights & Reporting suite An introduction to SearchSpring's many capabilities, tools, and processes. Start here if you are new to SearchSpring.

What is SearchSpring?

SearchSpring provides intelligent search results and powerful merchandising capabilities for ecommerce sites. If you have an ecommerce site, you'll want to provide your customers with the best shopping experience by delivering fast and relevant search results, and as a merchandiser you'll want to tailor the products presented to shoppers based on your business goals.

Why is search so important?

Simply put- If shoppers can't find it, they can't buy it. That's where SearchSpringcomes in: We analyze all of your products to better understand and categorize them so we can provide the most accurate results to your shoppers every time they search.

This is what we refer to as relevancy. Better relevancy means increased conversion and revenue for your site.

Making your search results relevant

Searchspring looks at every product you have and analyzes it to understand your products on a deeper level, which we call Product Awareness. Product Awareness leverages product data, attributes, and optionally reviews to understand the human meanings and groupings of your products, allowing us to respond intelligently to your shoppers' searches.

How SearchSpring works with your eCommerce Platform

In order to provide a great search experience, SearchSpring grabs a copy of your product data and stores it on our servers for deep analysis. We call this process Indexing. From there, we can return high speed dynamic results from our servers directly to your site.

This means that SearchSpring must continuously update our servers with your most recent product information in order to ensure that the products were showing are in-sync and up to date with your latest changes. The way SearchSpring imports your data depends on your eCommerce platform, but in most cases SearchSpring will automatically update our copy of your product data on at least a daily basis.

To display SearchSprings enhanced search results and category pages on your website, SearchSpring is typically installed on your store by taking over the pieces of your site that show product listings, using the asynchronous javascript technology called AJAX. This enables the easiest installation, while also providing good performance for your shoppers.

If you make a change to a product in your ecommerce system, that changewon'tbe reflected on SearchSpring-powered pages until SearchSprings product data for your store is updated. If you need a product change to take effect sooner rather than later, you can manually update your SearchSpring data through the Index Status page in our Management Console.

White Glove Integration

When getting SearchSpring on your site, you're getting more than our relevancy engine. Our integration pros have gone above and beyond to create the most powerful and beneficial workflow for installing SearchSpring. From branding consistency to ongoing support benefits, click here to read all about the SearchSpring Integration Difference.

Merchandising

In addition to providing fast and relevant search results, SearchSpring also providesa robust suite of merchandising features. With our merchandising tools such as Basic Campaigns or our more powerful Visual Merchandising suite, you can promote specific products in the order you'd like them to appear and create custom campaigns to showcase your best products to your customers. You can target products based on newness, gross margin, brand, and category to rank products, or use engagement metrics such as sales volume, page views, conversion rates, or revenue per visitor to influence ranking.

SearchSpring givesyou the control to rearrange, add, and remove products from the results that your shoppers see. Optimizing the KPIs used to display products makes it easier to increase your profit per visitor by elevating best selling products or house brands above other products. You can also add advertising content like banners, videos or images to any page powered by SearchSpring.

IntelliSuggest

SearchSpring tracksyour shoppers'behavior and leverages this data to continually optimizeyour product rankings. Our IntelliSuggesttracking monitorsproduct clicks, add to cart, andpurchase behavior to determine which items are most engaging.

With IntelliSuggest, we're able to see which products are most likely to be purchased in a given scenario. When someone searches for a product, IntelliSuggest knows which product has resulted in the highest conversion rate when people have completed that exact same search in the past. This allows for relevancy and popularity to work in tandem to deliver the best possible results to your shoppers.

Insights

SearchSpring also generates a number of reports through our that provide visibility into specific metrics and performance around your site. Our reportingwill help you understand your customer behavior and buying patterns while simultaneously providing the avenue to take action through our other features.

Discover different tools you can leverage in the SMC including Merchandising, Indexing, Insights, and Display settings.

The SearchSpring Management Console (or "SMC") is where you can take advantage of all of SearchSpring's powerful features on your site. From here, you can configure your site's search results behavior, configure dynamic merchandising campaigns, dive intopowerfulanalytics, and more.

Dashboard

The dashboard is what you see when you first log into the SearchSpring Management Console - here you can get a high-level overview of your site's connectivity status, and reports that provide visualizations &breakdowns of your site's search performance.

The three status boxes at the top of the page help you catch a glimpse of where your site's connections and tracking stand. Clicking any one of them will take you to a pagewith more detailed information with action steps. The analytics below these boxes offer an easily readable overview of your site's Google Analytics tracking.

To learn more, visit the Dashboard Reports article.

While each of these indicators is important, you will want to ensure your Google Analytics is connected and tracking correctly. Nearly the entire dashboard leverages your Google Analytics data to help paint a picture of the current state of your store. Information around metrics like Revenue, Average Order Value, Conversion rate, and even your top 100 search terms all live within the dashboard, powered by Google Analytics.

Index Status Page

The Index Status Page shows the synchronization status of your store's product data and SearchSpring. We typically update your index every 24 hours automatically. However, if you want to update sooner you can do sohere. If there was an error with your index, it will be highlightedon this page.

This page's sole focus is the existing status of yourproduct data sync with SearchSpring. Indexing is the process where SearchSpring looks at the data you are passing us from your ecommerce platform (or a file) and updates it based on the most recent data. For instance, if you change the price of a product, add or remove products, or want to add a new Field/Attribute to you store, you would need to index with SearchSpring aftermaking the change in your cart so that we have your most recent product information.

If you should ever need to immediately index, you can use this page to manually re-index your site.This is especially useful when you absolutely need your product changes to be updated as soon as possible. Depending on the site, which cart you're using, and how many products you have, indexing can take anywhere from a few minutes to several hours.

Fine Tuning Your Relevancy

You can influence your site's relevancy by configuring redirects and synonyms.

Redirects are a way for you to send your shoppers to a specific page on your website rather than showing the normal assortment of search results. This is particularly helpful when a customer searches for something like "contact info" or "return policy". You wouldn't want to try to show results for these searches - instead, you can send them directly to the "Contact Us" page.

You can also use redirects to send shoppers to a specific category page. For example, if you see that many people are searching for "shirts" you can set up a redirect to send shoppers to your shirts category page instead of the search results page.

Synonyms refine your shoppers' search by replacing commonly used keywords with terms that are similar in meaning. Indoing this, shoppers are shown results for more relevant products. Using Synonyms effectively creates a better shopping experience for your customers by allowing them to focus less on the search terms they use and more on the products they are interested in.

Merchandising

If you want to create a promotion, feature specific products, or add banner content to any SearchSpring powered page, you can do sothrough our Merchandising tools. Merchandising allows you to promote specific products based on particular queries,or create rules that dynamically target products based on their attributes. As your product data updates, so too will the product listings affected by these merchandising rules.

Product Boosting Rules are great is you want to affect a broad number of products with a few simple steps. However, you can also promote products individually to give you precise control of how your products appear on a search or category page. Inside Visual Merchandising, you can arrange specific products by drag and dropping them to your desired location.

You can also injectrich advertising content into any SearchSpringpowered page. You can insert banners, video content, or any custom HTML. Aside from customizing any search or category page, you can create a completely unique page of products called Landing Pages, which have their own URLso that you can link to it from any source on your website, email campaigns, social media, or otherwise.

Leveraging merchandising features is the easiest way for you to act upon the reporting data you see within SearchSpring.

Reporting and Insights

SearchSpring's Insights and Reporting features help you understand areas of success and opportunities for optimizing your site, andgives you valuable information about how your shoppers are looking for your products.

Basic Reports are powered solely by SearchSpring. These unique reports provide you visibility into your shoppers' interactions with your store. The Zero Results Searches Report, one of many reports in the SMC, shows searches that yielded no results on yoursite. Reports like this can be leveraged to help improve Relevancy and, ultimately, your store's performance.

Our Search and Category Insights Reports are a unique blend of SearchSpring data and your Google Analytics data to provide a one-of-a-kind view of your store. By combining the two data sets, we provide a holistic view of your site's performance on a per query or, per category basis. Use these Insights Reports to dig deeper on specific SearchSpring powered pages.

Product Insights brings to light both high level and granular views of how your products are performing. With this powerful tool, youll gain visibility into product performance, how shoppers interact with your products, and suggested action steps to further optimize performance.

Revenue Insights is an entirely unique way of breaking down the way that your revenue relates to how users interact with SearchSpring on your store. This reportprovides the distinct value of showing you how much each SearchSpring feature contributes to purchases made by customers.

Indexing is the process of sharing information between the product data that lives in your eCommerce platform and SearchSpring. This is how SearchSpring gets the product data needed to render results on your website.

You can view your indexing statusonthe Index Status page. A checkmark means that the indexing is complete.

Learn about How Indexing is Scheduled

When should I index?

When new products or SKUs are added to the site

When inventory or pricing is updated and changes need to be published immediately.

When adding/removing/changing synonyms

When creating a new field in Field Settings or when toggling an existing field (using a new field for search, sort, or faceting)

When product and product attribute data is updated within your platform i.e. changes in price or stock status, add/remove products, etc.

When adding/modifying Exact Match Synonyms

When adding/modifying Ignore Terms Synonyms

You do not need to reindex for the following:

When Adding/removing/changing query replacements

When setting up a redirect

When leveraging Visual Merchandising or Campaigns

How do I sync my product data?

Normally, your product data will be automatically synced at regular intervals. However, there may be times you need to re-index your data feed before your site's next update interval.Usually, this need arises because product details have changed or new products have been added that you would like shown as soon as possible.To trigger a manual re-indexing, follow the steps below.

Step 1: Go to the Index Status page in the SearchSpring Management Console

Step 2: Click on Update Index to begin the indexing process. The status of the indexing is represented in the box underneath Current Indexing Status.

Indexing is broken down into two components, feed regeneration and the indexing of the feed. The time it takes this process to completedepends on your setup and platform;it can range anywhere from a few minutes to many hours.Thefeed regeneration is when SearchSpring uses a connector or API to generate a data feed.There is no regeneration process if your data is provided to us using a CSV or XML feed.

How do I change my automatic syncing schedule?

On the right-hand side of the Index Status page, shows the date and time for indexing processes. Last Indexed displays when your feed was last indexed while Next Update displays when your feed will be indexed again. To change how often your feed will be automatically indexed, follow the steps below.

To learn more about how and when we schedule your next indexing time, click here.

Step 1:Click the Edit button on the right side of the page

Step 2:Scroll down to Automatic Updates and change Time Of Day to whatever works best for you. We recommend you set the automatic indexing time to off hours so that the indexing does not interfere with your business operations.

Note: Only admin users can set the indexing interval to less than a day.

How do I set up alerts for indexing?

You can set up automatic alerts for successful or failed index attempts. You can do this by going to the My Account page. From there, you can toggle on the option for Indexing Success and Indexing Failure. under notifications.

Why did my indexing fail?

Indexing can sometimes fail if the server doesnt respond or if there is a glitch in the response. Try running your index again and see if the problems persist. Reach out to [email protected] if the index continues to fail.

Recent Feed/Index Sizes

In addition to being able to update your index, the Index Status page page also displaysa chart of your recent data feed/index sizes.

The Recent Feed/Index Sizes chart showsup to ten of your last indexes. The dark blue bar ("Data Feed Size")showsthe number of products before indexing whilethe light blue bar ("Final Index Size") shows the number of products after indexing. At the bottom of the chart, you will see the dates and times when the indexing processes occurred.

SearchSpring provides powerful behavioral tracking on customers called IntelliSuggest that automatically elevates high-engagement products, enables advanced store functionality, and unlocks in-depth & actionable insights data for your store. While having IntelliSuggest is not required to make your stores search work, its benefits are great enough to make an enormous difference in your stores performance -- and its entirely free!

What Does it Do?

Everything begins with our IntelliSuggest Tracking getting installed on your site. Once in place, we begin to record highly valuable customer behavior data on your store: Every click that comes from a product listing page, every time a customer views a product, views their cart, and makes a purchase. This allows us to analyze your stores customer behavior data into our automated algorithms, insights features, and more.

contact your customer success representative

What are the Benefits?

Automated Product Elevations

Out of the box, the core benefit youll gain is our automatic IntelliSuggest Elevations. As its namesake suggests, we intelligently push 10 products to the top of the results for your 5,000 most popular search terms, based on the product engagement for each individual search context.

Context is important. IntelliSuggest Elevations are specific to each search query, so product elevations will be based only on how your customers interacted with products on that exact search. Ultimately, this results in products being elevated that are the most relevant for a specific search, as proven by your customers actions.

For example, imagine that customers searching for trendy shirt are highly engaged with a shirt that has an interesting design, so we automatically push that product to the top of the page whenever people search for trendy shirt.

Meanwhile, customers searching for comfortable shirt are most engaged with a plain cotton shirt, so we push that product to the top of the page whenever people search for comfortable shirt. This helps further reinforce the most relevant products on each search result page.

IntelliSuggest Elevations use customer engagement data from the past 90 days, and updates on a daily basis. At its core, tracking Clicks is all thats required for this to work. However, adding Product Views, Cart views, and Sales will greatly enhance the performance of these automated elevations.

Scoring logic internal document here

Unlockable Benefits

There are also some major IntelliSuggest-powered features that you can add on to your account, such as our popular Product Recommendations and Product Insights capabilities. If you already have IntelliSuggest tracking installed and are interested in adding either of these features, please contact your customer success representative.

Product Recommendations

Having IntelliSuggest tracking installed on your store also enables one of our more popular capabilities: Product Recommendations.

Using engagement data from Product Views, you can leverage automatic up-selling on your store with our Also-Viewed recommendations widget, which shows your customers items that are similar to the onethey'recurrently viewing based on which products other customers viewed in conjunction with this product.

You can also use IntelliSuggest Sales data to create a valuable cross-selling opportunity on your Cart pages with our Also-Bought recommendations widget, showing your customers complimentary products that others generally have purchased alongside the products they have in their cart.

Product Insights

One of our most popular insights features, Product Insights is powered almost entirely on IntelliSuggest tracking data. It brings to light both high level and granular views of how your products are performing. With this powerful tool, youll gain visibility into product performance, how shoppers interact with your products, and suggested action steps to further optimize performance.

Learn more about Product Insights here.

How Do I Get it?

IntelliSuggest Tracking must be installed in your stores templates (HTML, PHP, and/or JavaScript). Please click here to learn more about how to install IntelliSuggest tracking on your store.

Ifyou'vealready installed IntelliSuggest Tracking and are interested in adding Product Recommendations or Product Insights to your store, please .

reach out to your Customer Success representative

SearchSpring's Autocomplete is the helpful list of suggestions that appears instantly while typing in the search box.With unparalleled speed, it surfaces the most relevant search term predictions to your shoppers.Suggestions are dynamically refined as customers type additional words and phrases, delivering the fast and relevant results that your customers expect. Spelling correction is also baked into our latest releases.

Note:This article is specific to the latest releases and implementations of AutoComplete. If any of the behavior described doesn't seem to apply to your store's AutoComplete, you are most likely on an older version. If you're interested in any features that you don't currently have, feel free to reach out to your customer success representative to learn more about your options.

AutoComplete adds many benefits for your store. It increases conversions by creating a seamless flow to guide your shoppers, reduces friction and clicks, increases shopper engagement, and pulls in existing merchandising rules and content to give you more control over its behavior.

Out of the box, AutoComplete is also fully mobile responsive, can be customized to add things like "Add to Cart" buttons directly within the popup, and provides instant faceting options.

How It Works

We have put a lot of love into how AutoComplete can create the best experience for your shoppers. From a high-level view, it can all be broken down into these steps:

In the blink of an eye, we perform several intelligent calculations every single time a shopper enters a new character into their search: We check for terms in your product data, we run a spell correction if needed, and then we check against our massive list of popular search terms and your product data to create the most relevant search suggestions possible.

All of this happens in the instant before we even show the AutoComplete pop up. In most cases, we'll also do a micro search for the top suggested search to show a preview of its results. Then, once hitting Enter, AutoComplete takes you to a normal search results page.

Okay, give me the details

Here's a more in-depth view of how the whole process works:

Shopper Search Query

The entire process begins when the shopper types something into the search box.

Term Check

The first thing AutoComplete does is checking against your searchable product data to see if there's any basic results found for it. If there areno results found, then we'll send it off to check for spelling.

We only check for spelling in this case to avoid accidental overcorrections, especially things like trendy intentionally misspelled brand names.

For speed and performance reasons, term check does not include things like Merchandising, Synonyms, and partial matches on data.

Query Correction

This is where the magic of Spelling Correction happens!

Find Popular & Product Suggestions

The core logic of AutoComplete comes into play here.

We first check the shopper's search against the top 10,000 searchesover the past 90 days from your site. To supplement even more suggestions, we'll also compare the shopper's search against your currentproduct data (Names and SKUs) and put those next in the final list of suggestions.

For more information on this stage, see AutoComplete Matching Logic.

If AutoComplete finds anexact match of what the user typed as a current product's Name or SKU, that suggestion willalways be bumped to the top of the AutoComplete suggestions.

SearchSpring Integration

These search suggestions are handed off to SearchSpring's advanced v3 Integration Catalog, which takes care of the logic and on-site display behavior from here on out. If AutoComplete is not installed using this catalog (such as a self-installed, API-only integration), then the behavior and appearance in the following steps will not apply.

Deep Search

If no search suggestions were found in previous steps, AutoComplete will attempt one final effort to show something for the user. It looks to see if there are any product results for what is currently typed in by the shopper, and will display a preview of results for that search if there are any.

Displaying to the User

The pop-up modal that the user sees will usually look something like this:

Desktop:

Mobile:

The suggestions themselves are listed on the left side. The first suggestion is automatically selected,and displays a preview of the the product results for that query.

In the example above, the shopper typed "dres". The top suggestion is "dresses", for which product results are previewed to the right - including faceting options.

TODO - Link to this article when it's done: AutoComplete Front-End Variations

When hitting "Enter"

When hitting Enter, you are taken to a normal product result page. What is being searched for on this page can change depending on several factors.

If a spelling correction was made, then the resulting page will be search results for thecorrected search, and we will show a prompt on the page that allows the shopper to "Search instead for" their originally typed search.This is all standard behavior on major search engines such as Google.

If there wasn't a spelling correction, the results page will simply be searching for the shopper originally typed. If a user types "ford tru", it's not spell corrected, and hits Enter - the results will be for "ford tru".

Want something different?

Different store owners expect different behaviors when hitting Enter in these situations. If you'd like, you can to request a change to your site's behavior to change any of the following:

Disable spelling correction entirely

When a shopper hits Enter, you'd like it to alwaysshow a results page for what the top suggestion was.

This includes the "Search instead for" prompt to allow your shoppers to back out to their originally typed query.

This can be set even if you've disabled spelling correction.

When a shopper hits Enter, you'd like it to only show a results page for exactly what the user typed, even if there was a spelling correction.

Frequently Asked Questions (FAQ)

What about terms that are set up as redirects?

If there is a redirect in place for a search term, Autocomplete discards the term.

What about terms that are set up as synonyms?

Synonyms created in SearchSpring will be reflected in Autocomplete suggestions.

Is it possible to apply background filters to the autocomplete results?

Yes. Background filters can be added to the Autocomplete results, though you may need to ask us for the specific code needed depending on your e-commerce platform.

Can IntelliSuggest be removed from Autocomplete?

Yes, though you will need to reach out to SearchSpring support for additional assistance.

Why does Autocomplete not close when I select a filter?

Autocomplete allows for filtering down the results within the Autocomplete window so that the results can be narrowed, therefore it remains open until a user clicks on a product or outside the Autocomplete window. Behind the Autocomplete window, the search results page automatically updates according to the selected filters.

How do I update from V2 to V3 Autocomplete?

An upgrade to V3 Autocomplete requires a mockup and an update to your contract with SearchSpring. Please reach out to your Customer Success team to discuss this upgrade to your account.

When to contact SearchSpring support:

Product links go to the wrong product pages

Prices aren't accurate

Image urls aren't populating

Why does Autocomplete flash and then go away?

If your site integration is new, Autocomplete has not had time to learn user interaction. As a result, it is defaulting to Google Analytics data, which contains search terms users have entered. These terms may or may not be products in your store. When Autocomplete determines there is not a match in the database for the search term, it automatically closes, giving this flash. This resolves itself with time and user interaction.

Why are the Autocomplete suggestions and the search results sometimes different?

The Autocomplete API will only search for the core Name and SKU fields, while the regular Search API will search every field that is marked as "searchable" in the SearchSpring dashboard, thus returning a larger and more varied selection of products.

Note: Spelling correction is being rolled out to eligible accounts at no cost.

Instant, intelligent, and always-learning spelling correction is offered as a piece of AutoComplete. This helps aid shoppers in real-time to close gaps in their journey, thereby reducing frustrated exits from your site and further guiding them towards conversion.

See also: Spelling Correction Insights

What does it do?

The moment a shopper begins typing, we automatically run their text through our spelling correction algorithm. Then, thecorrected search is passed directly to AutoComplete to function as usual.

If a shopper types "dresz" - We immediately correct it to "dress". AutoComplete responds exactly the same as if the shopper had typed "dress" in the first place.

Spelling Correction takes place in Step 1 in the graphic of AutoComplete's flow below:

How does it work?

Spelling correction doesn't simply look at one word at a time and compare it to a dictionary. Rather, it analyzes years of search behavior data from actual online stores to identify the shopper's most likely intent while searching. It looks at common spelling patterns and word correlations to identify the best possible result.

This means that while we are looking at the shopper-typed word, more commonly searched words will be weighted heavier as the "correct" version against it. If most people have searched for "black dress" and the current shopper types "blck dress", we can easily compare the two and have confidence in saying this query should probably be "black dress".

The algorithm for spelling correction is intelligent in that it uses not only the past 10 years of SearchSpring data to power its spelling language modeling, but it also frequently updates itself to keep up with the latest trends in how people search.

Having trouble?

If you're noticing a spelling correction that you don't believe should be happening, there are several things that can help resolve your situation. Please reach out to your customer success representative and let us know what you're seeing, and what you'd expect to happen in those cases.

Some of the possible options forward are:

We can attempt to manually train the spell correction algorithm to gain better knowledge of the context in question. This should only be done for cases that are broadly acceptable corrections - not specific to a site, brand name, etc.

We can disable spelling correction on your site. This is not recommended, as we've found that spelling correction is much more helpful in the majority of cases than it is detrimental in edge cases.

If you believe that the term in question is highly detrimental to your store, but would like to keep spelling correction, as a last resort we can add the term to a blacklist for your site, so that the term willnever be altered by spelling correction inany context.

contact us

SearchSpring's Product Recommendations uses our IntelliSuggest tracking to create rich and relevant products to recommend to your shoppers while both browsing and checking out. This creates an automated flow of opportunities to cross-sell and up-sell.

SearchSpring Employees: Read more internal detail here about Product Recs.

Cross-Selling and Up-Selling

Using engagement data from Product Views, you can leverage automatic up-selling on your store with our Also-Viewed recommendations widget, which shows your customers items that are similar to the onethey'recurrently viewing based on which products other customers viewed in conjunction with this product.

You can also create a valuable cross-selling opportunity on your Cart pages with our Also-Bought recommendations widget, showing your customers complimentary products that others generally have purchased alongside the products they have in their cart.

What information is used to power recommendations?

SearchSpring looks at the past 90 days of customer behavior from the IntelliSuggest tracking installed on your site to power our product recommendations. Products are analyzed in conjunction with other products that are viewed or purchased together in the same visit by your shoppers.

If there aren't enough products recently interacted with to present recommendations, we backfill the list with generally commonly recommended products across your site.

When is the list of products to recommended updated?

SearchSpring updates which products are recommended daily.

What product information can I display, and when is it updated?

You can utilize the core fields of Name, Product URL, SKU, Unique ID, Thumbnail Image URL, Image URL, and Price.

This product display information is updated daily.

Depending on the browsing behavior of your customers, a single product may have up to 100 recommended products available. If you'd like to increase the number of potential products shown in your recommendations, reach out to your customer success representative.

How do I use Product Recommendations?

First, make sure you have IntelliSuggest installed and confirm that it's tracking on your site. Then you can reach out to your customer success representative to ask about having it enabled on your site.

Once Recommendations have been enabled for your site, you can use the API endpoint directly, install our Recommendations widgets, or to have our pro services team integrate Recommendations displays onto your site for you.

When getting SearchSpring on your site, you're getting more than our relevancy engine. Our integration pros have gone above and beyond to create the most powerful and beneficial workflow for installing SearchSpring. From branding consistency to ongoing support benefits, read on to find out how our integration is set apart from the rest.

Visual & Structural Consistency

SearchSpring does more than just appear on your site, webecome part of your site, adding supercharged abilities to your existing site at the code-structure level.

We dynamically replicate every element of your code structure to ensure that not only does your site remain structurally the same, but that it now has advanced SearchSpring capabilities coursing through its veins without losing your existing layouts, styles, or code structure.

Seamless for your customers

Your customers will notice a big improvement in their browsing experience without any jarring changes in the site itself. Even your website's URLs will remain exactly the same to ensure that customers don't miss a beat, and so they can focus on what matters most: Finding what they're looking for.

We do all the heavy lifting

Revamping and installing advanced code can be a difficult task, and highly expensive to hire trained developers to do for you. That's why we do all of the heavy programming lifting for you, coordinating with you in every step of the process.

No need to worry about hosting any extra files or finding server space, we host everything on our end, too.

Super-fast issue resolution

We are constantly monitoring everything about your site's performance, from page errors to 404 pages, right down to code errors. If something goes awry, we will notice it and immediately work on resolving the issue, often times before you even notice.

Always up to date

Our library of flexible modules that power your search and categories are always getting new features and updates. Having a SearchSpring professional integration means that you'll always be at the front of the line for having the latest and greatest features for your search, categories, autocomplete, product recommendations, and more. What's more, we automatically update from our end without having to dig back into your site's templates.

Your style. Always.

We realize that it's critically important that your brand remain in-tact, consistent, and professionally done. We go the extra mile to make sure that our integration will continue to honor any changes your make to your site's own stylesheet code. Want to change some colors across both your site and SearchSpring-powered segments? Done. No iFrames or shadow DOMs here.

Power your category pages

Why power category pages with SearchSpring? In addition to advanced insights, look no further than our merchandising suite for refined control over your product arrangements, faceting options, banner promotions, and more.

We'll handle all of the details

There are a lot of nitty-gritty details and UX considerations that go into making a responsible, fully functional search experience on your site. We have all of those best practices in hand, and the know-how to execute on them. Everything is built for optimal speed, reliability, and with consideration to even the smallest interactions that make for a smooth customer journey.

Powerful, advanced custom behaviors

Every site is beautifully unique and has different needs in terms of behaviors. We understand that there is a great plethora of custom capabilities that are needed, and so we will work together with you to accomplish just about any behavior through SearchSpring. Often times these integrations can work in hand-in-hand with SearchSpring features like Product Boosting Rules !

Here's just a few examples:

Sliders/carousels

Quick-view

Hover effects

Badges

Pricing logic

Dynamic images

Ratings

Shipping costs

Pagination

URL structure

Add to cart URLs

Faceting / filter summary

Checkboxes

Headers

... and more!

See also...

SearchSpring Integration Process

Take product discovery to an entirely new level with more control over how your recommendations behave than ever before!

Instant Control: Choose algorithm type, apply filters, set boost rules, and tweak template settings all directly from the SearchSpring Management Console, which will instantly apply.

Powerful Display Templates: Robust, dynamic new templating system that allows separate controls for the template creator and the recommendations merchandiser.

Place Them Anywhere: Show top performers on your home page, most viewed on your zero results page, display also-viewed products that are in-stock on product detail pages, cart pages, and more!

Easy Install: Simple, quick one-time installation for each recommendations display profile.

See also: Recommendations Profiles

When can I get it? What does it cost?

We are in the early stages of launching our new Product Recommendations. If you are interested in taking advantage of it, please reach out to your customer success representative to discuss pricing and implementation options.

Anything for Developers?

We have built a brand new API that is used for both basic and our new Product Recommendations You can view the documentation for the Recommend API here.

Search Preview allows you to explore all of the under-the-hood functionality of SearchSpring. With it, you can easily view your product data, easily understand why products show up where they do, where search terms match your product data, how synonyms work, and more.

Using the Interface

Viewing Search Matches

Showing Product Field Data

Advanced View

Search Preview allows you to explore all of the under-the-hood functionality of SearchSpring. With it, you can easily view your product data, easily understand why products show up where they do, where search terms match your product data, how synonyms work, and more.

Using the Interface

Searching

Use the search box at the top right to search the catalog, it will search exactly as it does on the live site, with some bonus behind-the-scenes looks.

Pagination

Pagination at the top right of product listings can be used to page through large sets of products.

Faceting

The faceting bar on the left can be used to refine the current product set down to more specific products. These are the same facets that are set up on the live site through the Faceting page.You can use the arrow at the top right of this area to collapse the bar to focus more on the products.

Sorting

Use the Sort dropdown at the top left of product listings to sort products by any order that's been set up for the account in the Sort Options page.

Viewing Search Matches

Once you've searched for something, you'll be able to access all of the details on why products showed up the way they did.

Match Bar

The match bar below each product gives an easy and high-level view into how well products ranked in what you searched for. Products with the same bar level are considered equally relevant to each other.

View Details

Clicking the "View Details" button below the match bar opens a detailed explanation of what matched where.

View Details: Title

The top left of the details popup simply reminds you which product you are viewing match details for.

View Details: Search Term / Phrase

The "Search Term / Phrase" column breaks down every word in what you searched for separately to show where each one was found. A reminder of the full search can be seen at the top right.

View Details: Synonyms Applied

The "Synonyms Applied" column will show any Synonyms that caused a match in the search.

In this example, there is a synonym set up for "onesie" and "romper". When searching for "onesie", SearchSpring also looked for and found "romper" in this product's Title.

View Details: Matches In

The "Matches In" column shows which product properties the search term was found in.

In this example, SearchSpring found your search term "blue" within this product's Title and Color Family.

Showing Product Properties

Product fields (aka. properties) can be easily viewed on each product in the product list. To select which fields to view, go to the Fields toolbox on the right and select fields from the dropdown. You can search this dropdown to more quickly find a specific field. You can remove fields from being displayed by clicking the blue highlighted field name above the dropdown.

Once a field is selected, it will appear beneath every product on the page, showing the value(s) each product has for that field.

Advanced View

The Advanced View offers deeper insight into the search logic going into results, showing why products are being arranged the way they are. To switch to the this view, open the Options toolbox and select Advanced.

Product Type

The Product Type is the human-understood type of product that SearchSpring has derived from a product's data. This is used as one of the primary methods of search relevancy scoring, so searches that match the product type will rank higher.

Search Logic

The Search Logic section shows how each product scored in several categories. If a product scores for a category in this search, it will show a checkmark. If it didn't, it will show a greyed out dash.

Query Terms Found:The number of searched words found in a product's data. For most SearchSpring sites, all terms being found is a search requirement for best relevancy (called "strict search").

Subject Match:There's a solid search match on the product type.

Modifier Match:There's a loose search match around the product type.

Phrase Match:Whether multiple words from a search were found close together in the product's data as well. Example: Search for "red dress" where a product has "red summer dress" in its Title.

If your site has had a "loose search" mode enabled, there is no longer the requirement of all search words being found in products. In many cases, sites only use a loose search as a fallback when no results would be found with all words (called "Automatic Search Downgrade"). In this case, you'll see the number of query terms found at the top of Search Logic.

In this example, "amazing" was not found in any products, but both "red" and "dress" were found in some products. Therefore, it shows "2 out of 3 Query Terms Found".

Boosts

If the site has set up Product Boosting Rules that apply to this context, boost rule values will be shown at the bottom of the advanced details on each product. On search result pages, boosts always sub-sort after relevancy ties.

Many of our customers receive a no results page when viewing their SearchSpring-powered pages through Google's cache. The reason for this is quite simple. We'll use the following URL as an example:

http://webcache.googleusercontent.com/search?q=cache:_TYeGXPlEf4J:www.mysite.com/mycategory.html+&cd=1&hl=en&ct=clnk&gl=uk

When this page loads one of the first things SearchSpring AJAX Catalog does is look for a search query. Since Google is using a "q=" parameter the AJAX Catalog sees this as a search query and will use the portion of text following it as a search query for the page. In this case, the text "cache:_TYeGXPlEf4J:www.mysite.com/mycategory.html" would be used as a search query. Obviously, this is not a good search query and will return zero results.

While this may be worrying at first, there is really nothing to worry about here. The cache isn't actually used by Google for crawling purposes. It used to be a common case to use this cache to check the "crawl-ability" of a site, but that is no longer true. If you would like to check how well Google can crawl your site you should be using the "Fetch as Google" tool that Google has made available. You can find more information about this tool at the link below.

https://support.google.com/webmasters/answer/6066468?hl=en

The following is an XML Data Sample of 20 products, containing the required data fields of a very typical implementation:

Download searchspring.xml

<?xml version="1.0" encoding="UTF-8"?>

<Products>

<Product>

<Product_ID>7631</Product_ID>

<SKU>HEH-9133</SKU>

<Name>On Cloud Nine Pillow</Name>

<Product_URL>https://www.domain.com/product/heh-9133</Product_URL>

<Price>24.99</Price>

<Retail_Price>24.99</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/heh-9133_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Home>Home Decor>Pillows|Back In Stock</Category>

<Category_ID>298|511</Category_ID>

<Brand>FabDecor</Brand>

<Child_SKU></Child_SKU>

<Child_Price></Child_Price>

<Color>White</Color>

<Color_Family>White</Color_Family>

<Color_Swatches></Color_Swatches>

<Size></Size>

<Shoe_Size></Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion></Occassion>

<Season></Season>

<Badges></Badges>

<Rating_Avg>4.2</Rating_Avg>

<Rating_Count>8</Rating_Count>

<Inventory_Count>21</Inventory_Count>

<Date_Created>2018-03-03 17:41:13</Date_Created>

</Product>

<Product>

<Product_ID>7615</Product_ID>

<SKU>HEH-2245</SKU>

<Name>Simply Sweet Blouse</Name>

<Product_URL>https://www.domain.com/product/heh-2245</Product_URL>

<Price>42</Price>

<Retail_Price>59.95</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/heh-2245_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Clothing>Tops>Blouses|Clearance|Tops On Sale</Category>

<Category_ID>285|512|604</Category_ID>

<Brand>Entity Apparel</Brand>

<Child_SKU>HEH-2245-RSWD-SM|HEH-2245-RSWD-MD|HEH-2245-THGR-SM|EH-2245-THGR-MD|HEH-2245-DKCH-SM|HEH-2245-DKCH-MD</Child_SKU>

<Child_Price>42|59.99</Child_Price>

<Color>Rosewood|Thyme Green|Dark Charcoal</Color>

<Color_Family>Red|Green|Grey</Color_Family>

<Color_Swatches>[{"color":"Rosewood", "family":"Red", "swatch_hex":"#65000b", "thumbnail":"/images/heh-2245-rswd-sm_600x600.png", "price":42}, {"color":"Thyme Green", "family":"Green", "swatch_img":"/swatches/thyme_green.png", "thumbnail":"/images/heh-2245-thgr-sm_600x600.png", "price":59.99}, {"color":"Dark Charcoal", "family":"Grey", "swatch_hex":"#36454f", "thumbnail":"/images/heh-2245-dkch-sm_600x600.png", "price":59.99}]</Color_Swatches>

<Size>Small|Medium</Size>

<Shoe_Size></Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion></Occassion>

<Season>Summer|Spring</Season>

<Badges>Exclusive|Clearance</Badges>

<Rating_Avg>4.5</Rating_Avg>

<Rating_Count>10</Rating_Count>

<Inventory_Count>8</Inventory_Count>

<Date_Created>2018-03-20 22:24:21</Date_Created>

</Product>

<Product>

<Product_ID>8100</Product_ID>

<SKU>WKS-6016</SKU>

<Name>Uptown Girl Blouse</Name>

<Product_URL>https://www.domain.com/product/wks-6016</Product_URL>

<Price>58</Price>

<Retail_Price>89.95</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/wks-6016_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Clothing>Tops>Blouses</Category>

<Category_ID>285</Category_ID>

<Brand>Entity Apparel</Brand>

<Child_SKU>WKS-6016-CORD-MD|WKS-6016-KEGR-MD</Child_SKU>

<Child_Price></Child_Price>

<Color>Coral Red|Kelly Green</Color>

<Color_Family>Red|Green</Color_Family>

<Color_Swatches>[{"color":"Coral Red", "family":"Red", "swatch_img":"/swatches/coral_red.png", "thumbnail":"/images/wks-6016-cord-md_600x600.png", "price":58}, {"color":"Kelly Green", "family":"Green", "swatch_img":"/swatches/kelly_green.png", "thumbnail":"/images/wks-6016-kegr-md_600x600.png", "price":58}]</Color_Swatches>

<Size>Medium</Size>

<Shoe_Size></Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion></Occassion>

<Season>Summer|Spring</Season>

<Badges>Exclusive</Badges>

<Rating_Avg>4.2</Rating_Avg>

<Rating_Count>11</Rating_Count>

<Inventory_Count>9</Inventory_Count>

<Date_Created>2018-03-16 21:55:28</Date_Created>

</Product>

<Product>

<Product_ID>6489</Product_ID>

<SKU>DKO-PROF</SKU>

<Name>Knock Your Socks Off Lace-Up Heels</Name>

<Product_URL>https://www.domain.com/product/dko-prof</Product_URL>

<Price>38</Price>

<Retail_Price>60</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/dko-prof_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Shoes>Heels>Lace-Up Heels|Featured Products|Shoes On Sale</Category>

<Category_ID>310|719|605</Category_ID>

<Brand>Spark Collective</Brand>

<Child_SKU>DKO-PROF-BLK-5|DKO-PROF-BLK-5.5|DKO-PROF-BLK-6|DKO-PROF-BLK-7|DKO-PROF-BLK-7.5</Child_SKU>

<Child_Price></Child_Price>

<Color>Black</Color>

<Color_Family>Black</Color_Family>

<Color_Swatches></Color_Swatches>

<Size></Size>

<Shoe_Size>5|5.5|6|7|7.5</Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion></Occassion>

<Season></Season>

<Badges>Featured</Badges>

<Rating_Avg>4.9</Rating_Avg>

<Rating_Count>4</Rating_Count>

<Inventory_Count>19</Inventory_Count>

<Date_Created>2018-02-28 23:37:28</Date_Created>

</Product>

<Product>

<Product_ID>7732</Product_ID>

<SKU>HEH-2172</SKU>

<Name>My Cup of Tea Sweater</Name>

<Product_URL>https://www.domain.com/product/heh-2172</Product_URL>

<Price>68</Price>

<Retail_Price>68</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/heh-2172_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Clothing>Tops>Sweaters</Category>

<Category_ID>277</Category_ID>

<Brand>Enigma Clothes</Brand>

<Child_SKU>HEH-2172-WHT-MD|HEH-2172-WHT-LG</Child_SKU>

<Child_Price></Child_Price>

<Color>White</Color>

<Color_Family>White</Color_Family>

<Color_Swatches></Color_Swatches>

<Size>Medium|Large</Size>

<Shoe_Size></Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion></Occassion>

<Season>Winter</Season>

<Badges></Badges>

<Rating_Avg>4.6</Rating_Avg>

<Rating_Count>22</Rating_Count>

<Inventory_Count>3</Inventory_Count>

<Date_Created>2018-03-01 20:18:20</Date_Created>

</Product>

<Product>

<Product_ID>7609</Product_ID>

<SKU>HEH-2211</SKU>

<Name>Walk On Out Slip On Sneakers</Name>

<Product_URL>https://www.domain.com/product/heh-2211</Product_URL>

<Price>34.99</Price>

<Retail_Price>34.99</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/heh-2211_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Shoes>Sneakers>Slip-On Sneakers</Category>

<Category_ID>302</Category_ID>

<Brand>Temptation</Brand>

<Child_SKU>HEH-2211-BSQ-6|HEH-2211-BSQ-7|HEH-2211-BSQ-8|HEH-2211-BSQ-9|HEH-2211-BSQ-10|HEH-2211-BSQ-10.5</Child_SKU>

<Child_Price></Child_Price>

<Color>Bisque</Color>

<Color_Family>Beige</Color_Family>

<Color_Swatches></Color_Swatches>

<Size></Size>

<Shoe_Size>6|7|8|9|10|10.5</Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion></Occassion>

<Season></Season>

<Badges></Badges>

<Rating_Avg>3.9</Rating_Avg>

<Rating_Count>5</Rating_Count>

<Inventory_Count>2</Inventory_Count>

<Date_Created>2018-03-20 22:15:34</Date_Created>

</Product>

<Product>

<Product_ID>7675</Product_ID>

<SKU>DKO-CAMEL</SKU>

<Name>Warm Hearts Sweater</Name>

<Product_URL>https://www.domain.com/product/dko-camel</Product_URL>

<Price>54.49</Price>

<Retail_Price>54.49</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/dko-camel_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Clothing>Tops>Sweaters|Back In Stock|Featured Products</Category>

<Category_ID>277|511|719</Category_ID>

<Brand>Legacy Apparel</Brand>

<Child_SKU>DKO-CAMEL-GRY-SM</Child_SKU>

<Child_Price></Child_Price>

<Color>Grey</Color>

<Color_Family>Grey</Color_Family>

<Color_Swatches></Color_Swatches>

<Size>Small</Size>

<Shoe_Size></Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion></Occassion>

<Season>Winter</Season>

<Badges>Featured|Free Shipping</Badges>

<Rating_Avg>5</Rating_Avg>

<Rating_Count>2</Rating_Count>

<Inventory_Count>20</Inventory_Count>

<Date_Created>2018-03-19 20:53:04</Date_Created>

</Product>

<Product>

<Product_ID>7463</Product_ID>

<SKU>WKS-5026</SKU>

<Name>Silver Lining Dress</Name>

<Product_URL>https://www.domain.com/product/wks-5026</Product_URL>

<Price>62</Price>

<Retail_Price>62</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/wks-5026_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Dresses>Formal Dresses|All Dresses</Category>

<Category_ID>220|201</Category_ID>

<Brand>Temptation</Brand>

<Child_SKU>WKS-5026-GRNP-XS|WKS-5026-GRNP-SM|WKS-5026-GRNP-MD</Child_SKU>

<Child_Price></Child_Price>

<Color>Green Print</Color>

<Color_Family>Green</Color_Family>

<Color_Swatches></Color_Swatches>

<Size>X-Small|Small|Medium</Size>

<Shoe_Size></Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion>Formal</Occassion>

<Season></Season>

<Badges></Badges>

<Rating_Avg>5</Rating_Avg>

<Rating_Count>9</Rating_Count>

<Inventory_Count>0</Inventory_Count>

<Date_Created>2018-03-01 19:59:05</Date_Created>

</Product>

<Product>

<Product_ID>7677</Product_ID>

<SKU>PCH-8738</SKU>

<Name>Follow The Beat Sneakers</Name>

<Product_URL>https://www.domain.com/product/pch-8738</Product_URL>

<Price>32</Price>

<Retail_Price>32</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/pch-8738_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Shoes>Sneakers>Slip-On Sneakers</Category>

<Category_ID>302</Category_ID>

<Brand>Fusion Fashion</Brand>

<Child_SKU>PCH-8738-GRY-8|PCH-8738-GRY-9|PCH-8738-BLK-8|PCH-8738-BLK-9|PCH-8738-LEP-8|PCH-8738-LEP-9</Child_SKU>

<Child_Price></Child_Price>

<Color>Grey|Black|Leopard</Color>

<Color_Family>Grey|Black|Multi</Color_Family>

<Color_Swatches>[{"color":"Grey", "family":"Grey", "swatch_hex":"#d3d3d3", "thumbnail":"/images/pch-8738-gry-8_600x600.png", "price":32}, {"color":"Black", "family":"Black", "swatch_hex":"#000000", "thumbnail":"/images/pch-8738-blk-8_600x600.png", "price":32}, {"color":"Leopard", "family":["Black","Multi"], "swatch_img":"/swatches/leopard.png", "thumbnail":"/images/pch-8738-lep-8_600x600.png", "price":32}]</Color_Swatches>

<Size></Size>

<Shoe_Size>8|9</Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion></Occassion>

<Season></Season>

<Badges></Badges>

<Rating_Avg>4.5</Rating_Avg>

<Rating_Count>1</Rating_Count>

<Inventory_Count>8</Inventory_Count>

<Date_Created>2019-01-31 16:24:09</Date_Created>

</Product>

<Product>

<Product_ID>8099</Product_ID>

<SKU>PCH-8475</SKU>

<Name>Cup of Joe Pillow</Name>

<Product_URL>https://www.domain.com/product/pch-8475</Product_URL>

<Price>36</Price>

<Retail_Price>36</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/pch-8475_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Home>Home Decor>Pillows</Category>

<Category_ID>298</Category_ID>

<Brand>FabDecor</Brand>

<Child_SKU></Child_SKU>

<Child_Price></Child_Price>

<Color>Seafoam Green</Color>

<Color_Family>Green</Color_Family>

<Color_Swatches></Color_Swatches>

<Size></Size>

<Shoe_Size></Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion></Occassion>

<Season></Season>

<Badges></Badges>

<Rating_Avg>4</Rating_Avg>

<Rating_Count>1</Rating_Count>

<Inventory_Count>18</Inventory_Count>

<Date_Created>2018-02-28 19:03:26</Date_Created>

</Product>

<Product>

<Product_ID>7425</Product_ID>

<SKU>BCO-SK101</SKU>

<Name>Burst Your Bubble Denim Jacket</Name>

<Product_URL>https://www.domain.com/product/bco-sk101</Product_URL>

<Price>84</Price>

<Retail_Price>110</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/bco-sk101_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Clothing>Tops>Jackets|Clearance|Tops On Sale</Category>

<Category_ID>279|512|604</Category_ID>

<Brand>Zigzag Clothing</Brand>

<Child_SKU>BCO-SK101-WSDM-LG</Child_SKU>

<Child_Price></Child_Price>

<Color>Washed Denim</Color>

<Color_Family>Denim</Color_Family>

<Color_Swatches></Color_Swatches>

<Size>Large</Size>

<Shoe_Size></Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion></Occassion>

<Season></Season>

<Badges>Clearance</Badges>

<Rating_Avg>5</Rating_Avg>

<Rating_Count>1</Rating_Count>

<Inventory_Count>17</Inventory_Count>

<Date_Created>2018-05-04 21:32:28</Date_Created>

</Product>

<Product>

<Product_ID>8102</Product_ID>

<SKU>HEH-2254</SKU>

<Name>Walk It Out Heels</Name>

<Product_URL>https://www.domain.com/product/heh-2254</Product_URL>

<Price>32</Price>

<Retail_Price>32</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/heh-2254_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Shoes>Heels>Pumps|New Arrivals|Featured Products</Category>

<Category_ID>311|510|719</Category_ID>

<Brand>Fusion Fashion</Brand>

<Child_SKU>HEH-2254-BLK-6|HEH-2254-BLK-7|HEH-2254-BLK-8</Child_SKU>

<Child_Price></Child_Price>

<Color>Black</Color>

<Color_Family>Black</Color_Family>

<Color_Swatches></Color_Swatches>

<Size></Size>

<Shoe_Size>6|7|8</Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion></Occassion>

<Season></Season>

<Badges>Featured</Badges>

<Rating_Avg>4.7</Rating_Avg>

<Rating_Count>5</Rating_Count>

<Inventory_Count>10</Inventory_Count>

<Date_Created>2019-01-31 16:48:23</Date_Created>

</Product>

<Product>

<Product_ID>9964</Product_ID>

<SKU>BCO-2208</SKU>

<Name>Word To The Wise Journal</Name>

<Product_URL>https://www.domain.com/product/bco-2208</Product_URL>

<Price>14.95</Price>

<Retail_Price>14.95</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/bco-2208_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Home>Desk Decor>Journals</Category>

<Category_ID>410</Category_ID>

<Brand>Vintage Home</Brand>

<Child_SKU></Child_SKU>

<Child_Price></Child_Price>

<Color>Blue</Color>

<Color_Family>Blue</Color_Family>

<Color_Swatches></Color_Swatches>

<Size></Size>

<Shoe_Size></Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion></Occassion>

<Season></Season>

<Badges></Badges>

<Rating_Avg>4</Rating_Avg>

<Rating_Count>32</Rating_Count>

<Inventory_Count>5</Inventory_Count>

<Date_Created>2018-10-18 15:19:37</Date_Created>

</Product>

<Product>

<Product_ID>10440</Product_ID>

<SKU>KOI-721</SKU>

<Name>Basic Beauty Off-The-Shoulder Dress</Name>

<Product_URL>https://www.domain.com/product/koi-721</Product_URL>

<Price>52</Price>

<Retail_Price>78</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/koi-721_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Dresses>Off-The-Shoulder Dresses|Dresses On Sale</Category>

<Category_ID>221|603</Category_ID>

<Brand>Oasis</Brand>

<Child_SKU>KOI-721-BLP-SM|KOI-721-BLP-MD</Child_SKU>

<Child_Price></Child_Price>

<Color>Blue Print</Color>

<Color_Family>Blue|Multi</Color_Family>

<Color_Swatches></Color_Swatches>

<Size>Small|Medium</Size>

<Shoe_Size></Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion>Graduation</Occassion>

<Season></Season>

<Badges>Exclusive</Badges>

<Rating_Avg>3.2</Rating_Avg>

<Rating_Count>15</Rating_Count>

<Inventory_Count>30</Inventory_Count>

<Date_Created>2018-03-03 17:38:50</Date_Created>

</Product>

<Product>

<Product_ID>6060</Product_ID>

<SKU>VBH-V5102</SKU>

<Name>Sunset Boulevard Pants</Name>

<Product_URL>https://www.domain.com/product/vbh-v5102</Product_URL>

<Price>44</Price>

<Retail_Price>60</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/vbh-v5102_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Clothing>Bottoms>Pants|All Bottoms</Category>

<Category_ID>236|204</Category_ID>

<Brand>Monolith</Brand>

<Child_SKU>VBH-V5102-WHT-24|VBH-V5102-WHT-25|VBH-V5102-WHT-26|VBH-V5102-WHT-27|VBH-V5102-BEG-24|VBH-V5102-BEG-25|VBH-V5102-BEG-26|VBH-V5102-BEG-27|VBH-V5102-BEG-30|VBH-V5102-BEG-31</Child_SKU>

<Child_Price></Child_Price>

<Color>White|Beige</Color>

<Color_Family>White|Beige</Color_Family>

<Color_Swatches>[{"color":"White", "family":"White", "swatch_hex":"#ffffff", "thumbnail":"/images/vbh-v5102-wht-24_600x600.png", "price":44}, {"color":"Beige", "family":"Beige", "swatch_hex":"#f5f5dc", "thumbnail":"/images/vbh-v5102-bge-24_600x600.png", "price":44}]</Color_Swatches>

<Size></Size>

<Shoe_Size></Shoe_Size>

<Pants_Size>24|25|26|27|30|31</Pants_Size>

<Occassion></Occassion>

<Season></Season>

<Badges></Badges>

<Rating_Avg>3.8</Rating_Avg>

<Rating_Count>33</Rating_Count>

<Inventory_Count>1</Inventory_Count>

<Date_Created>2018-02-28 23:57:53</Date_Created>

</Product>

<Product>

<Product_ID>10448</Product_ID>

<SKU>SKE-15460</SKU>

<Name>Across The Pond Boots</Name>

<Product_URL>https://www.domain.com/product/ske-15460</Product_URL>

<Price>74.49</Price>

<Retail_Price>74.49</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/ske-15460_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Shoes>Boots>Flat Boots</Category>

<Category_ID>334</Category_ID>

<Brand>Legacy Collective</Brand>

<Child_SKU>SKE-15460-BRN-6|SKE-15460-BRN-7|SKE-15460-BRN-8.5</Child_SKU>

<Child_Price></Child_Price>

<Color>Brown</Color>

<Color_Family>Brown</Color_Family>

<Color_Swatches></Color_Swatches>

<Size></Size>

<Shoe_Size>6|7|8.5</Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion></Occassion>

<Season></Season>

<Badges></Badges>

<Rating_Avg>5</Rating_Avg>

<Rating_Count>6</Rating_Count>

<Inventory_Count>0</Inventory_Count>

<Date_Created>2018-06-25 18:09:07</Date_Created>

</Product>

<Product>

<Product_ID>8137</Product_ID>

<SKU>PCH-8705</SKU>

<Name>Once Upon A Time Lace Dress</Name>

<Product_URL>https://www.domain.com/product/pch-8705</Product_URL>

<Price>50</Price>

<Retail_Price>108</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/pch-8705_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Dresses>Lace Dresses|Dresses>All Dresses|New Arrivals</Category>

<Category_ID>222|201|510</Category_ID>

<Brand>Oasis</Brand>

<Child_SKU>PCH-8705-WHT-SM|PCH-8705-WHT-MD|PCH-8705-WHT-LG|PCH-8705-BLK-SM|PCH-8705-BLK-MD|PCH-8705-BLK-LG|PCH-8705-LTBL-SM|PCH-8705-LTBL-MD|PCH-8705-LTBL-LG</Child_SKU>

<Child_Price>50|72|108</Child_Price>

<Color>White|Black|Light Blue</Color>

<Color_Family>White|Black|Blue</Color_Family>

<Color_Swatches>[{"color":"White", "family":"White", "swatch_hex":"#ffffff", "thumbnail":"/images/pch-8705-wht-sm_600x600.png", "price":50}, {"color":"Black", "family":"Black", "swatch_hex":"#000000", "thumbnail":"/images/pch-8705-blk-sm_600x600.png", "price":108}, {"color":"Light Blue", "family":"Blue", "swatch_img":"/swatches/light_blue.png", "thumbnail":"/images/pch-8705-ltbl-sm_600x600.png", "price":72}]</Color_Swatches>

<Size>Small|Medium|Large</Size>

<Shoe_Size></Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion>Party</Occassion>

<Season></Season>

<Badges></Badges>

<Rating_Avg>5</Rating_Avg>

<Rating_Count>4</Rating_Count>

<Inventory_Count>0</Inventory_Count>

<Date_Created>2019-02-15 20:33:28</Date_Created>

</Product>

<Product>

<Product_ID>10018</Product_ID>

<SKU>PGF-ESS</SKU>

<Name>Lovey Dovey Maxi Dress</Name>

<Product_URL>https://www.domain.com/product/pgf-ess</Product_URL>

<Price>68</Price>

<Retail_Price>68</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/pgf-ess_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Dresses>Maxi Dresses|Dresses>All Dresses|New Arrivals</Category>

<Category_ID>223|201|510</Category_ID>

<Brand>Oasis</Brand>

<Child_SKU>PGF-ESS-FUOR-SM|PGF-ESS-FUOR-MD|PGF-ESS-FUOR-LG|PGF-ESS-PRPT-SM|PGF-ESS-PRPT-MD|PGF-ESS-PRPT-LG</Child_SKU>

<Child_Price></Child_Price>

<Color>Fuschia Orange|Perfect Petals|Island Time</Color>

<Color_Family>Orange|Pink|Yellow|Multi</Color_Family>

<Color_Swatches>[{"color":"Fuschia Orange", "family":["Orange","Pink"], "swatch_img":"/swatches/fuschia_orange.png", "thumbnail":"/images/pgf-ess-fuor-sm_600x600.png", "price":68}, {"color":"Perfect Petals", "family":"Pink", "swatch_img":"/swatches/perfect_petals.png", "thumbnail":"/images/pgf-ess-prpt-sm_600x600.png", "price":68}, {"color":"Island Time", "family":["Yellow","Orange","Multi"], "swatch_img":"/swatches/island_time.png", "thumbnail":"/images/pgf-ess-istm-sm_600x600.png", "price":68}]</Color_Swatches>

<Size>Small|Medium|Large</Size>

<Shoe_Size></Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion>Party</Occassion>

<Season></Season>

<Badges></Badges>

<Rating_Avg>4.8</Rating_Avg>

<Rating_Count>12</Rating_Count>

<Inventory_Count>24</Inventory_Count>

<Date_Created>2019-02-20 21:38:02</Date_Created>

</Product>

<Product>

<Product_ID>5670</Product_ID>

<SKU>HEH-2223</SKU>

<Name>Shot in the Dark Pillow</Name>

<Product_URL>https://www.domain.com/product/heh-2223</Product_URL>

<Price>40</Price>

<Retail_Price>40</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/heh-2223_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Home>Home Decor>Pillows</Category>

<Category_ID>298</Category_ID>

<Brand>Vintage Home</Brand>

<Child_SKU></Child_SKU>

<Child_Price></Child_Price>

<Color>Coral</Color>

<Color_Family>Red</Color_Family>

<Color_Swatches></Color_Swatches>

<Size></Size>

<Shoe_Size></Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion></Occassion>

<Season></Season>

<Badges>Free Shipping</Badges>

<Rating_Avg>4</Rating_Avg>

<Rating_Count>3</Rating_Count>

<Inventory_Count>8</Inventory_Count>

<Date_Created>2018-03-01 20:28:28</Date_Created>

</Product>

<Product>

<Product_ID>9020</Product_ID>

<SKU>PGF-RIK</SKU>

<Name>Diamonds Are Forever Pillow</Name>

<Product_URL>https://www.domain.com/product/pgf-rik</Product_URL>

<Price>36</Price>

<Retail_Price>36</Retail_Price>

<Thumbnail_URL>https://www.domain.com/images/pgf-rik_600x600.png</Thumbnail_URL>

<Search_Keywords>lorem, ipsum, dolor, ...</Search_Keywords>

<Description>Sociosqu facilisis duis ...</Description>

<Category>Home>Home Decor>Pillows</Category>

<Category_ID>298</Category_ID>

<Brand>Vintage Home</Brand>

<Child_SKU></Child_SKU>

<Child_Price></Child_Price>

<Color>Light Blue</Color>

<Color_Family>Blue</Color_Family>

<Color_Swatches></Color_Swatches>

<Size></Size>

<Shoe_Size></Shoe_Size>

<Pants_Size></Pants_Size>

<Occassion></Occassion>

<Season></Season>

<Badges>Free Shipping</Badges>

<Rating_Avg>5</Rating_Avg>

<Rating_Count>3</Rating_Count>

<Inventory_Count>11</Inventory_Count>

<Date_Created>2018-03-16 22:17:50</Date_Created>

</Product>

</Products>

Notes

There must be a consistent Record Element node used throughout, ex: <Product>

Each Record must contain a Unique Key node that identifies that product, ex: <Product_ID>

All nested nodes will be flattened, only accounting for the name of the lowest level node

SearchSpring uses the Role assigned the NetSuite user account. Typically NetSuite merchants grant web services access to an existing non-administrative user account. That account can be used by SearchSpring to login to NetSuite to download product information regularly.

In connecting properly to NetSuite, SearchSpring needs to know the Account ID and User Role ID.

Go to Setup -> Integration -> Web Services Preferences

Copy the Account ID

Select the username from the drop-down list in the lower region of the screen.

Select the corresponding Role associated with the user account.

Copy the ID - this is the Role's ID.

Setting Up Your Store's Data with SearchSpring:

1. Prepare

2. Connect

3. Fields

4. Settings

5. IntelliSuggest

6. Analytics

The Core Fields page allows you to ensure that SearchSpring is using all the right information to power full and reliable functionality on your site.

SearchSpring has many helpful features for your e-commerce sites, but in order for these features to utilize your data and show your products, Core Fields must be set.Think of Core Fields as "default fields" for SearchSpring, it's our way of standardizing what your data is, what it means, and how to use it.

Core Fields

The field labels are the display names for your fields. For fields that you are going to use in faceting or comparison it is important to use good field labels, these will be the field names that display to your customers. Required Fields are marked with red asterisks.

To change which of your product feed's fields are assigned as SearchSpring core fields, click the dropdown of that field and select which one you'd like to change the assignment to. You can easily filter through the list of options by typing in the search box that appears.

Unique ID - Required Field. The product's ID. Depending on your platform or custom feed, the ID may also be the SKU.

SKU A string of characters that identifies your product. The SKU field should unique per product and must be set for SearchSpring's IntelliSuggest tracking to work. Please note: SKU is not marked as a required field, but it should always be set. If you do not have SKUs for your products, this could be set to the product's IDwhich is typically unique.

Product Name - Required Field. The name of your product. This field is used in features such as AutoComplete, Product Recommendations and Comparison.

Product URL - Required Field. The URL of your product. This field is used in features such as AutoComplete, Product Recommendations and Comparison.

Add to Cart URL The URL for adding a product to the cart, if your feed has that available.

Price - Required Field. The cost of your product. This field should be set to the final price that customers will see when purchasing your products. This field is used in features such as AutoComplete, Product Recommendations and Comparison.

Suggest Retail Value The retail or MSRP price of the product.

Image URL - Required Field. The image associated with the product. Set this to a thumbnail image field if possible to reduce loading times.

Product Thumbnail Image URL The image you want to display in search results. This field is used in features such as AutoComplete, Product Recommendations and Comparison.

Customer Rating The overall customer review score of a product. This is usually a numeric value.

Number of Reviews The total amount of times a product has been reviewed by customers.

Product Description The description of your product. This can be a long or short description.

Stock Message If your site uses special messages when a product is out of stock or low in stock, you can set the message that appears here.

Brand The brand or a manufacturer associated with a product.

Popularity A ranking of how popular a product is, commonly based on how many times thatitem has been sold. In the AutoComplete feature, it will work as a boost when a shopper searches. Products with more popularity(most to least popular) are shown first and then relevant products. If "Popularity" is not set, the fallback for AutoComplete product ordering is relevancy.

Custom Fields At the bottom of every selection drop down, there is a field called custom. This can be used to map multiple fields, other text, or different URL structures. Any data fields you want to use with the "custom" option should be surrounded by a percent sign (%). Example: //www.mycoolwebsite.com/mm5/resize/250x250/%image%

Check for New Fields

The "Check for New Fields" button will re-validate your data feed and build new fields that are found in your data feed that did not exist previously.

Review Feed Sample

The "Review Feed Sample" buttonshows the first75 records found in your data feed and the fields that relate to those 75 records. If there is a field that only exists in records beyond the first75 they will not be included in this preview. This preview is useful to check your data when setting up fields.

Save Changes

Once you've completed all of your changes, click the "Save" button at the bottom of the page to save you changes. You will need to re-index your site for changes to take affect.

Based on: https://docs.google.com/document/d/1-lMJZ96MR7NLz0Syfp4dMasffiNW9ee8eg4r5FddopU/

Create a rich autocomplete to display suggested terms and products as a customer types using our Suggest API.

Our Suggest API leverages data weve gathered from your customers and product data to suggest search terms for the customer based on what theyve currently typed in the search box.

Onceyou'vereceived a suggested term from our Suggest API you would then use our standard Search API to also display products for that term to your customer.

Include a summary of filters the customer has applied.

In your results display include a list of filters that customer has currently applied to the results to allow customers to remove filters easily.

Include a Clear All button as well can be helpful.

If you have many different filters, allow customers to collapse and expand filters.

Your team can configure which filters are expanded and collapsed by default on our Facet Configuration page.

This frees up screen real estate and prevents overwhelming the customer.

Include merchandising banners in results pages.

As part of our Search API response we include HTML for banners your merchandising team has configured in SearchSpring.

These should be displayed on your results page in the position specified by the API response.

Follow redirects returned by our API response.

If a member of your merchandising team has configured a redirect for a search term the URL for the redirect will be returned in the Search API response.

If a redirect URL is returned in the API response you should redirect the browser to that URL

Do not apply any sorts to the search API request by default

Any changes in default sorting should be done through our merchandising boosting system.

By default our system will sort your results based on textual relevancy for search results pages and the primary sort configured in SearchSpring for other pages.

Integrate SearchSpring Tracking

SearchSpring needs customer tracking in place to properly learn from your customer behavior.

Please include a user ID in your API requests to allow us to differentiate users as they search.

Integrate our IntelliSuggest Tracking.

If doing a server side integration, you will need to pass your customers IP address as an HTTP_X_FORWARDED_FOR header.

The following guide will explain what steps SearchSpring takeswhen creating a mockup for a new or redesigned site. These steps ensure that we are able to meet and exceed our client's expectations. Also included are general estimates of the time taken for each step, these times may fluctuate based on our current workload.

Initial Data Audit

3-4 days

The initial data audit stage of our setup process ensures that we are able to collect product data from the client's store. SearchSpring will do the following during this stage:

Create a project within our product management tool for easy communication.

Connect your data feed/shopping cart API to SearchSpring's search database.

Create base account configuration.

Review your data feed and/or shopping cart API data to ensure it meets all minimum requirements.

Deliver full audit to the client of our findings.

Functional Requirements

2-3 days

Once we have ensured that all the basic requirementsare met, SearchSpring will send a questionnaire to the client in order to collect the full requirements of the project. This includes, but is not limited to:

Design Requirements

What pages should we match in design?

Will we be using a responsive design?

Will the client be using SearchSpring on a dedicated mobile site?

What display options will be included in the design? (grid, list, etc)

Are there any additional components needed for design? (mobile facets, filter summary, etc)

Function Requirements

What fields will customers be able to use to filter their results?

Should we be excluding any products from our results?

Is there any special pricing logic we should be aware of? (sale pricing, MAP pricing, pricing groups, etc)

Are there any badges that should be displayed on products in results? (new, sale, free shipping, etc)

Are there any business rules that should affect the order of results? (out of stock products, sale products, bestselling, etc)

Integration Responsibility

Where will SearchSpring be integrated? (search results pages, category pages, brand pages, etc)

Will SearchSpring be integrating the page onto the client's website or will we be providing instructions for the client's team?

Professional Services

Will there be any other advanced features the customer would like to implement? (product finders/wizards, smart color swatches, etc)

Once this questionnaire is complete the SearchSpring design team will deliver a functional requirements document with afull breakdown of the features that we will deliver to the client for approval.This will also include any requirements SearchSpring may have in order to complete all of the features desired. A call may be scheduled as a follow-up to the questionnaire prior to the function requirements being delivered if there are any questions or concerns with the responses in the form.

Project Timeline

< 1 day

Once the client has approved the functional requirements document (and requirements are met) SearchSpring will deliver an estimated timeline to the customer and begin work on the project.

Account & Data Setup

1 week

During the first two weeks of the implementation process, SearchSpring is setting up your account & data within our search database. This includes, but is not limited to:

Integrate our Google Analytics API.

Reviewing Google Analytics for historical customer search behavior.

Configuring our industry-leading relevancy engine.

Creating product faceting and sorting options.

Excluding products not to be displayed within results.

Performingdata massaging to ensure high-quality results.

Install our IntelliSuggest customer behavior tracking scripts.

Perform a full internal QA review to ensure a full-quality setup.

Initial Design

2 weeks

Once the account & data portions of the integration are complete SearchSpring will begin work on making our search and navigation features integrate into your existing design seamlessly. This includes, but is not limited to:

Implement customer's existing HTML and CSS pages into Angular JavaScript templates.

Integrate any existing JavaScript functionality into SearchSpring's Angular JavaScript templates, using SearchSpring's callback based functionality to ensure all features work seamlessly as customers navigate the client's site.

Create a new rich autocomplete search to show search suggestions, products, facets, and even merchandising as the customer types.

Perform a full internal QA review to be sure nothing was missed including cross browser testing and mobile testing.

Once the design is complete it will be delivered to the customer for review. At this point, the client's marketing and web teams should review the design to ensure it meets all of their requirements and provide any revisions to the SearchSpring team.

Revisions

3-4 days

Once SearchSpring has received a full list of revisions from the client's review, we will make any changes required to the design as per the client's requests.

Integration

1 day

When the client is happy with the state of the design SearchSpring will schedule an integration window. If SearchSpring will be performing the integration we will let the client know when we plan on integrating and what credentials we may need to complete the integration. If the client is integrating, we will deliver instructions ahead of time for review and be available for support throughout the integration window.

The Search Termstable gives you direct insight into your store's search history. Here you can view specific analytics related to each search query.

Search Term

Thesearch query that was searched for.

Total Unique Searches

The total number of times this query was searched for during a shopper's session on your site. A shopper repeating the same search multiple times during the same session does not count in addition to this.For example, if "shoes" was searched for 3 times in a session, it would be counted only once. You can use this metric to gauge how popular this search query is on your site.

% Search Exits

The ratioofhow often this search querywas the last pagea shopperviewedduring their session.This can be used to gauge the number of times shoppers endtheir browsing on this search query.

Calculation:Search Exits /Total Unique Searches

Time After Search

The average amount of time shoppers spend engaged on your site after searching for this query. You can use this metric to gauge which search termskeep your shoppers on your site the longest.

Calculation:Total Search Duration /Total Unique Searches

Avg. Search Depth

The average number of pages shoppers view after performing this search. You can use this metric to gauge which search terms intrigue your shoppers to continue exploring your site the most.

Calculation:Search Depth (Total number of pages viewed after this search) / Total Unique Searches

Revenue

The total amount of revenue (excluding shipping and tax) thatwas gained from transactions where the shopper searched for this term before converting. This is not intended as a weight or percentage attributed piece oftotal revenue, but can simply be used to identify which searches tend to result in higher revenue relative to other search queries.

Transactions

The total number of transactions that occurred sometime shortly after a shopper searched this query. This can be used to gauge how likely someone searching for this query is to convert, when compared to Transaction numbers from other queries on this table.

Avg. Order Value

The average revenue value per transaction that occurred after a shopper searches for this query. This can be used to focus on how much your converting shoppers tend to spend on a single transaction aftermaking this search.

Calculation:Revenue / Transactions

Conversion Rate

The average percent of shoppers who made a purchase after searchingfor this query. You can use this metric to gauge how likely a shopper is to make a purchase aftersearching for this.

Calculation: Transactions (Orders)/ Total Unique Searches

Table tools

The table has various tools that allow you to easily navigate the data:

Show Per Page: At the top left, you can select how many rows per page you want to view on this table.

Search the table: You can filter the table to only show rows that contain certain terms by searching in the box at the top right.

Export:Clicking an export button at the top right allows you to save a CSV or XLS file of this table. The exported file will include all of the data, not just the table page being viewed.

Pagination:The pagination buttons at the bottom of the table allow you navigate through each page of the table.

SearchSpring provides an API for searching and browsing the catalog of products indexed in your SearchSpring account. The API provides the ability to return results based on a search query or a filter on a field (e.g. Category is "Running Shoes"). SearchSpring will return results in JSON. The response will include products that match the search criteria, available facet options to further refine the results and any configured merchandising content like promotional banner images.

Search API URL

https://api.searchspring.net/api/search/search.json

Using AutoComplete?

While performing a preview search to display product results within an AutoComplete modal, use the following endpoint to avoid muddying up your insights & reporting data:

https://api.searchspring.net/api/search/autocomplete.json

This will function exactly the same as a normal search request, but will not affect your reporting.

Using Product Finders?

If implementing Product Finders, you'll similarly need to use this endpoint to avoid muddying up your insights & reporting data:

https://api.searchspring.net/api/search/finders.json

Request Parameters

siteId (Required)

Format

String

Description

The siteId parameter identifies your site. You can find your siteId on the My Account page.

Example

"scmq7n"

q

Format

String

Description

The search Query. Searches the database for the terms in the query.

Examples

"shoes" "iphone%20charger"

resultsFormat (Optional)

Format

String

Default

"html"

Description

Native will return raw JSON for products. HTML will generate HTML for your products based on SearchSpring templates. Accepts "native" or "html".

Example

"native"

Example Requests

cURL (using httpie )

http https://api.searchspring.net/api/search/search.json siteId=scmq7n q=dress

jQuery GET

$.ajax({

type: "GET",

url: "https://api.searchspring.net/api/search/search.json",

data: {siteId:"scmq7n", q:"dress", resultsFormat:"native"},

success: function(response) { // Use response }

});

Name

Description

pagination

An object representing all the current pagination data.

pagination.totalResults

The total number of results returned by the search result.

pagination.begin

The starting index of the first product in the result. Start with 1.

pagination.end

The ending index of the last product in the result.

pagination.currentPage

The page number of the current results.

pagination.totalPages

The total number of pages available for the current result set.

pagination.previousPage

The page number of the previous page.

pagination.nextPage

The page number of the next page.

pagination.perPage

The current selected option for the number of results per page.

pagination.defaultPerPage

The default value for the client for the number of results per page.

sorting

An array of object representing different sorting options configured in SearchSpring to display to customers.

sorting.options.field

The field name for the sorting option.

sorting.options.direction

The direction for the sorting option.

sorting.options.label

The configured label for the sorting option.

resultLayout

The currently selected resultLayout

results

An array of result objects or HTML representing the result set. When displaying results please respect the order returned by the API.

results.[field]

The value for the current result for the given field.

facets

An array of objects representing the available facets for the current search results.

facets.field

The field name for the facet.

facets.label

The configured label for the field.

facets.type

The type of facet. Possible values of list, grid, palette, hierarchy and slider.

facets.multiple

The configured multiple setting for the facet. Determines how the facet is handled when multiple facet options are selected to filter. Possible values of multiple-union or multiple-intersect.

facets.facet_active

Whether or not the current facet is active. This is 1 if the current facet is active.

facets.values

An array of objects representing the facet option values.

facets.values.active

Whether or not the current facet option is selected for filters. This is 1 if the current facet option is active.

facets.values.type

The type of the facet value. Possible values of value or range.

facets.values.value

The value to filter by for the current facet option. Used for type=value.

facets.values.low

The lower bound value for the current facet option. Used for type=range.

facets.values.high

The upper bound value for the current facet option. Used for type=range.

facets.values.count

The number of results that match the current facet option.

didYouMean

An object representing a spelling suggestion for the current search result. Only included for results with no results.

didYouMean.query

The suggested query after spelling correction.

didYouMean.highlighted

The suggested query with the spelling changes highlighted by being wrapped in em elements.

breadcrumbs

An array of objects representing breadcrumbs for the current search result.

breadcrumbs.label

The label for the current breadcrumb with both field and value.

breadcrumbs.filterLabel

The label for the current breadcrumb with just the filter field label.

breadcrumbs.filterValue

The label for the current breadcrumb with just the filter value.

breadcrumbs.removeFilters

An array of objects representing the filters that should be removed when the current breadcrumb is clicked.

breadcrumbs.removeRefineQuery

An array of refine queries that should be removed when the current breadcrumb is clicked.

filterSummary

An array of objects representing the currently selected filters for the current search result. This is useful when you want to build a list of currently selected filters to display above facets.

filterSummary.field

The field for the current filter.

filterSummary.value

The value for the current filter.

filterSummary.label

The label to display for the current filter. Includes both the field and value labels.

filterSummary.filterLabel

The label to display for the current filter. Only includes the field label.

filterSummary.filterValue

The label to display for the current filter. Only includes the value label.

merchandising

An array of objects representing the configured merchandising campaigns for the current search result.

merchandising.content.[position]

The HTML content to display for the merchandising campaign for the current search result.

merchandising.elevated

An array of SearchSpring IDs of products that were elevated by the current merchandising campaign. For SearchSpring debug use only.

merchandising.is_elevated

An array of SearchSpring IDs of products that were elevated by IntelliSuggest. For SearchSpring debug use only.

merchandising.removed

An array of SearchSpring IDs of products that were removed by the current merchandising campaign. For SearchSpring debug use only.

merchandising.redirect

A string representing the redirect URL that is associated with the current search query.

Response Example

{

"pagination": {

"totalResults": 1375,

"begin": 1,

"end": 24,

"currentPage": 1,

"totalPages": 58,

"previousPage": 0,

"nextPage": 2,

"perPage": 24,

"defaultPerPage": 24

},

"sorting": {

"options": [

{

"field": "relevance",

"direction": "desc",

"label": "Best Match"

}

]

},

"resultLayout": "grid",

"results": [

{

"keywords": "white, Shirt, Dress",

"sales_rank": "4374",

"size": [

"Small",

"Medium",

"Large"

],

"price": "42",

"imageUrl": "https://i.imgur.com/fwnlmf2.png",

"name": "Elevated Classic White Shirt Dress",

"sku": "ABC123",

"url": "https://i.imgur.com/fwnlmf2"

}

],

"facets": [

{

"field": "color_family",

"label": "Color",

"type": "palette",

"multiple": "multiple-union",

"collapse": 1,

"facet_active": 0,

"values": [

{

"active": false,

"type": "value",

"value": "Beige",

"label": "Beige",

"count": 54

}

]

}

],

"breadcrumbs": [

{

"label": "Search: \"dress\"",

"filterLabel": "Search",

"filterValue": "dress",

"removeFilters": [],

"removeRefineQuery": []

}

],

"filterSummary": [],

"merchandising": {

"redirect": "",

"is_elevated": [],

"elevated": [

"5e3a03f6e5eb95d4ae289f97d0611308"

],

"removed": [

"92b5dfd73f6f4272f9f2142011534777"

],

"content": {

"banner": [

"<script data-banner-type=\"image\" data-banner-html=\"\" data-image-url=\"https://i.imgur.com/fwnlmf2.png\" type=\"text/widget\"></script><img src=\"https://i.imgur.com/fwnlmf2.png\" style=\"width: 100%;\">"

]

},

"facets": [

"ss_size"

],

"facetsHide": [

"reviews_product_score"

]

}

}

Note: We havent had this data for a long time, even though the key still shows up.

Name

Description

relatedSearches

An array of search queries related to the current search terms based on search history.

Upsert

The upsert operation inserts or replaces the entire contents of a product record in SearchSpring. Use this operation to insert new records, or replace existing records with new data.

Note: There is a separate partial update operation for a couple offields foran already existing record.

Request URL

https://[Site ID]:[Secret Key]@api.searchspring.net/api/index/upsert.json [POST]

Site ID: The identifier for your site. It can be found on the My Account page of the SearchSpring Management Console.

Secret Key: The secret key for your live indexing API. Do not share this. Please contact [email protected] for your secret key.

Request Body

The request body should be a JSON encoded string with the following attributes. Note there is a 3MB limit on the size of the request body. If you wish to upsert more products than will fit in 3MB, you will need to split your products up into multiple batches.

feedId: The identifier for your data feed. Please contact [email protected] for your Feed ID.

records: An array of objects representing items in your SearchSpring search database that you wish to create/update. See example below.

Example:

{

"feedId": 42,

"records": [{

"product_id": "1",

"name" : "Blue Nike Shirt",

"price" : 17.99,

"categories" : ["Clothing", "Shirts"],

"image" : "http://www.mystore.com/images/blueshirt.jpg",

"thumbnail" : "http://www.mystore.com/thumbs/blueshirt.jpg",

"url" : "http://www.mystore.com/blue-shirt.html",

"in_stock" : true,

"rating" : 4.5,

"brand" : "Nike",

"color" : "Blue",

"popularity" : 9

},{

"product_id": "2",

"name" : "Red Volcom Shirt",

"price" : 19.99,

"categories" : ["Clothing", "Shirts"],

"image" : "http://www.mystore.com/images/redshirt.jpg",

"thumbnail" : "http://www.mystore.com/thumbs/redshirt.jpg",

"url" : "http://www.mystore.com/red-shirt.html",

"in_stock" : true,

"rating" : 4.2,

"brand" : "Volcom",

"color" : "Red",

"popularity" : 7

},{

"product_id": "3",

"name" : "Green Adidas Shoes",

"price" : 49.99,

"categories" : ["Shoes", "Sale"],

"image" : "http://www.mystore.com/images/greenshoes.jpg",

"thumbnail" : "http://www.mystore.com/thumbs/greenshoes.jpg",

"url" : "http://www.mystore.com/green-shoes.html",

"in_stock" : false,

"rating" : 5,

"brand" : "Adidas",

"color" : "Green",

"popularity" : 10

}]

}

Update

Updates partially update an existing product record. Examples include updating the price of an item and marking a product as out of stock.

Request URL

https://[Site ID]:[Secret Key]@api.searchspring.net/api/index/update.json [POST]

Site ID: The identifier for your site. It can be found on the My Account page of the SearchSpring Management Console.

Secret Key: The secret key for your live indexing API. Do not share this. Please contact [email protected] for your secret key.

Request Body

The request body should be a JSON encoded string with the following attributes.Note there is a 3MB limit on the size of the request body. If you wish to update more products than will fit in 3MB, you will need to split your products up into multiple batches.

feedId: The identifier for your data feed. Please contact [email protected] for your Feed ID.

records: An array of objects representing items in your SearchSpring search database that you wish to update. Each record must include your SearchSpring ID field. You may update more than one field at a time. See example below.

Example:

{

"feedId": 42,

"records": [{

"product_id": "1",

"price": 79.99,

"in_stock" : true

},{

"product_id": "2",

"price": 149.99,

"in_stock" : false

}]

}

Delete

Deletes products from the SearchSpring search database. This uses the same endpoint as the Upsert command, but uses the DELETE HTTP method instead of POST.

Request URL

https://[Site ID]:[Secret Key]@api.searchspring.net/api/index/upsert.json [DELETE]

Site ID: The identifier for your site. It can be found on the My Account page of the SearchSpring Management Console.

Secret Key: The secret key for your live indexing API. Do not share this. Please contact [email protected] for your secret key.

Request Body

The request body should be a JSON encoded string with the following attributes.Note there is a 3MB limit on the size of the request body. If you wish to delete more products than will fit in 3MB, you will need to split your products up into multiple batches.

feedId: The identifier for your data feed. Please contact [email protected] for your Feed ID.

records: An array of IDs of the products in the SearchSpring search database that you wish to delete. These must match the values in your SearchSpring ID field. You may delete more than one product at a time. See example below.

Example:

{

"feedId": 42,

"records": ["1","2","3"]

}

Use Cases & Caveats

(From Jake)

At the moment, live indexing should only be used for updating the index in between bulk runs. So just as long as a bulk feed is still the primary way to index data, and a client is providing their own data for things that we usually attach in a supplemental fashion (google analytics, external feeds), on that same feed, then live indexing is able to be used.

Requirements

Full record live indexing upserts:

Always have a bulk feed available for indexing. Cant be a url to the original feed that never gets updated

All live indexing request data from client, should be included in next bulk feed

Cant have supplemental feeds (ga doc filter; external fields doc filter; any review/rating doc filter). This data would need to already be in their bulk feed

Partial live indexing updates:

All the above

No doc filter(s) that requires data. In general its just safer to have no dock filters, but it is possible for certain doc filters to behave in a manner to allow partial updates.

Caveats:

Live indexing endpoints only acknowledge when data is successfully queued, which doesnt mean much from the clients perspective. There is no guarantee that the requests will be indexed (even eventually). There is no way for a client to know if a request indexed, and no way for them to see error messages or reasons. We of course are able to do this through sumo, but currently its a manual process.

Even when requests are successfully indexed, there is no guarantee of order of operation. (exception: newer data for the same record already in queue, will always replace older da

If there is some problem on our side, and requests which should have succeeded, but did not because of infrastructure issues, those request are lost. (thus the requirement for a recently updated bulk feed)

It probably sounds unreasonable to just stop advertising live indexing . but with the requirements/caveats, its usually only fit for those clients that have the ability to keep their feed up-to-date, and the ability to provide all their own data, without our features that join it for them.

The following instructions outline the process of installing the new Magento module (extension).

Table of Contents

Install by direct download via Magento Connect Manager

Setup the SearchSpring Magento Module

Configure SearchSpring Management Console

Install by direct download via Magento Connect Manager

If you're installing our Module on a Dev Store which has Basic Authentication enabled, the path to /searchspring/generate/feed must be removed from your password protection. And if your Dev Store is IP-restricted, be sure to whitelist our SearchSpring VPN, Indexing Servers, and all SearchSpring VPC IPs; see SearchSpring IP Addresses

1. Log in to your Magento Connect Manager

2. Download package

Download the SearchSpring_Manager package from our CDN http://a.cdn.searchspring.net/magento/SearchSpring_Manager-latest.tgz

3. Upload package file

Drag and drop the file or click "Choose File" and browse to the downloaded file.

4. Click "Upload"

5. Done!

If you see this message, you've completed this successfully.

Setup the SearchSpring Magento Module

You will need a SearchSpring Management Console (SMC) user and website setup first.

1. Configuration

From the Magento admin top menu, go to "System > Configuration"

2. Manager Settings

Scroll down to SearchSpring and click "Manager Settings"

3. Username & Password

Type in your SearchSpring username and password

4. Authentication Method

We recommend using Simple Authentication, but for the newest versions of Magento, you may use theOAuth as the authentication method

5. Select Website

Select your Website and Feed and click "Connect"<

6. Accept OAuth

If you chose OAuth, read the notice and accept if you are comfortable.

7. Tweak Settings (Optional)

OK with the defaults (e.g. live indexing enabled)? Or change them to your needs.

Configure SearchSpring Management Console

1. Go to the Data Feed page

Go to the Data Feed page in the SearchSpring Management Console.

2. Select "Magento"

Select "Magento" under "Select Your Platform"

3. Set Feed URL

Set the "Data Feed Location > URL" as:

http://[YOUR_DOMAIN_NAME_HERE]/media/searchspring/feed/searchspring_[YOUR_STORE_VIEW_CODE_HERE].xml

The "media/searchspring/feed/" segment is the default, but must match what is configured in Magento if it's been modified.

4. Regeneration Settings

Set the "Regenerate Data Feed Before Update > URL" as:

http://[YOUR_DOMAIN_NAME_HERE]/searchspring/generate/feed?store=[YOUR_STORE_VIEW_CODE_HERE]&start=@offset&filename=@filename

5. Make sure to Save!

This section of the dashboard shows you a broad overview of your site's search performance, conveniently visualized ineasy to digest metrics.Site Search Impact is driven by your site's Google Analytics data, and is not accessible until you connect your site's Google Analytics account to SearchSpring.

Impact Summary

The first thing you'll see is a paragraph summary that explains an overview of your site's searchanalytics. The metrics explained here are also visualized in the rest of the Impact section.

Shoppers Who Use Search

This segment shows you a high-level comparison of how your site performs when your shoppers use search versus when they don't. Each piece is calculated like so:

More Likely to Purchase:Conversion (with search) / Conversion (without search)Conversion here is calculated as Transactions / Sessions (Visits)

More Spent on Purchases:Average Order Value (with search) /Average Order Value (without search)Average Order Value is calculated as Revenue / Transactions

More Valuable: Per Session Value (with search) / Per Session Value (without search)Per Session Value here is calculated as Revenue / Sessions (Visits)

Visits

This segment can be used to giveyou an idea of how often your shoppers use site search during their visits (or "Sessions") on your site. The numbers below thechart show a breakdown of the number of sessions where shoppers used site search, and how many sessions where they did not.

Calculation: Sessions where search was used / Total sessions

Orders

The Orders segment illustrates how often theshoppers that convert on your site use search. The numbers below the chart show a breakdown of the number of transactions that occurred after using search, and how many transactions occurred without using search.

Calculation: Number of transactions where a shopper used search/ Total transactions

Revenue

This segment can be used to gauge how much your shoppers are spending after using search. The numbers below the chart show a breakdown of how much revenue was gained from transactions where shoppers used search, and how much revenue was gained from transactions that didn't use search.

Calculation: Revenue from transactions where shoppers used search / Total revenue

Average Order Value (AOV)

This segment shows a breakdown of how the Average Order Value (calculated asRevenue / Transactions) compares between shoppers who use search before converting, and those who don't. You can use this metric to gaugethe ratio of how much more or less shoppers tend to spend on your site when usingsearch.

Calculation: Average Order Value (with search) / Average Order Value (without search)

Revenue Per Visit (RPV)

This segment shows a breakdown of how Per Session Value (calculated as Revenue / Sessions) compares the revenue to visitor ratio between shoppers who use search and those who don't.You can use this metric to determine the overall value of visitors who use search. A higher ratio number indicates a combined higher likelihood of searching customers to convert and/or spend more when they visit your store.

Calculation:Per Session Value (with search) / Per Session Value (without search)

Conversion Rate

This segment showsa breakdown of how Conversion (calculated as Transactions / Sessions) compares among shoppers who use search, and those who don't. This metric can be used to give you an idea of how likely searching customers are to complete a transaction after performing a search.

Calculation:Conversion (with search) / Conversion (without search)

Rich content can be added to a campaign page with Banners. To add or edit banners, go to the Banners toolbox.

See also: Changing Your Banners By Device

You can preview, edit, or remove any existing banner using the buttons to the right.

What dimensions are needed for my banner image?

The size of your banner image is entirely up to your desired outcome, and the code styling on your store. In most cases, banners span the whole width of a store's content (usually at least 1200 pixels wide), and automatically scale down on smaller devices.

If you are noticing any weird resizing issues that you or your team are unsure how to resolve, you can always reach out to our support team for additional assistance.

Creating a Banner

To add a new banner, click the "Add New Banner" button

A modal opens to guide you through the process and your options. You can choose between an image with an optional link attached to it, an embedded video, or custom HTML.For banner placement, you can select where on the page you'd like the banner to appear. Primary and Secondary banners appear at the top, Side beside the results, and the Footer banner will appear below your results.

Primary and Secondary banners are usually the same thing. Some SearchSpring sites have a custom setup that places these two banners types in different locations on the page, such as above and below pagination controls. Using different banner types can also be used to "stack" banners from different campaigns. For example, if your Default Campaign has a Primary banner and a specific campaign has a Secondary banner, both banners will appear on the page for the specific campaign. If they are both Primary banners, however, the specific campaign's banner will override the default campaign's banner.

You can preview any banner at any time while editing by clicking the image under Banner Preview, even HTML content.

When you're done, click "Add Banner" to complete it.

Previewing the layout

You can choose to preview all banners on the page or just focus on the products alone by toggling the Preview Banners button at the top right of the product grid.

You can also easily edit or remove an existing banner by hovering over the preview and selecting "Edit this banner" or "Remove"

Go to to the Index Status page in the SearchSpring Management Console.

On this page click the Update Indexbutton.

This will insert your site into our queue for re-indexing. Wait times can differ depending on the number of actively running indexes and the size of your index.

To read more about indexing, check out these articles:

Indexing 101

Index Status Page

This article is intended for SearchSpring users interested in managing the titles of their SearchSpring facets.

In the SearchSpring Management Console (SMC), navigate to 'Data > Data Settings > Field Settings'. You should see the following table that includes each field being provided to SearchSpring.

The first column contains the name of each field. The second column, titled 'Label', contains an input box in which you can insert the text for how you want that field to be displayed as a Facet, Sort option, or in Search Preview.

In this case, you can see that the 'collection_name' field has been labeled as 'Collection'.

Listing your internal user IPs allows SearchSpring to blockinternal user behavior from being recordedand skewing the search report data. Internal user queries are reported on the Overall Search Activity report

Save

Save your changes on the bottom of the page when you're done.

Note: You can add additional IP addresses by making a comma-separated list within a field. However, there is a 255 maximum character limit between all IP addresses.

Product Insights brings to light both high level and granular views of how your products are performing. With this powerful tool, youll gain visibility into product performance, how shoppers interact with your products, and suggested action steps to further optimize performance.

Product Insights brings to light both high level and granular views of how your products are performing. With this powerful tool, youll gain visibility into product performance, how shoppers interact with your products, and suggested action steps to further optimize performance. This reporting can be viewed up to two years back from the current date.

Top Products

At the top of the overview page, there are highlights showing the top Viewed, Grossing, and number of Transactions product for the selected timeframe.

Top Views

The product with the most views (in your currently selected date range) is highlighted at the top, as well as some other metrics such as Transactions and Conversion to easily compare it to your other top performers in this section.

Top Grossing

The product with the highest revenue generation (in your currently selected date range) is highlighted here.

Top Transactions

The product involved in the highest number of transactions (in your currently selected date range) is highlighted here.

Performance Quadrants

Below the highlights are the Performance Quadrants, which is a breakdown unique to SearchSpring that shows groups of products that are Underexposed, Overexposed, and Best Performers, with suggested action steps for each group. Is a product overexposed? Try checking for product page issues, or lower the price.

Quadrant: Underexposed

High conversion rate, but low exposure. Not many people see this product, but those who do purchase it consistently. Suggested Action - Merchandise: Increase exposure by promoting the product

Quadrant: Best Performers

High conversion rate and many views! A lot of people see this product, and many who do go on to purchase it. Suggested Action - Raise Price: Keep up the good work, and possibly consider raising the price on this high-demand product

Quadrant: Needs Attention

Low conversion rate and low views. Not many people see this product, and those who do don't typically buy it. Suggested Actions:

Merchandise: Increase exposure by promoting the product

Audit: Increase conversion by checking for page issues, or by lowering the price

Prune: Remove the product from Google search results to decrease product bloat

Quadrant: Overexposed

Low conversion rate, but many views. A lot of customers are seeing this product, but few want to buy it. Suggested Action - Audit: Increase conversion by checking for page issues, or by lowering the price

Product Name and SKU

Within a quadrant, you can view the name and SKU of each product below its image.

Conversion

Each product in a quadrant will show a high-level view of its conversion rate within your currently selected date range.

Views, Units Sold, and Revenue

Hovering over any product reveals some more granular details about its performance. You can click any product to get more info about its performance on the Product Insights Detail page.

Breakdown

Beyond the quadrants youll find the Breakdown table, which has highly detailed information about every touched product. From views to carts to revenue, there are many ways to breakdown, sort, filter, and analyze this raw information.

SKU

The SKU of the product for this row. You can click any SKU to get more info about its performance on the Product Insights Detail page.

Search

How many clicks for this product resulted from a customer searching on your site.

Nav

How many clicks for this product resulted from a customer browsing category navigation on your site.

SS Clicks

The total number of clicks from any SearchSpring-powered page.

Calculation: Search Clicks + Nav Clicks (the 2 columns to the left)

Non-SS

The total number of times this product was viewed, and not as a result from being clicked in a SearchSpring-powered page.

Calculation:Views - SS Clicks

Views

The total number of times this product was viewed during your selected date range. Requires IntelliSuggest view tracking to be installed on your site.

Exits

The difference between the number of Views a product had versus how many times it was added to someone's cart.

Calculation:Carts - Views

Carts

The number of times this product was added to someone's cart. Requires IntelliSuggest Cart tracking to be tracked on this report.

Abandons

The difference between the number of times this product was added to a cart versus how many times it was purchased.

Calculation: Transactions - Carts

Transactions

The total number of transactions this products was purchased in.

Conversion

The overall conversion rate of this product during your selected date range.

Calculation: Transactions Views

Units Sold

The total number of units sold of this product.

Avg Units Sold

The average number of units sold each time this product is purchased.

Calculation: Units Sold Transactions

Revenue

The total sales revenue generated from sales of this product during your selected date range.

Product Insights Detail Page

The Product Detail page shows an even more advanced breakdown of an individual products performance. Click here to learn more about the product insights detail page.

The Value

Revenue Insights is an entirely unique way of breaking down the way that your revenue relates to how users interact with SearchSpring on your store. This reportprovides the distinct value of showing you how much each SearchSpring feature contributes to purchases made by customers. It breaks down and attributes these numbers in a different way than Google Analytics does on your SearchSpring Dashboard in order to provide you with a viewinto SearchSpring revenue metrics.This reporting can be viewed up to two years back from the current date.

The basis of this report is how shoppersuse SearchSpring features before making a purchase. The final numbers relyon SearchSpring IntelliSuggest integration and the total store revenue numbers might vary from other reporting sources. This report is intended to highlight general patterns in SearchSpring usage relative to purchases.

How it's Done

We begin by looking at a customer's purchase. From there, we take a look back at all of the SearchSpring interactions that user had prior to making their purchase.

Once we've gathered all of the pre-purchase touch points, we sort them into buckets and count up how much percentage of each touch type (Search, Navigation, or Recommendation) occurred compared to the total of all touches. In the example pictured above, Search occurred2 times out of the4 total touches, so it counts for 50% of this purchase's touch points.

Then, we take the purchase amount ($40) and split it out by each touch point's percentage. Therefore, Search is attributed$20, which is 50% of the purchase price.

The Non-SearchSpring amount is only attributed value when there is a purchase that did nottouch SearchSpring features in any way. In this case, the entire purchase value is attributed to Non-SearchSpring. You can use the AOV (Average Order Value) on the Revenue page to determine if you're missing out on any potential Revenue by not having all of your purchases covered by SearchSpring features.

We go through this process on every single purchase reported to SearchSpring via IntelliSuggest tracking and accumulate the values foreach SearchSpring feature. Then we present you with the day's total values for each feature, for each day, on your site. You can see these daily values in the table at the bottom of Revenue Insights:

These daily values are also conveniently laid out in an area chart on this page to visually represent how much revenue each SearchSpring feature impactson your store:

The Zero Results report gives you a comprehensive viewinto the instances where someone searches for something on your store and no products are found. This report:

Gives you insight into what people are looking for that you don't have

Shows you common spelling mistakes

Guides you in creating synonyms forcommon zero-result terms to help reduce times where customers can't findany products

The remainder of this article shows you how to use this report.

Note: For performance reasons, this report is limited to the top 10,000 groups of queries (10,000 rows in the table)

Date Selection

The date selector at the top right of the page is used to change the range of dates for which you'd like to view details of this report.This reporting can be viewed up to two years back from the current date.

Chart

The chart shows you how many total zero-result searches were performed each day in your selected date range. With carefulfine-tuningof your store'sdata, creating synonyms, and using merchandising campaigns, this graph will ideally go down over time.

Total Unique Searches

This number shows the total number of zero-result searches for the entire duration of your selected date range.

Average Unique Searches / Day

This number shows the average number of zero-result searches per day for the duration of your selected date range.

Search Query

Shows you what the search query was that returned zero product results.

Background Filters

If your site has any custom Front-End Background Filters configured, you'll see which filters may have applied and/or had a potential role in causing zero results to appear for that search query.

Number of Unique Searches

The total number of searches for that specific term over the selected date range. The more commonly occurring terms should have more attention paid to them.

Actions

The final column of the table will show what Synonym action you can take for this query. If a synonym already exists for this query, there will be a link saying "Edit Synonym". If there is no existing synonym, there will be a link saying "Create Synonym". Visit the Synonyms article to learn more about managing these.

Table Tools

The table has various tools that allow you to easily navigate the data:

Show Per Page: At the top left, you can select how many rows per page you want to view on this table.

Search the table: You can filter the table to only show rows that contain certain terms by searching in the box at the top right.

Export:Clicking an export button at the top right allows you to save a CSV or XLS file of this table. The exported file will include all of the data, not just the table page being viewed.

Pagination:The pagination buttons at the bottom of the table allow you navigate through each page of the table.

SearchSpring offers a largevariety of Insights & Reporting features to best help you analyze a wide array of metrics. Use these reports to make better business decisions based on the behavior of your shoppers, sales performance specific to search queries or products, and much more.

All reporting can be viewed up to two years back from the current date.

Dashboard Reports

The dashboard reports provide high-level visualizations and breakdowns of your site search performance. They can be used to infer a wide variety of shopper behavioral statistics and can be leveraged to make valuable business decisions.

Learn more about Dashboard Reports here

Search Insights

Search Insights utilizes both SearchSpring and Google Analytics data to present important metrics breakdowns for searches performed on your site. You can use this report to analyze how shoppers are interacting with the various search queries on your site, and you can take action directly from this report.

Learn more about Search Insights here

Category Insights

Category Insights utilizes both SearchSpring and Google Analytics data to present important metrics breakdowns for each SearchSpring Category integration on your site. You can use this report to analyze how shoppers are interacting with the various SearchSpring-powered category pages on your site, and you can take action directly from this report.

Learn more about Category Insights here

Product Insights

Product Insights brings to light both high level and granular views of how your products are performing. With this powerful tool, youll gain visibility into product performance, how shoppers interact with your products, and suggested action steps to further optimize performance.

Learn more about ProductInsights here

Revenue Insights

Revenue Insights is an entirely unique way of breaking down the way that your revenue relates to how users interact with SearchSpring on your store. This report provides the distinct value of showing you how much each SearchSpring feature contributes to purchases made by customers.

Learn more about Revenue Insights here

Basic Reports

SearchSpring's Basic Reports offer a wide range of day-to-day analysis of specific metrics related to the activity and performance of your store.

Learn more about Basic Reportshere

SearchSpring's BasicReports offer a wide range of day-to-day analysis of specific metrics related to the activity and performance of your store.All reporting can be viewed up to two years back from the current date.

Overall Search Activity

The Overall Search Activity report gives you a broad overview of SearchSpring request activity on your store. It can be used to see not only how much traffic you're getting per day, but to break down which queries came from shoppers, search engines, or a custom group of IP addresses set by you.

For more details, check out the Overall Search Activity Report knowledge base article.

Searches

The Searches report shows how many searches occur on your store, andalso breaks down how popular each query is. This report is a valuable way to see what your shoppers are looking for, with a convenient link to merchandise each term.

For more details, check out the Searches Report knowledge base article.

Zero Result Searches

The Zero-Results report gives you a comprehensive view into the instances where someone searches for something on your store and no products are found. Using it can give you insight into what people want that you don't have, find common spelling mistakes, and guides you to create synonyms to improve results.

For more details, check out the Zero-Results Report knowledge base article.

Keywords

The Keywords report breaks down all of the searches on your store and identifies the most commonly occurring words. This can help you gain a more general feel for what kinds of things people typically look for on your site.

For more details, check out the KeywordsReport knowledge base article.

Filters

The Filters report provides a shopper-usage analysis of the Faceting Filters on your site. You can view whichfields (such as "color") are most often clicked by customers on a day-to-day basis, as well as what field-value sets (such as "color: red") are selected most often. This can be helpful for demographic analysis as well as refining your store's products based on customer demand.

For more details, check out the FiltersReport knowledge base article.

Sorts

Similarly to the Filters report, the Sorts report shows you what your shoppers are sorting products by after performing a search or when going to SearchSpring-powered category pages on your site. This report can help you identify what sorting metrics are most important to your customers.

For more details, check out the SortsReport knowledge base article.

Search Engine Indexing Activity

When a search engine such as Google is indexing your site to reference in its search results later, it will perform queries on your site. This report shows you how many SearchSpring queries are being performed, and which search engine performed them.

For more details, check out the Search Engine Indexing ActivityReport knowledge base article.

Referring Queries

The Referring Queries report can be used to find out how much traffic your store is getting as a result of people clicking on a search result in a search engine (such as Google). This report shows how many people clicked through from which search engine per day, as well as details the most common queries that were searched on the engine that resulted in the follow-through.

For more details, check out the Referring QueriesReport knowledge base article.

IntelliSuggest Events

The IntelliSuggest Events report shows you how many key interactions shoppers have had on your store, effectively giving you an overview of your site's conversion funnel on a day-to-day basis. The report breaks down the number ofsearch clicks, product views, cart views, and sales on your site.

For more details, check out the IntelliSuggest EventsReport knowledge base article.

Popular Searches w/ Secondary Matches

ThePopular Searches w/ Secondary Matches report shows you how many search queries had zero results and resulted in an automatic search downgrade each day in your selected date range.

For more details, check out the Popular Searches w/ Secondary Matches knowledge base article.

SearchInsights utilizes SearchSpring's search tracking data, while also analyzing some supplemental Google Analytics datato present important metrics breakdowns for searches performed on your site. You can use this report to analyze how shoppers are interacting with the various search queries on your site, and you can take action directly from this report.

Known Issues / Caveats

There are some cases where Google Analytics doesn't return all the data we ask for. We saw this in one case where Page Value was off because we weren't getting a specific casing of a search query from GA, even when maxing out the GA request limit.

Because we only fetch 5,000 rows of GA data, sometimes a specific casing with lower numbers of unique views may be dropped in our aggregations. Even if we increased it to Google's max of 10,000, this would sometimes happen.

dress (with 100 views) is row 1 of the data we get from GA

Dress (with 50 views) is row 4,900

DRESS (with 2 views) is row 5,002

While the actual number of searches for dress is 152, our report would only show it as having 150 because DRESS was beyond row 5,000 not given to us

DateRange

The date selector at the top right of the page is used to change the range of dates for which you'd like to view details of this report.This reporting can be viewed up to two years back from the current date.

Highlights

The Highlights section at the top of the page gives you a quick, high-level view of metrics related to your site search performance.

Popular Searches (What People Want)

Shows a quick summary of the most popular search queries on your site within the currently selected date range. The pie chart can be hovered over to see more details.

Top Grossing Searches (What People Spend)

Shows a quick summary of the search queries with the highest Page Value (See "Page Value" below) on your site within the currently selected date range. The pie chart can be hovered over to see more details.

Top Converting Searches (What People Buy)

Shows a quick summary of the highest-converting (see "Conversion" below) search queries on your site within the currently selected date range. The pie chart can be hovered over to see more details.

Search Terms Tree

The Search Terms Tree provides a valuable interactive way to explore the common associations that search terms have when shoppers are looking for products. Here you can infer how your customers typically infer words together, such as brands that are commonlysearched with theitem name. Exploring can also help to identify potential synonyms, common misspellings, and popular product type demand at a high level.

Jump to a popular search word

You can begin or change your exploration by selecting any of the top "popular search words" above the tree.

Interacting with the tree

The word in the center is the current reference point to focus on. Words branched to the left are those that are typed before the center word, such as "floral print". Words branched on the right are those typed afterwards, such as "print dress". You can click any of the branched words to make it the new focus point.

Breakdown

The breakdown tablegives you direct insight into your store's search history at a granular level. Here you can view specific analytics related to each search query.

Note:For performance, this report has data limits that only allow up to 5,000 results to be shown in this table. Because of how data is merged for presenting, it likely will usually be under 3,000 results.

Presets

There are a few helpful preset buttons above the table that configure the table into specific views that hides/shows various columns, and sorts some columns as well.

Search Query

The query that was searched for.

Requests

Requests can help you gauge how engaged shoppers are when searching for this query. It shows the total number of times a product set was requested by and shown to a shopper on this search results page. This includes when a shopper originally performed the search, as well as each time a shopper clicks a filter and changes pagination (goes to page 2 of results, etc).

Products

The number of products that were shown for this search query.

Total Unique Searches

The total number of sessions in which this query was searched. This excludes multiple searches on the same query during the same session. A unique search is counted once for each session thissearch wasperformedduring, regardless of how many times it was viewed during that session.Whether a single session included 1 search for this query or 20 searches, it will still count for a single Unique Search.

% Search Exits

The ratioofhow often this search querywas the lastpage a shopper viewedduring their session.This can be used to gauge the number of times shoppers endtheir browsing on this search query.

Calculation:Search Exits / Total Unique Searches

Time After Search

The average amount of time (in seconds) that shoppers spend on this search results page before moving to a different page.

Calculation:Search Duration / Total Unique Searches

Avg. Search Depth

The average number of pages people viewed after searching for this query.

Calculation:Search Depth / Total Unique Searches

Revenue

The total sale revenue (excluding shipping and tax) of transactions that occurred after searching for this query.

Transactions

The total number of transactions that occurred sometime shortly after a shopper searched this query. This can be used to gauge how likely someone searching for this query is to convert, when compared to Transaction numbers from other queries on this table.

Avg. Order Value

The average revenue of ecommerce transactions that occurred after searching for this query.

Calculation:Revenue / Transactions

Conversion Rate

The ratio of Transactions compared to Unique Page Views. This can be used to gauge how often a shopper makes a purchaseafter searching for this query.

Calculation: Transactions / Unique Page Views

Per Search Value

Each time a transaction occurs on your site, the page is identified that the purchasing shopper visited prior to making their purchase. The revenue from the transactionis then split out to each page that was viewed, effectively giving monetary credit to that page.

Per Search Value can be used to identify a search query'sfinancial influence by showing its share of revenue. Search querieswith higher Per Search Value have a higher tendency to be viewed by customers who eventually make higher purchases.

Calculation:Revenue / Unique Page Views

Actions

If you'd like to take some additional control over the behavior of a search results page, you can simply click the "Merchandise" link in the Actions column, which will take you directly to a campaign for that search.

If a campaign already exists for it, it will say "Edit Campaign" and take you to the existing campaign. If not, it will say "Create Campaign" and clicking it will create a new campaign for that search query.

Table Tools

The table has various tools that allow you to easily navigate the data:

Show Per Page: At the top left, you can select how many rows per page you want to view on this table.

Search the table: You can filter the table to only show rows that contain certain terms by searching in the box at the top right.

Show/Hide Columns (Gear):Clicking the gear icon at the top right allows you to select which columns you'd like to show or hide on the table, helping you to focus on what's important to you.

Export:Clicking an export button at the top right allows you to save a CSV or XLS file of this table. The exported file will include all of the data, not just the table page being viewed.

Pagination:The pagination buttons at the bottom of the table allow you navigate through each page of the table.

Category Insights utilizes both SearchSpring and Google Analytics data to present important metrics breakdowns for each SearchSpring Category integration on your site. You can use this report to analyze how shoppers are interacting with the various SearchSpring-powered category pages on your site, and you can take action directly from this report.

Category Insights will only appear if you are utilizing SearchSpring's Category Page installations, and if you have Search/Category Insights feature enabled. Contact your customer success representative for more information.

Date Range

The date selector at the top right of the page is used to change the range of dates for which you'd like to view details of this report.This reporting can be viewed up to two years back from the current date.

Page

Thename of the category page.

Requests

Requests can help you gauge how engaged shoppers are within a category. It shows the total number of times a product set was requested by and shown to a shopper on this category page. This includes when a shopper originally landed on the category, as well as each time a shopper clicks a filter, and changes pagination (goes to page 2 of results, etc).

Products

The number of products that are in acategory.

Pageviews

Page Views indicate the number of times a category page was loaded or refreshed in a shopper's browser. This count can includethe same shopper going to the categorymultiple times, or shoppers going one time.

This number will always be lower than (or equal to) the "Requests" column, since Requests include the original product listing load in addition to everyproduct set change after the page is loaded (such as clicking facets and pagination). Page Views simply counts when the pageitself loads in the browser.

Tip: You can determine the ratio of how much your shoppers are clicking on pagination/facets on this category by comparing the Page Views column to the Requests column.

Learn more about how Google Analytics calculates Page Viewshere.

Unique Pageviews

A unique page view is countedfor each visit this category was viewed during, regardless of how many times it was viewed during that visit. If a single visit included 1 view of this category or 20 views, it will still count for a single Unique Page View.

Learn more about how Google Analytics calculates Unique Page Viewshere.

Avg. Time on Page

The average amount of time (in seconds) that shoppers spend on this category page before moving to a different page.

Calculation:Total Time on Page / (Page Views - Exits)

Entrances

The number of times this category was the first page a shopper landed on during their session.This can be used to gauge the number of times shoppers begin their browsing on this category.

Entrances is a subset of Page Views, and can be compared to the Page Views column to determine theratio of how often thiscategory isthe first page a shopper landed on.

Learn more about how Google Analytics calculates Entrances here.

Bounce Rate

A "bounce" is when a shopper viewed this categoryonce, but didn't explore it any further.The "Bounce Rate" is the percentage of shoppers who landed on this category without exploring it further. A higher bounce rate indicates lower interaction from your shoppers on this category.

Learn more about how Google Analytics calculates Bounce Rate here.

% Exit

The ratioofhow often this category was the lastpage a shopper visited during their session.This can be used to gauge the number of times shoppers endtheir browsing on this category.

Calculation:Exits / Page Views

Learn more about how Google Analytics calculates Exit Ratehere.

Page Value

Each time a transaction occurs on your site, Google Analytics identifies the pages that the purchasing shopper visited prior to making their purchase. It then splits out the revenue from the transactionto each page that was viewed, effectively giving monetary credit to that page.

The Page Value metric can be used to identify a category's financial influence by showing its share of revenue. Category pages with higher Page Value have a higher tendency to be viewed by customers who eventually make higher purchases.

Learn more about how Google Analytics calculates Page Valuehere.

Actions

If you'd like to take some additional control over the behavior of a category page, you can simply click the "Merchandise" link in the Actions column, which will take you directly to a campaign for that category.

If a campaign already exists for it, it will say "Edit Campaign" and take you to the existing campaign. If not, it will say "Create Campaign" and clicking it will create a new campaign for that category.

Table Tools

The table has various tools that allow you to easily navigate the data:

Show Per Page: At the top left, you can select how many rows per page you want to view on this table.

Search the table: You can filter the table to only show rows that contain certain terms by searching in the box at the top right.

Show/Hide Columns (Gear):Clicking the gear icon at the top right allows you to select which columns you'd like to show or hide on the table, helping you to focus on what's important to you.

Export:Clicking an export button at the top right allows you to save a CSV or XLS file of this table. The exported file will include all of the data, not just the table page being viewed.

Pagination:The pagination buttons at the bottom of the table allow you navigate through each page of the table.

The Overall Search Activity report gives you a broad overview of SearchSpring request activity on your store. It can be used to see not only how much traffic you're getting per day, but to break down which queries came from shoppers, search engines, or a custom group of IP addresses set by you.

Date Range

The date selector at the top right of the page is used to change the range of dates for which you'd like to view details of this report.

Chart

The chart shows you how many total search queries were performed each day in your selected date range. You can hover over the graph to see a detailed breakdown of each day, and you can click the legend items to disable or enable a metric from showing on the chart. The chartis broken down to identify how much traffic was from Shoppers (User Queries), Search Engines, and Internal Users. More details on those segments below.

Total Queries

This number shows the total number of search queries for the entire duration of your selected date range.

Total User Queries

Users are normal shoppers visiting your site. This number shows the total number of search queries from your shoppers, as well as its overall percentage of all search queries.

Total Internal User Queries

Internal Users are any searches from computers with any of the IP addresses that are configured on your Advanced Settings page. You can use this to identify employees of your company, developers, or any other segment of users that you know the IP address for.

This number shows the total number of search queries from these users, as well as its overall percentage of all search queries. If you don't have any IP addresses set up in Advanced Settings, this number will be 0.

Total Search Engine Queries

This number shows the total number of search queries from search engines while indexing your site, as well as its overall percentage of all search queries.

The Searches report shows how many searches occur on your store, andalso breaks down how popular each query is. This report is a valuable way to see what your shoppers are looking for, with a convenient link to merchandise each term.

Note: For performance reasons, this report is limited to the top 10,000 groups of queries (10,000 rows in the table)

Date Range

The date selector at the top right of the page is used to change the range of dates for which you'd like to view details of this report.This reporting can be viewed up to two years back from the current date.

Chart

The chart shows you how many uniquesearch queries were performed each day in your selected date range.This chart is helpful in measuring the varianceof what people are searching for each day. The greater the number, the more varied the terms that people are searching for.

Total Unique Searches

This number shows the total number of uniquesearch queries for the entire duration of your selected date range.

Average Unique Searches / Day

This number shows the average number of unique search queries per day for the duration of your selected date range.

Search Query (similar queries combined)

The unique search query value. Similar search queries are grouped together to help better identify trends in what people are searching for.

Number of Unique Searches

The total number of searches for that specific queryover the selected date range. The more commonly occurring terms should have more attention paid to them.

Actions

The Actions column provides helpful links that will allow you to go directly to a merchandising campaign for this search query. If a campaign for one already exists, it will take you to the existing campaign. If not, it will automatically create a new campaign for you based on the term.

Table Tools

The table has various tools that allow you to easily navigate the data:

Show Per Page: At the top left, you can select how many rows per page you want to view on this table.

Search the table: You can filter the table to only show rows that contain certain terms by searching in the box at the top right.

Export:Clicking an export button at the top right allows you to save a CSV or XLS file of this table. The exported file will include all of the data, not just the table page being viewed.

Pagination:The pagination buttons at the bottom of the table allow you navigate through each page of the table.

The Keywords report breaks down all of the searches on your store and identifies the most commonly occurring words. This can help you gain a more general feel for what kinds of things people typically look for on your site.

Note: For performance reasons, this report is limited to the top 50,000 keywords.

Date Range

The date selector at the top right of the page is used to change the range of dates for which you'd like to view details of this report.This reporting can be viewed up to two years back from the current date.

Chart

The chart shows you how many unique wordswere included in search querieseach day in your selected date range. Higher numbers on this chart indicate a greatervariancein individual words that occur within search queries.

Total Unique Keyword Searches

This number shows the total number of unique search words for the entire duration of your selected date range.

Average Unique Keyword Searches / Day

This number shows the average number of unique search wordsper day for the duration of your selected date range.

Keyword (similar terms combined)

The unique search query word. Similar words are grouped together to help better identify trends in what people are searching for.

Number of Unique Searches

The total number of searches that included this search word over the selected date range. The more commonly occurring terms should have more attention paid to them.

Table Tools

The table has various tools that allow you to easily navigate the data:

Show Per Page: At the top left, you can select how many rows per page you want to view on this table.

Search the table: You can filter the table to only show rows that contain certain terms by searching in the box at the top right.

Export:Clicking an export button at the top right allows you to save a CSV or XLS file of this table. The exported file will include all of the data, not just the table page being viewed.

Pagination:The pagination buttons at the bottom of the table allow you navigate through each page of the table.

The Filters report provides a shopper-usage analysis of the Faceting Filters on your site. You can view whichfields (such as "color") are most often clicked by customers on a day-to-day basis, as well as what field-value sets (such as "color: red") are selected most often. This can be helpful for demographic analysis as well as refining your store's products based on customer demand.

Note: For performance reasons, this report is limited to the top 10,000 filters.

Date Range

The date selector at the top right of the page is used to change the range of dates for which you'd like to view details of this report.This reporting can be viewed up to two years back from the current date.

Chart

The chart shows you how many of each facet filter were selected by your shoppers each day in your selected date range. You can hover over the graph to see a detailed breakdown of each day, and you can click the legend items to disable or enable a metric from showing on the chart.

Total Filters / Refinements

This number shows the total number of filters clickedfor the entire duration of your selected date range.

Average Filters / Refinements per Day

This number shows the average number of filters clicked per day for the duration of your selected date range.

Filter Summary

The Filter Summary table gives a high-level overview of how many of each filter type (eg. "color") was clicked over your selected date range.

Field

The Field column in this table shows the filter field name that was selected by shoppers.

Total

The Total column in this table shows the total number of times that this filter field was selectedby shoppers over your selecteddate range.

Breakdown

The Breakdown table offers a deeper analysis by showing every occurrence of both field and value (eg: "color: red").

Field

The Field column in this table shows the filter field name that was selected by shoppers.

Value

The Value column in this table shows which value within this field was selected by shoppers.

Total

The Total column in this table shows the total number of times that this filter/value combination was selectedby shoppers over your selecteddate range.

Table Tools

The table has various tools that allow you to easily navigate the data:

Show Per Page: At the top left, you can select how many rows per page you want to view on this table.

Search the table: You can filter the table to only show rows that contain certain terms by searching in the box at the top right.

Export:Clicking an export button at the top right allows you to save a CSV or XLS file of this table. The exported file will include all of the data, not just the table page being viewed.

Pagination:The pagination buttons at the bottom of the table allow you navigate through each page of the table.

The Sorts report shows you what your shoppers are sorting products by after performing a search or when going to SearchSpring-powered category pages on your site. This report can help you identify what sorting metrics are most important to your customers.

Date Range

The date selector at the top right of the page is used to change the range of dates for which you'd like to view details of this report.This reporting can be viewed up to two years back from the current date.

Chart

The chart shows you how many sorts clickedby shoppers each day in your selected date range.

Total Sortings

This number shows the total number of sorts clickedby shoppersfor the entire duration of your selected date range.

Average Sortings per Day

This number shows the average number of sorts clickedby shoppers per day for the duration of your selected date range.

Sorting

The name of the Sort that was clicked.

Total

The total number of times that sort was clicked over your currently selected date range. A blank sort indicates that a default sort was applied.

IntelliSuggesttracking is the data that SearchSpring uses to power IntelliSuggest elevations as well as several powerful insights features. You can use this report to view high-level traffic and behavioral trends across your entire site, and it can also be used as a day-by-day sales conversion funnel.

By default, Click tracking is installed on your site during your initial site setup integration with SearchSpring. The other 3 tracked metrics (Views, Carts, and Sales) need to be installed separately to enable more powerful SearchSpring features.

Date Range

The date selector at the top right of the page is used to change the range of dates for which you'd like to view details of this report. This reporting can be viewed up to two years back from the current date.

Chart

The chart gives an overview visualization of how many of each metric was logged each day within your selected date range.

Product Views

The total number of times a product page on your site was viewed within your selected date range.

Product Views shows all of a product's views from any source, including SearchSpring-powered listing clicks,direct links from social media, search engines, and other hard links on your website.

Cart Views

The total number of times a cart page was viewed on your site was viewed within your selected date range.

Sales

The total number of completed saleson your site within your selected date range. This is tracked on the order success page of your site.

Search Result Clicks

The total number of times a product was clicked from a SearchSpring-powered product listing. This differs from Product Views in that it only counts the product views that originated from SearchSpring-powered features.

The Health Status widgets at the top of the dashboard show a quick view into the status of your store's three most important data connections: Indexing, Google Analytics, and IntelliSuggest.Helpful detail text can be seen below many of the widget titles, and clicking a widgetlinks to a page to dive deeper into that connection. These widgets will also alert youwhen something needs your attention.

Indexing

The indexing health status shows a quick view of the current status of your store's data synchronization with SearchSpring. It also provides a brief summary of the last time it was successfully indexed. If there is an error, has never been indexed, or needs attention, this widget will alert you to it. You can click this widget to go to the Index Status page.

Google Analytics

The Google Analytics health status shows a quick view of your connection status to Google Analytics. If there is an error or is not connected, it will alert you to the situation. You can click this widget to go to the Google Analytics setup page, where you can fix any issues or modify your connection.

IntelliSuggest

The IntelliSuggest health status shows a quick view of IntelliSuggest tracking on your store. If your tracking seems to be out of date, isn't set up, or is missing pieces, this widget will alert you to the situation. You can click this widget to go to the IntelliSuggest Events Report to further explore / troubleshoot your tracking data.

For most SearchSpring sites, we requireevery search term to be found in a product's searchable data to show in results -- this is to ensure the best relevancy. This practice is called "strict search". In some cases, sites can break this rule when there would be zero search results, and instead fall back in these cases to use a "loose search", in which at least onesearched word must be found in a product, but not all.

The feature that falls back to a loose search only when there are zero results for the original search is called Automatic Search Downgrade, and the Popular Searches w/ Secondary Matches report shows how often that occurs on your site. If you don't have it enabled, this report will be empty.

Searches that couldn't find any products even after downgraded to a loose search do notappear on this report.

If you're interested in getting Automatic Search Downgrade on your site, please contact your customer success representative.

Date Range

The date selector at the top right of the page is used to change the range of dates for which you'd like to view details of this report.This reporting can be viewed up to two years back from the current date.

Chart

The chart shows you how many search queries had zero results and resulted in an automatic search downgrade each day in your selected date range.

This chart is helpful to measure how often your shoppers are being given more vague results than their original search term. If this is consistently high, that could mean you should consider:

Adding synonyms for some of the words in the table below the chart

Adding some more of the terms to your searchable product data from the table below the chart

Total Downgraded Searches

This number shows the total number of downgraded searches for the duration ofyour selected date range.

Average Downgraded Searches / Day

This number shows the average number of downgrades searches per day for the duration of your selected date range.

Downgraded Query column

The query that in itself would return zero results, and so was downgraded.

Total Downgraded Searches column

The total number of downgraded searches for this query during your selected date range.

The Product Detail page shows an even more advanced breakdown of an individual products performance.

Date Range

The date selector at the top right of the page is used to change the range of dates for which you'd like to view details of this report.This reporting can be viewed up to two years back from the current date.

Product Highlights

The highlights show which quadrant it lands in with its associated actions, the total revenue and conversion rate.

Basic Product Info

At the top right you'll see the product's name, a link to the product on your site, its SKU, and current price.

Performance Status

To the right of the basic info you'll see a summary of how this product is performing, which correlates with which quadrant it lies in from the Product Insights page.

Conversion Rate

The overall conversion rate for this product, including details on Sales/Views, can be viewed to the right

Total Revenue

At the far right is the total revenue generated by this product within the currently selected date range, including information on how many sales it was in.

Transaction Funnel

Next youll find the Transaction Funnel, which visualizes the rate at which shoppers click, view, add to cart, and purchase this product.

Clicks from SearchSpring

The total number of clicks from any SearchSpring-powered page.

External Clicks

The total number of times this product was viewed, and not as a result from being clicked in a SearchSpring-powered page.

Views

The total number of times this product was viewed during your selected date range. Requires IntelliSuggest view tracking to be installed on your site.

Carts

The number of times this product was added to someone's cart. Requires IntelliSuggest Cart tracking to be tracked on this report.

% Saved:Carts Views Exits:Carts - Views

Transactions

The total number of transactions this products was purchased in.

% Saved:Transactions Carts Abandons:Transactions - Carts

Device Usage

Device Usage highlights how people interacted with your product on phones, tablets, and desktop computers.

Device Metric

Use the dropdown at the top of the Device Usage section to choose which metric you'd like to view a breakdown by device for - such as Views, Clicks, Carts, and more.

Trends

The Trends graph shows the performance of various metrics over time.

Trending Metric

Use the dropdown at the top of the Trends section to choose which metric you'd like to view a breakdown over time for - such as Views, Clicks, Carts, and more.

Search History

At the bottom of this page youll find the Search History, which shows all of the search queries that shoppers used to get to this product.

Query

The query which a customer searched to find and click on this product.

Position

The position of the product in the list of product results from the search. "1" means it was the first product shown, "2" is the second, and so on.

Page #

The page this product was on when it was clicked in the search results.

Total Results

The total number of results that came back for this search query.

Occurrences

The number of times this product was clicked as a result of this query within your selected date range.

Referrers

In addition, there is a Referrers table, which shows where all shoppers came from, and how often be it Facebook, Google results, or SearchSpring.

URL

The URL that a customer came from in order to reach this product page. URLs that begin with "/" are URLs from your own site.

Occurrences

The number of times a customer reached this product page from the specified URL within your selected date range.

Spelling Correction has some great affects on helping your customers while searching on your store. This report helps you to understand what the most common spelling errors are, both in general and in different groups such as device type and over time.

DateRange

The date selector at the top right of the page is used to change the range of dates for which you'd like to view details of this report.This reporting can be viewed back to as early as October 16th, 2019.

Highlights

The Highlights section at the top of the page gives you a quick, high-level view of metrics related to spell correction's performance.

Total Corrections

The total number of times that SearchSpring corrected a misspelling.

Unique Corrections

The number of unique individual queries that were corrected.

Device Metrics

Device Breakdown

The amount of times a misspelling was corrected on different devices.

Top Corrections by Device

The most common misspellings that were corrected on each type of device.

Number of Corrections (Over time)

The total number of corrections made over a period of time.

Breakdown

A detailed breakdown of each correction made.

Filter by Device type

Use the filter buttons here to change the data in the table to only show corrections made on the specific device type selected.

Original

What was originally typed in the search box by the shopper.

Corrected

What the search was corrected it to at the time the shopper hit Enter.

Corrections

The number of times this specific correction occurred during the currently selected time period.

The following is a JSON Data Sample of 20 products, containing the required data fields of a very typical implementation:

Download searchspring.json

{"Product ID":7631,"SKU":"HEH-9133","Name":"On Cloud Nine Pillow","Product URL":"https://www.domain.com/product/heh-9133","Price":24.99,"Retail Price":24.99,"Thumbnail URL":"https://www.domain.com/images/heh-9133_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Home>Home Decor>Pillows|Back In Stock","Category ID":"298|511","Brand":"FabDecor","Child SKU":"","Child Price":"","Color":"White","Color Family":"White","Color Swatches":"","Size":"","Shoe Size":"","Pants Size":"","Occassion":"","Season":"","Badges":"","Rating Avg":4.2,"Rating Count":8,"Inventory Count":21,"Date Created":"2018-03-03 17:41:13"}

{"Product ID":7615,"SKU":"HEH-2245","Name":"Simply Sweet Blouse","Product URL":"https://www.domain.com/product/heh-2245","Price":42,"Retail Price":59.95,"Thumbnail URL":"https://www.domain.com/images/heh-2245_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Clothing>Tops>Blouses|Clearance|Tops On Sale","Category ID":"285|512|604","Brand":"Entity Apparel","Child SKU":"HEH-2245-RSWD-SM|HEH-2245-RSWD-MD|HEH-2245-THGR-SM|EH-2245-THGR-MD|HEH-2245-DKCH-SM|HEH-2245-DKCH-MD","Child Price":"42|59.99","Color":"Rosewood|Thyme Green|Dark Charcoal","Color Family":"Red|Green|Grey","Color Swatches":"[{\"color\":\"Rosewood\", \"family\":\"Red\", \"swatch_hex\":\"#65000b\", \"thumbnail\":\"/images/heh-2245-rswd-sm_600x600.png\", \"price\":42}, {\"color\":\"Thyme Green\", \"family\":\"Green\", \"swatch_img\":\"/swatches/thyme_green.png\", \"thumbnail\":\"/images/heh-2245-thgr-sm_600x600.png\", \"price\":59.99}, {\"color\":\"Dark Charcoal\", \"family\":\"Grey\", \"swatch_hex\":\"#36454f\", \"thumbnail\":\"/images/heh-2245-dkch-sm_600x600.png\", \"price\":59.99}]","Size":"Small|Medium","Shoe Size":"","Pants Size":"","Occassion":"","Season":"Summer|Spring","Badges":"Exclusive|Clearance","Rating Avg":4.5,"Rating Count":10,"Inventory Count":8,"Date Created":"2018-03-20 22:24:21"}

{"Product ID":8100,"SKU":"WKS-6016","Name":"Uptown Girl Blouse","Product URL":"https://www.domain.com/product/wks-6016","Price":58,"Retail Price":89.95,"Thumbnail URL":"https://www.domain.com/images/wks-6016_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Clothing>Tops>Blouses","Category ID":285,"Brand":"Entity Apparel","Child SKU":"WKS-6016-CORD-MD|WKS-6016-KEGR-MD","Child Price":"","Color":"Coral Red|Kelly Green","Color Family":"Red|Green","Color Swatches":"[{\"color\":\"Coral Red\", \"family\":\"Red\", \"swatch_img\":\"/swatches/coral_red.png\", \"thumbnail\":\"/images/wks-6016-cord-md_600x600.png\", \"price\":58}, {\"color\":\"Kelly Green\", \"family\":\"Green\", \"swatch_img\":\"/swatches/kelly_green.png\", \"thumbnail\":\"/images/wks-6016-kegr-md_600x600.png\", \"price\":58}]","Size":"Medium","Shoe Size":"","Pants Size":"","Occassion":"","Season":"Summer|Spring","Badges":"Exclusive","Rating Avg":4.2,"Rating Count":11,"Inventory Count":9,"Date Created":"2018-03-16 21:55:28"}

{"Product ID":6489,"SKU":"DKO-PROF","Name":"Knock Your Socks Off Lace-Up Heels","Product URL":"https://www.domain.com/product/dko-prof","Price":38,"Retail Price":60,"Thumbnail URL":"https://www.domain.com/images/dko-prof_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Shoes>Heels>Lace-Up Heels|Featured Products|Shoes On Sale","Category ID":"310|719|605","Brand":"Spark Collective","Child SKU":"DKO-PROF-BLK-5|DKO-PROF-BLK-5.5|DKO-PROF-BLK-6|DKO-PROF-BLK-7|DKO-PROF-BLK-7.5","Child Price":"","Color":"Black","Color Family":"Black","Color Swatches":"","Size":"","Shoe Size":"5|5.5|6|7|7.5","Pants Size":"","Occassion":"","Season":"","Badges":"Featured","Rating Avg":4.9,"Rating Count":4,"Inventory Count":19,"Date Created":"2018-02-28 23:37:28"}

{"Product ID":7732,"SKU":"HEH-2172","Name":"My Cup of Tea Sweater","Product URL":"https://www.domain.com/product/heh-2172","Price":68,"Retail Price":68,"Thumbnail URL":"https://www.domain.com/images/heh-2172_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Clothing>Tops>Sweaters","Category ID":277,"Brand":"Enigma Clothes","Child SKU":"HEH-2172-WHT-MD|HEH-2172-WHT-LG","Child Price":"","Color":"White","Color Family":"White","Color Swatches":"","Size":"Medium|Large","Shoe Size":"","Pants Size":"","Occassion":"","Season":"Winter","Badges":"","Rating Avg":4.6,"Rating Count":22,"Inventory Count":3,"Date Created":"2018-03-01 20:18:20"}

{"Product ID":7609,"SKU":"HEH-2211","Name":"Walk On Out Slip On Sneakers","Product URL":"https://www.domain.com/product/heh-2211","Price":34.99,"Retail Price":34.99,"Thumbnail URL":"https://www.domain.com/images/heh-2211_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Shoes>Sneakers>Slip-On Sneakers","Category ID":302,"Brand":"Temptation","Child SKU":"HEH-2211-BSQ-6|HEH-2211-BSQ-7|HEH-2211-BSQ-8|HEH-2211-BSQ-9|HEH-2211-BSQ-10|HEH-2211-BSQ-10.5","Child Price":"","Color":"Bisque","Color Family":"Beige","Color Swatches":"","Size":"","Shoe Size":"6|7|8|9|10|10.5","Pants Size":"","Occassion":"","Season":"","Badges":"","Rating Avg":3.9,"Rating Count":5,"Inventory Count":2,"Date Created":"2018-03-20 22:15:34"}

{"Product ID":7675,"SKU":"DKO-CAMEL","Name":"Warm Hearts Sweater","Product URL":"https://www.domain.com/product/dko-camel","Price":54.49,"Retail Price":54.49,"Thumbnail URL":"https://www.domain.com/images/dko-camel_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Clothing>Tops>Sweaters|Back In Stock|Featured Products","Category ID":"277|511|719","Brand":"Legacy Apparel","Child SKU":"DKO-CAMEL-GRY-SM","Child Price":"","Color":"Grey","Color Family":"Grey","Color Swatches":"","Size":"Small","Shoe Size":"","Pants Size":"","Occassion":"","Season":"Winter","Badges":"Featured|Free Shipping","Rating Avg":5,"Rating Count":2,"Inventory Count":20,"Date Created":"2018-03-19 20:53:04"}

{"Product ID":7463,"SKU":"WKS-5026","Name":"Silver Lining Dress","Product URL":"https://www.domain.com/product/wks-5026","Price":62,"Retail Price":62,"Thumbnail URL":"https://www.domain.com/images/wks-5026_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Dresses>Formal Dresses|All Dresses","Category ID":"220|201","Brand":"Temptation","Child SKU":"WKS-5026-GRNP-XS|WKS-5026-GRNP-SM|WKS-5026-GRNP-MD","Child Price":"","Color":"Green Print","Color Family":"Green","Color Swatches":"","Size":"X-Small|Small|Medium","Shoe Size":"","Pants Size":"","Occassion":"Formal","Season":"","Badges":"","Rating Avg":5,"Rating Count":9,"Inventory Count":0,"Date Created":"2018-03-01 19:59:05"}

{"Product ID":7677,"SKU":"PCH-8738","Name":"Follow The Beat Sneakers","Product URL":"https://www.domain.com/product/pch-8738","Price":32,"Retail Price":32,"Thumbnail URL":"https://www.domain.com/images/pch-8738_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Shoes>Sneakers>Slip-On Sneakers","Category ID":302,"Brand":"Fusion Fashion","Child SKU":"PCH-8738-GRY-8|PCH-8738-GRY-9|PCH-8738-BLK-8|PCH-8738-BLK-9|PCH-8738-LEP-8|PCH-8738-LEP-9","Child Price":"","Color":"Grey|Black|Leopard","Color Family":"Grey|Black|Multi","Color Swatches":"[{\"color\":\"Grey\", \"family\":\"Grey\", \"swatch_hex\":\"#d3d3d3\", \"thumbnail\":\"/images/pch-8738-gry-8_600x600.png\", \"price\":32}, {\"color\":\"Black\", \"family\":\"Black\", \"swatch_hex\":\"#000000\", \"thumbnail\":\"/images/pch-8738-blk-8_600x600.png\", \"price\":32}, {\"color\":\"Leopard\", \"family\":[\"Black\",\"Multi\"], \"swatch_img\":\"/swatches/leopard.png\", \"thumbnail\":\"/images/pch-8738-lep-8_600x600.png\", \"price\":32}]","Size":"","Shoe Size":"8|9","Pants Size":"","Occassion":"","Season":"","Badges":"","Rating Avg":4.5,"Rating Count":1,"Inventory Count":8,"Date Created":"2019-01-31 16:24:09"}

{"Product ID":8099,"SKU":"PCH-8475","Name":"Cup of Joe Pillow","Product URL":"https://www.domain.com/product/pch-8475","Price":36,"Retail Price":36,"Thumbnail URL":"https://www.domain.com/images/pch-8475_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Home>Home Decor>Pillows","Category ID":298,"Brand":"FabDecor","Child SKU":"","Child Price":"","Color":"Seafoam Green","Color Family":"Green","Color Swatches":"","Size":"","Shoe Size":"","Pants Size":"","Occassion":"","Season":"","Badges":"","Rating Avg":4,"Rating Count":1,"Inventory Count":18,"Date Created":"2018-02-28 19:03:26"}

{"Product ID":7425,"SKU":"BCO-SK101","Name":"Burst Your Bubble Denim Jacket","Product URL":"https://www.domain.com/product/bco-sk101","Price":84,"Retail Price":110,"Thumbnail URL":"https://www.domain.com/images/bco-sk101_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Clothing>Tops>Jackets|Clearance|Tops On Sale","Category ID":"279|512|604","Brand":"Zigzag Clothing","Child SKU":"BCO-SK101-WSDM-LG","Child Price":"","Color":"Washed Denim","Color Family":"Denim","Color Swatches":"","Size":"Large","Shoe Size":"","Pants Size":"","Occassion":"","Season":"","Badges":"Clearance","Rating Avg":5,"Rating Count":1,"Inventory Count":17,"Date Created":"2018-05-04 21:32:28"}

{"Product ID":8102,"SKU":"HEH-2254","Name":"Walk It Out Heels","Product URL":"https://www.domain.com/product/heh-2254","Price":32,"Retail Price":32,"Thumbnail URL":"https://www.domain.com/images/heh-2254_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Shoes>Heels>Pumps|New Arrivals|Featured Products","Category ID":"311|510|719","Brand":"Fusion Fashion","Child SKU":"HEH-2254-BLK-6|HEH-2254-BLK-7|HEH-2254-BLK-8","Child Price":"","Color":"Black","Color Family":"Black","Color Swatches":"","Size":"","Shoe Size":"6|7|8","Pants Size":"","Occassion":"","Season":"","Badges":"Featured","Rating Avg":4.7,"Rating Count":5,"Inventory Count":10,"Date Created":"2019-01-31 16:48:23"}

{"Product ID":9964,"SKU":"BCO-2208","Name":"Word To The Wise Journal","Product URL":"https://www.domain.com/product/bco-2208","Price":14.95,"Retail Price":14.95,"Thumbnail URL":"https://www.domain.com/images/bco-2208_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Home>Desk Decor>Journals","Category ID":410,"Brand":"Vintage Home","Child SKU":"","Child Price":"","Color":"Blue","Color Family":"Blue","Color Swatches":"","Size":"","Shoe Size":"","Pants Size":"","Occassion":"","Season":"","Badges":"","Rating Avg":4,"Rating Count":32,"Inventory Count":5,"Date Created":"2018-10-18 15:19:37"}

{"Product ID":10440,"SKU":"KOI-721","Name":"Basic Beauty Off-The-Shoulder Dress","Product URL":"https://www.domain.com/product/koi-721","Price":52,"Retail Price":78,"Thumbnail URL":"https://www.domain.com/images/koi-721_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Dresses>Off-The-Shoulder Dresses|Dresses On Sale","Category ID":"221|603","Brand":"Oasis","Child SKU":"KOI-721-BLP-SM|KOI-721-BLP-MD","Child Price":"","Color":"Blue Print","Color Family":"Blue|Multi","Color Swatches":"","Size":"Small|Medium","Shoe Size":"","Pants Size":"","Occassion":"Graduation","Season":"","Badges":"Exclusive","Rating Avg":3.2,"Rating Count":15,"Inventory Count":30,"Date Created":"2018-03-03 17:38:50"}

{"Product ID":6060,"SKU":"VBH-V5102","Name":"Sunset Boulevard Pants","Product URL":"https://www.domain.com/product/vbh-v5102","Price":44,"Retail Price":60,"Thumbnail URL":"https://www.domain.com/images/vbh-v5102_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Clothing>Bottoms>Pants|All Bottoms","Category ID":"236|204","Brand":"Monolith","Child SKU":"VBH-V5102-WHT-24|VBH-V5102-WHT-25|VBH-V5102-WHT-26|VBH-V5102-WHT-27|VBH-V5102-BEG-24|VBH-V5102-BEG-25|VBH-V5102-BEG-26|VBH-V5102-BEG-27|VBH-V5102-BEG-30|VBH-V5102-BEG-31","Child Price":"","Color":"White|Beige","Color Family":"White|Beige","Color Swatches":"[{\"color\":\"White\", \"family\":\"White\", \"swatch_hex\":\"#ffffff\", \"thumbnail\":\"/images/vbh-v5102-wht-24_600x600.png\", \"price\":44}, {\"color\":\"Beige\", \"family\":\"Beige\", \"swatch_hex\":\"#f5f5dc\", \"thumbnail\":\"/images/vbh-v5102-bge-24_600x600.png\", \"price\":44}]","Size":"","Shoe Size":"","Pants Size":"24|25|26|27|30|31","Occassion":"","Season":"","Badges":"","Rating Avg":3.8,"Rating Count":33,"Inventory Count":1,"Date Created":"2018-02-28 23:57:53"}

{"Product ID":10448,"SKU":"SKE-15460","Name":"Across The Pond Boots","Product URL":"https://www.domain.com/product/ske-15460","Price":74.49,"Retail Price":74.49,"Thumbnail URL":"https://www.domain.com/images/ske-15460_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Shoes>Boots>Flat Boots","Category ID":334,"Brand":"Legacy Collective","Child SKU":"SKE-15460-BRN-6|SKE-15460-BRN-7|SKE-15460-BRN-8.5","Child Price":"","Color":"Brown","Color Family":"Brown","Color Swatches":"","Size":"","Shoe Size":"6|7|8.5","Pants Size":"","Occassion":"","Season":"","Badges":"","Rating Avg":5,"Rating Count":6,"Inventory Count":0,"Date Created":"2018-06-25 18:09:07"}

{"Product ID":8137,"SKU":"PCH-8705","Name":"Once Upon A Time Lace Dress","Product URL":"https://www.domain.com/product/pch-8705","Price":50,"Retail Price":108,"Thumbnail URL":"https://www.domain.com/images/pch-8705_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Dresses>Lace Dresses|Dresses>All Dresses|New Arrivals","Category ID":"222|201|510","Brand":"Oasis","Child SKU":"PCH-8705-WHT-SM|PCH-8705-WHT-MD|PCH-8705-WHT-LG|PCH-8705-BLK-SM|PCH-8705-BLK-MD|PCH-8705-BLK-LG|PCH-8705-LTBL-SM|PCH-8705-LTBL-MD|PCH-8705-LTBL-LG","Child Price":"50|72|108","Color":"White|Black|Light Blue","Color Family":"White|Black|Blue","Color Swatches":"[{\"color\":\"White\", \"family\":\"White\", \"swatch_hex\":\"#ffffff\", \"thumbnail\":\"/images/pch-8705-wht-sm_600x600.png\", \"price\":50}, {\"color\":\"Black\", \"family\":\"Black\", \"swatch_hex\":\"#000000\", \"thumbnail\":\"/images/pch-8705-blk-sm_600x600.png\", \"price\":108}, {\"color\":\"Light Blue\", \"family\":\"Blue\", \"swatch_img\":\"/swatches/light_blue.png\", \"thumbnail\":\"/images/pch-8705-ltbl-sm_600x600.png\", \"price\":72}]","Size":"Small|Medium|Large","Shoe Size":"","Pants Size":"","Occassion":"Party","Season":"","Badges":"","Rating Avg":5,"Rating Count":4,"Inventory Count":0,"Date Created":"2019-02-15 20:33:28"}

{"Product ID":10018,"SKU":"PGF-ESS","Name":"Lovey Dovey Maxi Dress","Product URL":"https://www.domain.com/product/pgf-ess","Price":68,"Retail Price":68,"Thumbnail URL":"https://www.domain.com/images/pgf-ess_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Dresses>Maxi Dresses|Dresses>All Dresses|New Arrivals","Category ID":"223|201|510","Brand":"Oasis","Child SKU":"PGF-ESS-FUOR-SM|PGF-ESS-FUOR-MD|PGF-ESS-FUOR-LG|PGF-ESS-PRPT-SM|PGF-ESS-PRPT-MD|PGF-ESS-PRPT-LG","Child Price":"","Color":"Fuschia Orange|Perfect Petals|Island Time","Color Family":"Orange|Pink|Yellow|Multi","Color Swatches":"[{\"color\":\"Fuschia Orange\", \"family\":[\"Orange\",\"Pink\"], \"swatch_img\":\"/swatches/fuschia_orange.png\", \"thumbnail\":\"/images/pgf-ess-fuor-sm_600x600.png\", \"price\":68}, {\"color\":\"Perfect Petals\", \"family\":\"Pink\", \"swatch_img\":\"/swatches/perfect_petals.png\", \"thumbnail\":\"/images/pgf-ess-prpt-sm_600x600.png\", \"price\":68}, {\"color\":\"Island Time\", \"family\":[\"Yellow\",\"Orange\",\"Multi\"], \"swatch_img\":\"/swatches/island_time.png\", \"thumbnail\":\"/images/pgf-ess-istm-sm_600x600.png\", \"price\":68}]","Size":"Small|Medium|Large","Shoe Size":"","Pants Size":"","Occassion":"Party","Season":"","Badges":"","Rating Avg":4.8,"Rating Count":12,"Inventory Count":24,"Date Created":"2019-02-20 21:38:02"}

{"Product ID":5670,"SKU":"HEH-2223","Name":"Shot in the Dark Pillow","Product URL":"https://www.domain.com/product/heh-2223","Price":40,"Retail Price":40,"Thumbnail URL":"https://www.domain.com/images/heh-2223_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Home>Home Decor>Pillows","Category ID":298,"Brand":"Vintage Home","Child SKU":"","Child Price":"","Color":"Coral","Color Family":"Red","Color Swatches":"","Size":"","Shoe Size":"","Pants Size":"","Occassion":"","Season":"","Badges":"Free Shipping","Rating Avg":4,"Rating Count":3,"Inventory Count":8,"Date Created":"2018-03-01 20:28:28"}

{"Product ID":9020,"SKU":"PGF-RIK","Name":"Diamonds Are Forever Pillow","Product URL":"https://www.domain.com/product/pgf-rik","Price":36,"Retail Price":36,"Thumbnail URL":"https://www.domain.com/images/pgf-rik_600x600.png","Search Keywords":"lorem, ipsum, dolor, ...","Description":"Sociosqu facilisis duis ...","Category":"Home>Home Decor>Pillows","Category ID":298,"Brand":"Vintage Home","Child SKU":"","Child Price":"","Color":"Light Blue","Color Family":"Blue","Color Swatches":"","Size":"","Shoe Size":"","Pants Size":"","Occassion":"","Season":"","Badges":"Free Shipping","Rating Avg":5,"Rating Count":3,"Inventory Count":11,"Date Created":"2018-03-16 22:17:50"}

Notes

Each Product object representation must exist in a new line of its own

Multiple levels within the Product object will be flattened, only accounting for the keys at the lowest level