Shopify User Guide
User Guide
1. Getting Started
2. Searching
2.1 Autocomplete and Result Page
You should be able to see our autocomplete and result page at this point. For autocomplete, we will show title, description and thumbnail by default. If you are using our cross-domain feature, you will see the domain name as well. For details about cross domain search, you can consult our “Cross Domain Search” Section below. Along with search result, there is thumbnail. For Free accounts, Search IQ will generate thumbnails in your server and serve from there. For our paid users, thumbnails are generated and hosted on Search IQ servers and deliver through CDN for better performance and user experience.
Autocomplete
Result Page
2.2 Match Option
By default, Search IQ will return search results based on both relevancy and recency. For a particular user query, our engine will first decide what posts are relevant and rank them based on relevancy score with recency taken into consideration. That is to say, if posts are similar in relevancy, we will rank the latest one higher.
In term of search relevancy, by default, Search IQ will use Board Match. That is one of the match options that tries to boost up the search coverage by identifying content that has some terms matching the query regardless the word order and form. If you want the match be more restrictive, you can try other matching options like “Full term match” and “Phrase match”.
2.3 Fine-tune the result ranking
a) Field Weight
There are times you want to have better control the result ranking like you want our search engine gives higher priority to the posts the has a title match than description match. To address this need, Search IQ provides you a field weight control page under “Documents” menu tab that you can go there to adjust the weight at the field level with 10 the highest weight and 0 if you want to ignore.
b) Control what posts to show by user query
If you want to have even more fine-grained control like you want to show a product at the top of the search result for a particular user query, you can achieve this by adding the user query as a tag to your product and give “Tag” field a high weight like 9 to 10 and potentially lower the “Title” weight. This feature may not allow you to explicitly decide what rank #2, #3 and so on but it allows you to show a set of posts for a particular query.
c) Custom sorting (Upcoming!)
Search IQ will provide custom sorting feature shortly. With this feature, you can do multi-field sorting. For example, if you want the matching content ranked by popularity first and recency next, you can do it in our UI given the popularity field and post date are indexed.
3. Search Analytics
3.1 Analytics Dashboard
Search IQ tracks what your users searches and clicks on your site and provides you analytic reports. To access your domain reports, login in to your Shop’s admin console and go to Apps -> Search IQ. Select your shop name (if you have more than one shop in the same account) and click the Analytics on the left sidebar.
In the analytic dashboard, you can see # of searches, # of autocomplete click and # of result page click for your users within a time range you selected. For free account, you can examine the data for the last 24 hours. For larger time range, please consider to upgrade your account. Search IQ provides both mobile and desktop analytics. You can select view them as a whole under “Traffic: All” or individually. The reports that our users use the most are “Top Search Terms” and “Top Terms with no result” sections. For the “Top Searches Terms” section, you can find out what kinds of content your users expecting from your site. So, you are followed the demand to deliver the content your users interested. For “Top terms with no results” section, you can see if you are really missing out some opportunities there or some search terms are not appeared in your content but you have written about. For latter, you can use our “Synonym” section to fix it. For example, if user search on apparel with brand “A&F” but your product title and description only use the full name “Abercrombie”, it may not come up as a match. If you see “A&F” in your “Top terms with no results” section, you can go to Documents > Synonym Section and add the synonym “Abercrombie, A&F”. This way you are teaching our search engine that they are the same in meaning so next time when user types A&F in search query, Abercrombie products will be shown up in the search result.
3.2 Export the Data
Search IQ dashboard only shows you top 10 on each analytic section. If you want to obtain a bigger list up to 1000, you can click our “Export” button and download the report data in csv format.
4. Setup Your Search Bar
4.1 Integrate with Existing Search Bar
Search IQ will detect and see if your page has a search bar and associate our autocomplete widget to it. However, there are chances that we cannot detect your search bar correctly and you may not see the autocomplete appeared. If you come across this issue, you can inspect some properties from your search bar’s html code and fill up the info on our admin screen. Take the following search bar html snippet as an example.
<input type=”text” value=”Type keywords…” name=”q” id=”s” autocomplete=”off” class=”searchBox”>
You can see the search bar as a html form input element that has id and name. Enter the id’s value to the “Search box name” field and name’s value to “Search Query Parameter field” as follows:
4.2 Add a Search bar
If your website doesn’t have a search bar, you can follow the options below to add Search IQ’s search bar to your site.
a. Use Search Widget
- Go to your Shopify admin console.
- Look for your theme and click on ‘Customize’
- Enable the search bar for your theme.
- It will automatically install on your site.
Note: This depends on each theme, there is a large spectrum of themes and some themes might not support a search bar, in that case you can contact your theme provider or look at the option b.
b. Manually adding a Search Bar
- Open the Shopify Admin -> Online Store -> … Button -> Edit HTML/CSS (https://help.shopify.com/themes/customization#view-the-customize-theme-page)
- Locate your main liquid file – usually it’s theme.liquid
- Locate the top header section of your liquid
- Copy the HTML code to the theme.liquid template:
<form id=”siq_searchForm”>
<input type=”search” placeholder=”Type here to search…” value=”” name=”s” />
</form> - Hit Save!
5. Customization
5.1 Autocomplete Customization
Steps to follow:
1. Go to Search IQ Shopify app.
2. Select Interface.
3. Select Autocomplete tab.
4. Customize the fields as per your requirements.
5. If there is no customization for any specific element you are looking for, please watch the video above.
5.2 Result Page Customization
Steps to follow:
1. Go to Search IQ Shopify app.
2. Select Interface.
3. Select Results Page tab.
4. Customize the fields as per your requirements.
5. If there is no customization for any specific element you are looking for, please watch the video above.
5.3 Custom CSS Override
Steps to follow:
1. Go to Search IQ Shopify app.
2. Select Interface.
3. Select General tab.
4. Add CSS rules to override in Custom CSS text area.
5. Click Save. Its done!