Docs

Site Search Console - User guide

Introduction

The Unbxd Commerce Search enhances your on-site search to deliver fast, relevant, and tailored search results to visitors on your website.
These services are easily controlled and monitored by an advanced interface called the Console. The console was built from ground up keeping mainly merchandisers in mind and includes controls like multi-level merchandising, in-depth reporting, multi-user accessibility, etc. It also offers various other useful options like catalog configurations, synonym libraries , etc., to help you expose your product inventory in the most optimized way.

Getting started

The Search Console User Guide will guide you to use the console features and help make the most out of Unbxd Commerce Search on your site or app.

Sign-up

To access the console, you must first fill in your details on the signup form. Your Account Manager will share the signup form link.

Notes:

  • Website URL: You can enter the URL of your site/app for which you want to integrate the Unbxd Commerce Search. This will add a site on the console and link your site/app to it. You can also add more sites from the console’s interface.

  • Region: This indicates the physical location of the Unbxd servers (Singapore and US). You can choose the option closest to your server to get the best search response. For example, if you are based out of Asia Pacific (APAC)region, choose Singapore, else select US.

Choose your Platform

It is important for us to understand your platform (custom or third-party) in order to provide the best way to integrate. For example, third-party platforms like Magento, have its service extension/plug-in help integrate from its configuration interface.

You can choose from a list of third-party platforms we support or if your site is built on a custom platform, you can select Self Designed Platform.

Integration

After you have selected your platform, next step is to integrate Unbxd Commerce Search on your site/app.
Before you integrate, you must do the following:

  • Upload Catalog
  • Configure Unbxd Analytics

If you haven’t completed the steps above, the console will walk you through the same.

Upload Catalog

All Unbxd services work based on your catalog data, which must be formatted in specific format before sending it to us. We use this data to create search indexes that makes it easy for us to find that needle in the haystack, figuratively speaking.

After you have successfully created the Unbxd version of your catalog, you can click Catalog Upload to upload or directly call our API as mentioned in the documentation.

For more information about catalog upload, see here.

Configure Unbxd Analytics

Unbxd Analytics is an advanced tracking tool that captures browsing behaviors of visitors on your site. This behavior is used to enhance search experience of visitors. For more information about Unbxd analytics, see here.

Configure Search

After you have completed the steps above, you can configure Unbxd Commerce Search in your site. You can further choose to integrate via:

  • RESTful API
  • AJAX-based
  • SDK libraries

Refer the documentation of your required approach to correctly integrate the service.

After you have successfully integrated, you are now ready to learn different features of Unbxd Console.

Basic Settings

Let’s start from some of the basic and essential settings before you move on to much advanced ones. The following settings can be accessed at any point on the console, such as:

  • Site Selector

    You can click + Add New Site to add new sites to the console. The Site Selector dropdown lets you switch between sites from main menu in order to make setting changes on them. The current site name will be displayed here.

  • Profile Settings

    The profile settings option is aesthetically positioned on the top right side of the console. Apart from the usual settings, you can change your account password from here.

Dashboard

The Dashboard section displays an overview of the Unbxd Commerce Search’s performance in your site according to various performance metrics for a default rolling period of last 14 days.

The Unbxd performance metrics are explained below.

NameDescription
Last Indexing StatusThe status (“INDEXED” or “Error”) of the recently uploaded catalog data.
Total no of ProductsThe total number of products in your uploaded catalog data.
Last Catalog UploadThe date of the recent catalog upload.
Search QueriesThe number of search queries made on your site.
Product ViewsThe total number of PDP (Product Detail Page) views on your site.
Add to CartsThe total number of products added to cart on your site.
Products SoldThe total number of products sold on your site.

Commerce Search Revenue Graph

The graph shows the revenue generated per day for 14 days.

NameDescription
Total RevenueTotal revenue generated on your site.
Revenue / Search VisitRevenue generated per search visit. This metric helps you understand the conversion at a search visit level. A search visit can have more than one search query.
Revenue / Search QueryRevenue generated per search query. This metric helps you understand the conversion at a search query level.

