All communication with Clerk happens through the API:
Setting up this communication requires 4 steps, which are outlined in this guide. You need to sync data, retrieve results, visualise these results and add tracking to keep the AI up-to-date.
Syncing data
#
Clerk syncs each webshop domain, called a Store, as its own unique instance, which is accessed by a set of API Keys, found in the Clerk admin:
...How to avoid blocked product images
#
As you probably know, email clients do not support the typical HTML/CSS/JS that run smoothly on all browsers. For this reason, we use a little workaround to produce our Email product recommendations dynamically.
We use a web template engine called Jinja and, through this, we can dynamically print all the product attributes and styles as plain images with links. These pictures will be, then, displayed in your newsletters as product recommendations.
...General
#
To incorporate your embed code for either Live Search or Search Page, you’ll need to access your theme files. To do this, follow the path Theme > theme files > my themes > choose > edit themes > find files
Live Search
#
First, create your Live Search Design and Content in my.clerk.io.
In your header file or live-search header file (likely header.html , or, in this example, header-search.html), the Live Search embed code should be placed.
...
Search & Instant Search
#
Clerk.io’s search function consists of two parts:
From the main menu start by clicking on Getting Started:
1. Create Standard Designs and Content
#
The first thing you need to do, is create Standard Designs and Content.
You can use the Setup guide entitled SEARCH under the Getting Started option, to quickly create Designs and Content that have the same color scheme and style as your webshop.
...Instant Search & Search Page
#
Clerk.io’s search function consists of two parts:
The Live-Search dropdown that is displayed when a customer starts typing.
The Search Page which displays all matching products on a full page.
The Facets will add faceted navigation so your customers can filter the results on the search page.
From the main menu start by clicking on Getting Started:
1. Create Standard Designs and Content
#
The first thing you need to do, is create Standard Designs and Content.
...Instant Search & Search Page
#
Clerk.io’s search function consists of two parts:
From the main menu start by clicking on Getting Started:
Create Designs and Content
#
The first thing you need to do, is create Standard Designs and Content.
You can use the Setup guide entitled SEARCH under the Getting Started option, to quickly create Designs and Content that have the same color scheme and style as your webshop.
...Instant Search & Search Page
#
Clerk.io’s search function consists of two parts:
From the main menu start by clicking on Getting Started:
1. Create Standard Designs and Content
#
The first thing you need to do, is create Standard Designs and Content.
...Instant Search & Search Page
#
Clerk.io’s search function consists of two parts:
From the main menu start by clicking on Getting Started:
1. Create Standard Designs and Content
#
The first thing you need to do, is create Standard Designs and Content.
...Instant Search & Search Page
#
Clerk.io’s search function consists of two parts:
From the main menu start by clicking on Getting Started:
Create Standard Designs and Content
#
The first thing you need to do, is create Standard Designs and Content.
You can use the Setup guide entitled SEARCH under the Getting Started option, to quickly create Designs and Content that have the same color scheme and style as your webshop.
...Instant Search
#
First, create your Live Search Design and Content in my.clerk.io. Then:
- In the Shopware backend, go to Settings → System → Plugins.
- Next to the Clerk.io app, click the three dots … → Config.
- On the plugin page, choose the correct Sales Channel in the top of the app
- Scroll to Instant Search Settings and set Status to Enabled.
- Click Save.
Optional Settings:
- If your Instant Search is not shown correctly, use Dropdown Positioning to choose how the dropdown should be shown relative to the search-field.
- If the Instant Search does not show up at all, write the specific class/id of your search-field in the Input Selector field.
- Choose a custom amount of suggestions, categories and pages to show in the 3 fields
...