Overview

Unbxd App for BigCommerce helps you use Unbxd Site Search within your Bigcommerce store. This app allows companies (irrespective of their size) to integrate their websites on the BigCommerce platform with Unbxd’s Site Search solution.

It allows:

Automatic Catalog Sync: Each product addition or deletion is sent to Unbxd servers every 24 hour automatically, to keep the data at Unbxd servers up-to-date.
Analytics Integration: The Unbxd Extension for BigCommerce automatically tracks user analytics and behavior that is essential in order to provide accurate and user-specific search results. The extension analyzes every user event and tracks product clicks, products added to cart, and orders. With this information, a user profile is built for every user based on his/her affinity to a certain category, brand, or price.

All you have to do is signup to the Unbxd console, install the BigCommerce plugin by providing the store hash and configure the BigCommerce store to replace BigCommerce default search experience with Unbxd experience

This section will help you install the Unbxd App, synchronise product catalog, and integrate analytics.

Prerequisites

The following permissions are required to install the plugin :

BigCommerce User Role : Store Owner or Store Administrator.
During the installation process Unbxd app will request for following permissions :
- View and Modify content, products and theme
- Generate tokens to access your store’s storefront APIs
- View basic configuration settings

Installation

To install the BigCommerce app:

Signup to the Unbxd self serve console at https://console.unbxd.io/signup
Create the Site key
Choose the “BigCommerce Plugin” from the Platform section
Find the store hash for your BigCommerce store
Login to your BigCommerce store has store owner
Click on Home and scroll down to Advance Settings
Click on Advance Settings and scroll down to API Accounts
Click on Advance Settings then click on Create API Account and select Create V2/V3 API Token
Take a note of store hash present in the API Path i.e. https://api.bigcommerce.com/stores/(store_hash)/v3//v3/)
Enter the store hash value in the Unbxd console.
Accept the terms and conditions by clicking on the confirm button
Unbxd automatically starts fetching the catalog from the BigCommerce store

Follow the rest of the instructions on the Unbxd console. Confirm the BigCommerce plugin installation in the store

Configuration

Once the plugin is installed then we have to do configurations in the BigCommerce store to replace the default BigCommerce search APIs, Autosuggest with Unbxd search APIs and autosuggest.

Log in to your BigCommerce store as a store owner
Using the sidebar, go to the Storefront and click on my themes
Make a copy of the current theme by clicking the Make a copy from the Advanced option
Scroll down to the copied theme, click on more option and click on Edit theme files
Open the search.html file present in the templates > pages
To render Unbxd search results, we need to replace the default SRP template with Unbxd specific SRP template.To do this

Remove the content of the partial head {{#partial “head”}}
Replace the content of the partial page {{#partial “page”}} with <div id=”UNX-search-wrapper”></div>

Save the file and close.
Open quick-search.html file present in templates>components>common

In this we are going to replace the BigCommerce default search query input box with the Unbxd query input box. This will enable you to make search queries to the Unbxd servers rather than to default BigCommerce servers. To do this

Hide the default input box by setting CSS style property display as none using style=display:none Now just below this input box, add Unbxd input box by adding the this code snipped <input class="UNX-search-input form-input" autocomplete="off" placeholder="Search"> Checkout the screenshot below.
Save the file and close.
Now go back to my themes again and make the copied theme the LIVE theme.
As you will make this the LIVE theme, the search experience would be powered by Unbxd AI-based search engine.