Commerce Search Visit & Query Report Graph

The graph shows the number of Search Hits (Queries and Visits) on a daily basis.

Merchandising

The Merchandising section of the console provides useful controls that will help you merchandise products in your inventory.

Commerce Search

You can merchandise visitor searches by creating campaigns, based on the business rules you create, on the console.
There are three types of rules you can create:

  • Site Rule
  • Query Rule
  • Field Rule

Note: In case of conflicts between rules, this order of precedence will be followed on the search results: Site Rule > Query Rule > Field Rule.

Site Rule

Site rule is applied site-wide, that is across all pages on the site. You can perform the following actions:

  • Boost
  • Filter
Boost

Boosting within a site rule lets you promote (or demote) products in the search results for all the queries based on a specified condition.
For example, a boost rule can be created to boost products with field name “availability” and value “true” to the top of the search results.

Boosting and burying can be done at 100 levels, allowing for soft boost and soft bury. Earlier, Unbxd used to support 3 levels of boosting (high, moderate, low) and just 1 level of demoting.

The mapping between old boost scoring to new scoring is mentioned below:

Boost of High in old scoring => Boost of level +40 in new scoring
Boost of Moderate in old scoring => Boost of level +20 in new scoring
Boost of Low in old scoring => Boost of level +10 in new scoring
Demote in old scoring => Bury of level -100 in new scoring

The boost levels above determine the position of the products (from top to bottom respectively) on the search results page.

Filter

Filtering in a site rule allows you to refine search results for all the queries based on attribute rules.

To add a site rule:

  1. Navigate to MerchandisingCommerce SearchSite Rule.

  2. Click + Add Site Rule.

  3. If you want to edit existing site rule, click View Site Rule, follow steps 4 through 7, and then click RE-PUBLISH.

  4. To create a boost group, on the Boost tab, do the following:

    1. Select field name from the dropdown list.
    2. Select comparator based on the field (equal to, not equal to, contains, does not contain).
      Note: For the field “price”, comparator options are equal to, in between, more than, less than.
    3. Specify the value.
    4. Move the slider to assign a boost level. The default value of boost is 0.
    5. To add multiple attribute rules for a boost group, click Add attribute rule.
    6. To create multiple boost groups, click .
      Tip: As a best practice, always assign different boost level across different boost group in order to get the desired arrangement of the results.
  5. To create a filter group, click the Filter tab, and then do the following:

    1. Select field name from the dropdown list.
    2. Select comparator based on the field (equal to, not equal to, contains, does not contain). For the field “price”, the comparator options are equal to, in between, more than, and less than.
    3. Specify the value.
    4. To add multiple attribute rules for the filter group, click Add attribute rule.
    5. To add multiple attribute rules for a boost group, click Add attribute rule.
    6. To create multiple filter groups, click . Only the products that satisfy all the attribute rules and filter groups will be shown in the results.
  6. Click NEXT.
    The Facets tab appears. You can also enable/disable the facets and the order in which they should appear across the site for all the pages.

    If you want to add a new facet, you can navigate to ManageConfigure Site to add facets. For more information on configuring facets, see Configure Facets.

  7. To reposition a facet, do the following:

    1. Hover on the facet row you want to reposition. The reposition icon appears.
    2. Click , and then drag the facet to a new position.
    3. If you want to show the facet on your site, in the Show column, select the respective facet checkbox.
    4. Click to save the repositioning changes.
  8. To edit values of a facet, do the following:

    1. Click the facet for which you want to edit the values.
    2. Click .
    3. Type the new facet length.
    4. Select sort order for your facet. You can sort either by product count or alphabetically.
    5. Click Save.
  9. To go to the previous screen, click PREV.

  10. Click PUBLISH.

Field Rule

Field rules are used to show facets for all queries belonging to a certain type. By default, facets under Site Rule are displayed for all queries, however you can override them for a particular type of queries. For example, you may want to show different facets and banners for all the queries of the type “Shoe”, that is, “black shoes”, “brown shoes”, “party shoes” etc. In such a case, you need to create a field rule for Shoes category.

