Appearance
Shopify
With Relewise's app for Shopify, you can get access to Relewise's powerful search, recommendation and personalization features with a few simple clicks - all fully integrated and adapted to your Shopify shop.
To set up the Shopify App, you must have the following:
- A customer relation with Relewise (if you are not yet a customer, please reach out to our sales department)
- A shopify shop running the Dawn theme (the App will support more themes in the future)
- Access to your MyRelewise account and dataset
Shopify App: Installation Guide
To install the Shopify app, find it in the Shopify App Store and click the Install button. Please note that the app costs $10 to install.
The App requests permission to access data in your Shopify shop; if you wish to read more about what Relewise does with this data, follow the explanatory link on the page, or read our Privacy Policy.
Once you have accepted the permissions request, the App will be installed and ready for configuration. Click the Get started button to connect the App to your Relewise dataset.
The App prompts you to log into your MyRelewise account. This login will have been provided to you upon your signing up for Relewise. If you have issues with your login, try resetting your password with the Forgot Your Password feature, or reach out to us if it still does not work.
Shopify App: Configuration
Now comes the time to set up the app. From the dropdown menu, select the dataset you wish to connect to.
Product Id Handler
The App gives you two options for product Id handler. The options are as follows:
- Default: This allows Shopify to set the product Id natively. Shopify Ids are unique across a dataset, and are perfectly suited for Relewise's needs. Be aware that Shopify Ids can change if a product is removed from the shop, and re-added later. Doing so means that any behavioral tracking saved by Relewise for this product will be lost.
- Metafield: This allows you to specify a custom field on your Shopify products to act as productId for Relewise purposes. The benefit to this is that you can maintain the same Relewise productId even if you remove a product from Shopify and add it again later.
To set up a custom metafield, navigate to your Shopify settings, click Custom Data and further on Products. From here, you may set up a custom metafield.
If you wish to use a Metafield as product Id handler, make sure you copy the namespace and name of the metafield exactly.
Upon confirming your choices, you will see an overview of your selections. At this point, the app has begun integrating your product data to Relewise, and you will be able to view them under the entities section of MyRelewise within a few minutes.
Shopify App: Acitvating UI Components
Now that the integration has been set up to pull product data from your shop, it is time to activate the components that allow you to perform personalized search and recommendations. Doing so requires you to activate the UI Components.
Shopify App: API Key
As part of setting up the UI Components, you will need to create an API key that grants permissions for certain functions. The permissions will vary depending on what you wish to do with the app:
| Service | Permission Required | |
|---|---|---|
| Behavioral Tracking | Cart Product View Product Category View Content View | [Settings Preview] |
| Search | Product Search Search Term Prediction Search Collection | [Settings Preview] |
| Recommendations | Purchased with Product Product Viewed After Viewing Product Popular Products | [Settings Preview] |
Once you have your API Key, activate the UI Components by navigating to Online Store -> Themes, and click the Customize button.
A note on themes
Keep in mind that the Shopify App for Relewise only supports the Dawn theme in its current iteration. To use behavioral tracking, search, and recommendations, make sure that you are using the Dawn theme in your Shopify shop.
Navigate to the App Embeds setting, and activate the Relewise UI Components. Then, open the App to configure it.
You will need to supply the Dataset Id and the API key that the app should use. This information can be found in MyRelewise.
Be sure not to use the Master Key from the API Keys page.
Shopify App: Behavioral Tracking
Activating the UI Components will automatically activate Behavioral Tracking for your website. Tracking is the heart and soul of Relewise personalization, and ensures that your users experience the best and most relevant search and recommendation results while using your website.
Shopify App: GDPR Compliancy
To ensure that you are GDPR compliant while using Relewise, we have integrated fully with the following cookie consent providers:
Under App Embeds -> Relewise UI Components, select the cookie consent provider you are using, and hit Save in the top right corner of the screen.
Shopify App: Search
The Shopify App allows you to activate Relewise Search with a few simple clicks. Within the app, search is divided into two parts: The Search Overlay, which offers results as you type, and the Search Results Component, which serves up your search results as a Block in your Shopify Sections.
Ideally, you will want to activate both parts of the Search functionality, to ensure the best user experience.
Shopify App: Search Overlay
To activate the Search Overlay, simply ensure that the API Key has the correct permissions, and then activate the Search Overlay on the same page where you set up the UI Components above. You will find the button to do so immediately below the Cookie Consent selection.
Here, you will also find two options for customization: Color and Accent Color. These settings define the color of both the Search Overlay and the Search Component described below. Use them to to match your search components to the rest of your store theme.
Shopify App: Search Results Component
The second part of setting up Search is to navigate to your Theme Customization, and select the Search results page defined in your Shopify Theme.
Here, add the Product Search block to your page, by selecting Add Section -> Apps -> Product Search (Relewise):
Customize the page with your newly added Search Results Component, and you are ready for your users to utilize Relewise's fast and accurate search of your products.
Shopify App: Recommendations
The Shopify app supports three recommendation types out of the box:
To implement them, navigate to the Theme Customization, and choose the page where you want the recommendation to go. From there, add the desired recommendation to the page in the same way you would add any other Shopify Block to the section of your page:
Once added to your page, the recommendation slider can be configured by clicking on it in the menu. These settings include two things, Displayed At Location and Number of recommendations
- Displayed At Location is used by Relewise to tell where your recommendation was displayed, which we use for purposes of tracking revenue statistics, troubleshooting, merchandising rules, and more. We highly recommend that you include your Display Locations for the recommendations you set up in this way, to ensure that you get the most out of your Relewise integration. If you are unsure about this process, please reach out to us for support and clarification.
- Number of recommendations denotes the amount of recommendations you wish to display in this particular slider. Default value is 4.
From here, customize your page as you see fit, and your shop will be ready to utilize the power of Relewise's recommendations!