To create a field rule:

  1. Navigate to MerchandisingCommerce SearchField Rule.

  2. To add fields, do the following:

    1. Click .
    2. Select the field(s) you want to use. You can also search the fields.
      Note: You can select a maximum of five fields.
    3. Click Apply. The selected fields appear in the Create Field Rule window.
  3. Click .
    The Create Field Rule window appears.

  4. Select the field you want to use.

  5. Select the respective field value.

  6. Click CREATE FIELD RULE.
    The new field rule is added in the Field Rule tab.

  7. Click the field rule you want to publish.

  8. To set up banner using an image url, do the following:

    a. Click Image url.

    b. Enter the url of an existing banner image.

    c. Enter the corresponding landing page url.

  9. To set up banner using HTML, click HTML, and then paste your banner html code.

  10. Click the Facets tab. You can navigate to ManageConfigure Site to configure facets. For more information on configuring facets, see Configure Facets.

  11. To reposition a facet, do the following:

    1. Hover on the facet row you want to reposition. The reposition icon appears.
    2. Click , and then drag the facet to a new position.
    3. If you want to show the facet on your site, in the Show column, select the respective facet checkbox.
    4. Click to save the repositioning changes.
  12. To edit values of a facet, do the following:

    1. Click the facet for which you want to edit the values.
    2. Click .
    3. Type the new facet length.
    4. Select sort order for your facet. You can sort either by product count or alphabetically.
    5. Click Save.
  13. To go to the previous screen, click PREV.

  14. Click PUBLISH.

Query Rule

Query rule allows you to manually customize the product order for a particular query. Merchandisers can use query rules to apply their business logic or run promotional campaigns on top of Unbxd AI. For example, run a clearance campaign for the search query “shoes”, boost products to the top that are on promotion for the brand “nike”.

You can use the Query Rule tab to manage your campaigns. You can do the following:

  1. Creating a campaign

  2. Merchandising

    • Start Merchandising
      • Boost
      • Sort
      • Slot
      • Pin
      • Filter

    • Create a landing page
    • Redirect to an existing page

3. Setting experience

Creating a Campaign

You can use the Query Rule tab to create campaigns for queries.

To create a campaign:

  1. Navigate to MerchandisingCommerce SearchQuery Rule.

  2. Click .

  3. Type the query.

  4. List out the search queries similar to the main query.
    This enables us to show the same merchandising campaign for all the similar queries.

    Note: Similar queries can be edited anytime.

  5. Click CREATE.
    The Enter Campaign Details section appears.

  6. Type the name of your campaign.

  7. Enter the start date and end date to specify the duration of the campaign in your site. The end date is optional.

  8. Select the time zone for the campaign.

  9. Click the device type to target specific users. You must at least select one device type.

  10. Type a brief description for your campaign.

  11. Click NEXT.
    The Merchandise section appears.

Merchandise

The Merchandise section has a two-panel interface where one shows the different merchandising options and the other shows a real-time preview of your search result page for a particular query. The changes are reflected on your site once you publish.

You can:

  • Start merchandising
  • Create a landing page
  • Redirect to an existing page

To start merchandising, in the Merchandise section, click START MERCHANDISING.

Start Merchandising

As the name suggests, this option lets you start right away with merchandising the search results for the particular search query seen on the left.
Merchandising includes:

  • Boost
  • Sort
  • Slot
  • Pin
  • Filter

Boost

Boosting within a query rule lets you promote (or demote) products in the search results for that query based on a specified condition. For example, a boost rule can be created for query “dress” to boost products with field name “color” and value “red” to the top of the search results.

Boosting and burying can be done at 100 levels, allowing for soft boost and soft bury. Earlier, Unbxd used to support 3 levels of boosting (high, moderate, low) and just 1 level of demoting.

The mapping between old boost scoring to new scoring is mentioned below:

Boost of High in old scoring => Boost of level +40 in new scoring
Boost of Moderate in old scoring => Boost of level +20 in new scoring
Boost of Low in old scoring => Boost of level +10 in new scoring
Demote in old scoring => Bury of level -100 in new scoring

The boost levels above determine the position of the products (from top to bottom respectively) on the search results page.

To create a boost group:

  1. In the Merchandise section, click START MERCHANDISING.

  2. On the Boost tab, select field name from the dropdown list.

  3. Select comparator based on the field (equal to, not equal to, contains, does not contain).

    Note: For the price field, comparator options are equal to, in between, more than, and less than.

  4. Specify the value.

  5. Move the slider to assign a boost level. The default value of boost is 0.

  6. To add multiple attribute rules for the boost group, click Add attribute rule.

  7. To add multiple boost groups, click .

    Tip: As a best practice, always assign different boost level across different boost group in order to get the desired arrangement of the results.

Sort

Sorting allows you to rearrange the search results based on certain fields in a particular order. Search results can be sorted in either numerical (ascending/descending) or alphabetical order (A-Z or Z-A) depending on the field value. By default, Unbxd sorts your search results based on relevancy.

To create a sort group:

  1. In the Merchandise section, click START MERCHANDISING.

  2. Click the Sort tab.

  3. Select field name from the dropdown list.

  4. Select sort order (ascending and descending or ascending A-Z and descending Z-A).

  5. To add multiple attribute rules for the sort group, click Add attribute rule.

Search results will be sorted according to the order of the sort rules defined. Subsequent rules will be applied to only those products that have the same values for the preceding sort field.

For example, if you have created a sort group with the following attribute rules:

  • price (ascending)
  • color (A-Z), and
  • brand (A-Z)

The search result will be in this order:

  • Products with same price and color, sorted on brand (A-Z)
  • Products with same price sorted on color (A-Z)
  • Products sorted on price (ascending)

Note: You cannot create sort groups when a boost/slot/pin rules exist.

Slot

Slotting allows you to showcase products from the search results within slots on search results page. Slotting can be used in scenarios where products need to be promoted in only specific positions, preferably at the top of the page.

For example, if “Tommy Hilfiger” shirts above $100 have a poor inventory turnover rate and there are many such SKUs in the inventory for which the boost feature will only display “Tommy Hilfiger” shirts in the first 2 rows, resulting in a sub-par shopping experience for the visitors due to a lack of variety.

To create a slot group:

  1. In the Merchandise section, click START MERCHANDISING.

  2. Click the Slot tab.

  3. Specify the start and end positions of the slot range.

  4. Select field name from the dropdown list.

  5. Select comparator based on the field (equal to, not equal to, contains, does not contain).

    Note: For the price field, comparator options are equal to, in between, more than, and less than.

  6. Specify the value.

  7. To add multiple attribute rules for the slot group, click Add attribute rule.

  8. To create multiple slot groups, click .

Only the products that satisfy all the attribute rules will be shown in the slot. Each slot group allows you to define 10 positions.

Tip:

As a best practice, always choose different slot range for different boost group in order to get the desired arrangement of the results.

Pin

Pinning lets you arrange your search results by placing individual products on specific positions on the search results page. For example, the sourcing team has finally been able to source “Denim shirts” and you want to promote specific products from the catalog, which according to analysis, are selling well in the offline channel.

Apart from the search result page interface, an additional screen containing all the results for the query lets you pin your products.

To pin your product:

  1. In the Merchandise section, click START MERCHANDISING.

  2. Click the Pin tab.

  3. Enter the position number, and then click .

To pin using CSV:

  1. In the Merchandise section, click START MERCHANDISING.

  2. Click the Pin tab.

  3. Open the Manage dropdown next to the search bar.

  4. To pin multiple products, you can:

    • Upload a CSV file of the product-position map
    • Download a CSV file with the existing positions, edit, and then upload.
    • Download a CSV template, edit, and upload
  5. To remove all pins, click on Clear Pins.

Note: You cannot pin products on slotted positions.

Filter

Similar to filtering in a site rule, filtering on query campaigns allows you to refine the search result for a particular query based on attribute rules.

To create a filter group:

  1. In the Merchandise section, click START MERCHANDISING.

  2. Click the Filter tab.

  3. Select field name from the dropdown list.

  4. Select comparator based on the field (equal to, not equal to, contains, does not contain).
    For the price field, comparator options are equal to, in between, more than, and less than.

  5. Specify the value.

  6. To create multiple attribute rules for the filter group, click Add attribute rule.

  7. To create multiple filter groups, click .
    Only the products that satisfy all the attribute rules and filter groups will be shown in the results.

Creating a Landing Page

Unlike Start Merchandising, landing pages allow you to merchandise on the entire catalog and not just the products relevant to a particular category.

Landing pages are useful for creating result pages for new categories or categories such as "sale", "Discounts", etc. All merchandising rules such as filter, sort, boost, slot, and pin would be available in this section.

To create a landing page, in the Merchandise section click CREATE A LANDING PAGE.

Redirecting to an Existing Page

To redirect to an existing page, in the Merchandise section, click ADD URL. You can enter or paste the redirect URL.

Setting Experience

The way search results page appears greatly impacts visitors’ searching patterns. This makes showcasing the right options at the right places on the results page equally important.
Setting the experience is the last step for publishing your query campaign and involves setting the banner.

To set up banner:

  1. After the merchandising step, click NEXT.

  2. To set up banner using an image url, do the following:
    a. Click Image url.

    b. Enter the url of an existing banner image.

    c. Enter the corresponding landing page url.

  3. To set up banner using HTML, click HTML, and then paste your banner html code.

Publish

After you are done creating/configuring your banners, you can click PUBLISH to publish your campaign for the created query rule. A page displays essential information about all the created campaigns in a tile view.

Managing your Campaign

For a particular rule, a campaign can exist in one of the following states.

Campaign StateDescription
ActiveCampaigns that are currently running on your site/app. These campaigns are marked green. You can edit or duplicate an Active campaign and re-publish it.
UpcomingCampaigns that are to be published on a later date. These campaigns are marked blue. You can edit or duplicate an upcoming campaign and re-publish it.
DraftsCampaigns that are not yet published.
StoppedActive campaigns that have been ‘stopped’. A stopped campaign cannot be restarted again. However, you can duplicate a stopped campaign and re-publish it.
ExpiredCampaign that has crossed its end date. You can duplicate an expired campaign and re-publish it.

To access campaign actions:

  1. Navigate to MerchandisingCommerce SearchQuery Rule.

  2. Click a query rule to access all the related campaigns.

  3. To edit a campaign, click .

  4. Click to access the following commands:

    • Stop: Allows you to stop a campaign.
    • Delete: Allows you to delete a campaign.
    • Duplicate: Allows you to duplicate a campaign.

Notes:

  • You can delete any campaign.
  • A duplicate campaign will have suffix “copy” added to its original campaign name.
  • No two campaigns can be active for the same device type on the same date range.

Libraries

The Libraries section allows you to create unidirectional or bidirectional synonyms for keywords.

To add synonyms:

  1. Navigate to Merchandising → Libraries.

  2. Click , and then click .
    The Add Synonym window appears.

  3. Type the synonym keyword.

  4. Type the unidirectional Synonym, if any.

  5. Type the bidirectional Synonym, if any.

  6. Click Create.
    The keyword appears in the Synonyms tab.

  7. To edit a keyword, click .

  8. To delete a keyword, click .

  9. To bulk upload a list of synonyms from a CSV file, click , and then click .

  10. To download a list of synonyms in a CSV format, click , and then click .

Typeahead

The Typeahead section allows you to configure the autosuggest through promoted suggestions and blacklisted suggestions.

Promoted Suggestion

Promoted suggestion are configurable suggestions for keywords. Though promoted suggestions function similar to keyword suggestions, but you get to decide what suggestion should be shown.

To add a promoted suggestion:

  1. Navigate to MerchandisingTypeaheadPromoted Suggestion.

  2. Click .
    The Add Promoted Suggestion window appears.

  3. Enter the start date and time for your promoted suggestion.

  4. Enter the end date and time for your promoted suggestion.

  5. Type all the keywords (in comma-separated format) for which you want to showcase the configured suggestion.

  6. Click Add.
    The promoted suggestion appears in the Promoted Suggestion tab.

  7. To edit a promoted suggestion, click .

  8. To delete a promoted suggestion, click .

Blacklisted Suggestions

There are cases where for a particular keyword the autosuggest shows a keyword suggestion you don't want the visitors to see. Adding them as blacklisted helps you remove those suggestion from the list.

To add a blacklisted suggestion:

  1. Navigate to MerchandisingTypeaheadBlacklisted Suggestions.

  2. Click .
    The Add Blacklisted Suggestions window appears.

  3. Type the terms in a comma-separated format.

  4. If you want to remove suggestion that exactly matches with the specified suggestion, select the Exact Match checkbox.

  5. Click Add.
    The suggestions appears on the Blacklisted Suggestions tab.

  6. To edit a blacklisted suggestion, click .

  7. To delete a blacklisted suggestion, click .

Reports

The Reports section gives you in-depth insights on the visitor interactions, query, and product performances. Merchandisers can take quick actions on queries, and fields on the site by referring this section of the console.

The console provides the following reports:

  • Search
  • Typeahead
  • Product

The Search reports include insights on all visitor events resulted from a query typed in a search field.

Overview

The Overview section gives a holistic view of essential performance metrics such as Clicks, Carts, Orders, %Conversion Rate, Top Searched Queries, Top Clicked, and Top Ordered Products, Zero Results Queries for the last 15 days. It helps merchandisers get a complete understanding of the trending queries, products, and zero results queries on a quick glance.

You can toggle between two types of graphs:

  • Trend

    The trend graph lets you view the performance comparison of any two metrics for the selected time frame. You can choose to view the trends of - hits, clicks, CTR, carts, orders, conversions, and revenue/search and lets you easily switch between Daily, Weekly,and Monthly reports.

  • Funnel

    The funnel graph shows you the conversion funnel of the essential performance metrics data (hits, clicks, carts, orders) for the selected time frame.

The Zero Results Queries report helps merchandisers view all the queries for which the visitors have seen no result. It is always a best practice to merchandise on the zero result queries first using the various merchandising options of the console. You can avoid showcasing Zero Results page by creating synonyms, landing pages, and redirects.

Query Reports

The Query Reports section gives a detailed report of top search queries based on hits, clicks, carts, product sold, %conversions, %click through rate, and revenue per search. You can search for any query using the search option and download reports in a CSV format.

Merchandisers can also drill down to performances of each individual query. It will show trends and the funnel report for that particular query. Merchandisers can also view details of popular products for a particular query.

By default, queries are sorted on hits in ascending order; however, you can sort on any of the other metrics. A standard date selector interface lets you change the time period for the report. You can also search for a query using the search option.


Typeahead

The Typeahead reports follow the same layout as others. Under the Overview tab, a trend graph shows a comparison between two metrics from cart, order, %conversion rate, revenue, and engagement for 14 days where you can switch between Daily, Monthly ,and Weekly timeframes. You can also view a 14-day Funnel graph for the query based on hits, clicks, carts, and orders.

Another section shows visitor interactions on Unbxd typeahead doctypes based on their purchase journey.

In-Feature, Keyword Suggestion, Top Queries, Popular Products also have their own Trend/Funnel graph with all the options on it.




Products

The Product Level Report gives a detailed report of products based on Product Views, Add to Cart, and Products sold. You can search for any product using the search option and download reports in a CSV format.

Manage

The Manage section provides all the essential configuration controls over your account, sites, and other console settings.

Configure Site

This section provides all the essential controls and options for making an API call and configuring your catalog data.

Navigate to ManageConfigure Site.

Keys

Keys are required for making an API call to Unbxd platforms from a particular site. All API calls to Unbxd are authenticated using these keys:

Site Key

Every site added on the console has a unique alphanumeric site key, which is used in all API calls to help us identify your site. A sample site key for a site named “testing” looks like: testing-u1478243900645.

API Key

Every Unbxd account has a unique hexadecimal API key, which helps us to identify your account. Similar to the site key, the API key is also used in every API call.

Secret Key

Every account also has a unique 32-digit hexadecimal secret key. Unlike other keys, the secret key is not exposed in the URL, making it safe and easy for operation, such as catalog upload.

API

APIs are the building blocks of Unbxd Commerce Search.

Navigate to ManageConfigure SiteAPI.

This section provides API calls on the ready for various operations:

  • Commerce Search API
  • Catalog Feed API
  • Typeahead (Autocomplete) API
  • Instant Search API (This is currently unavailable)

You can easily copy these API signatures and start making calls to Unbxd platform.

For more information about APIs, see here.

Catalog

You can upload or re-upload your catalog data. If you were not able to upload your catalog data in the beginning, you can do it from this section any time.

Navigate to ManageConfigure SiteCatalog.

Note: Every upload will be considered as a full-feed upload. A full-feed upload will replace all the previously uploaded data.

This section also displays the following information.

NameDescription
Catalog InformationShows the total number of existing products.
Last Upload InformationShows the number of products uploaded in the recent upload and the indexing status.
Upload InformationDetails of the current upload. This includes:
  • Feed File name
  • Status (Indexed or Error)
  • Date
  • Time
  • Upload Type

For more information about catalog upload, see here.

Field Mapping

You can map essential fields from your catalog with Unbxd dimensions (also known as the Featured Fields) in order for the search engine to leverage semantic relevance. In other words, mapping the Unbxd dimensions help us better understand your catalog. There are 26 such fields.

To a map your fields with Unbxd:

  1. Navigate to the ManageConfigure SiteField Mapping.

  2. Click .

  3. Select the field from the dropdown list for its corresponding Unbxd dimension.

  4. Click Update.

Field Properties

You can view all the fields in your catalog and its field properties.

Navigate to ManageConfigure SiteField Properties.

The table below describes the field properties.

NameDescription
Field typeDetermines the datatype of a field. A data type determines whether a field is searchable or not. There are 6 different types of data types. For example, fields like description, meta_description etc., are configured to “descriptive-text” which is non-searchable.

For more information about Unbxd datatypes, see here.
Multi-valuedDetermines whether a field can have multiple value for a product. For example, usually products come in different colors hence if a product say, “Wrangler plain t-shirt” comes in different colors, then the multi-valued property for the “color” field must be set to “Enable” in the schema.

To make changes on field properties, you need to edit your catalog data (also known as Product Feed) and re-upload it from the console.

Note: You can sort the field properties by ascending or descending order.

Configure Facets

This section lets you configure global facets.

To add a facet:

  1. Navigate to ManageConfigure SiteConfigure Facet.

    A table on the left displays existing facets and a facet configuration panel on the right.

  2. Click .

  3. Type the display name of the facet.

  4. Select the appropriate attribute.
    The facet type is automatically loaded.

  5. Specify the facet length. This determines the number of values displayed under a facet field.

  6. In the Sort Order list, do one of the following:

    • To set your sort order as per the product count, click Product Count.

    • To set your sort order alphabetically, click Alphabetical (A-Z).

  7. To configure range facets for fields like price, size, etc, specify ranges in Range Start, Range Gap, and Range End.

  8. Click Save.
    The new facet will appear in the list of global facets on the left panel.

For more information about facets, see here.

To edit a facet:

  1. Navigate to ManageConfigure SiteConfigure Facet.
    A table on the left displays existing facets and a facet configuration panel on the right.

  2. Click the facet you want to edit.

  3. Click .

  4. Edit the display name.

  5. Click Update.

Configure Search

Relevancy Ranking

In addition to configuring field types, relevancy ranking gives you control over the searchable fields by allowing it to be ranked so that the search results appear based on this arrangement.

You can assign the following search weights to rank fields:

  • Non-Searchable
  • Low
  • Normal
  • High

To configure relevancy ranking:

  1. Navigate to ManageConfigure SearchRelevancy Ranking.

  2. Click .

  3. Select the search weight from the dropdown list for its corresponding Unbxd dimension.

  4. Click Update.