USER GUIDE

Recom.ai – is a powerful yet handy internal marketing tool to help you increase conversions by providing smart and configurable upsell and cross-sell recommendations.

In simple words the app delivers non-intrusive product recommendations on nearly any page. The app places its widgets on the pages you select and displays matching items there.

After you install our app, you will see 8 tabs on the left column:

1. Home
2. Widgets
3. Analytics
4. Templates
5. Billing
6. Setting
7. User Guide
8. Get Help

Recom.ai Home screen is a dashboard with general statistics on the app’s performance.

Status indicator reflects the current state of the app. means the app is ready to work, – see additional notifications on Home screen and / or contact Support . 

The main screen demonstrates pages with widgets assigned to each. Next to each widget there’s basic stats on it: views / clicks

Each page has additional action buttons available on hovering over the block:

Live view – takes to the store’s frontend to see how the widget looks like on the live site

Total Impressions stands for all views from all widgets for the past 30 days

Total Clicks is a meter of clicks in all widgets for the past 30 days

• Introduction
• Create a widget
• Set rules for the widget recommendations
• Configure the look of a widget
• Add widgets to pages

Introduction

Widget is a form of presentation of the recommendations on your frontend, i.e. a design element with products in it. Widgets are added to the store’s pages by Recom.ai.

The widgets screen is the main working space that hosts all currently active widgets. On this screen, you can create widgets, assign widgets to pages, and customize the widgets’ look and feel, color, etc.

Create a widget

To create a new widget:

1. Last Viewed – log of all products viewed by the page visitor recently
2. Similar Look – AI-driven widget. Automatically analyzes the look of the viewed item and displays recommendations with similar looking / matching products
3. Trending Now – recommends most popular products for the past 30 days
4. Trending Now from the same category – recommends most popular products for the past 30 days within the category of products currently viewed by the customer 
5. Top Sellers – best selling items of the store
6. Top Sellers from the same category – best selling items of the store within the category of products currently viewed by the customer
7. New Arrivals – products new to your inventory
8. New Arrivals from the same category – products new to your inventory within the category of products currently viewed by the customer
9. Bought Together – products purchased together with the product currently viewed by the customer
10. You may also like – basic widget with configurable recommendations. By default shows random items
11. Custom – flexible widget to address any needs. Can be configured from the scratch to show specific recommendations

Rule configuring screen

1. Rule is a combination of conditions which tells the app what to display in a widget as recommendation.
2. Attributes are used to group up or differentiate products. Collection, tag, type, title – all these are attributes
3. Condition is a combination of attribute and a logical operator (for example, “equal to”, “is not”, “less than”)

After you’ve added the widget, you’ll see a screen to configure the widget rules. In this section, we’ll go through how to set the rules that will determine what the widget will display as product recommendations.

1. Eye – enable / disable the rule
2. Penсil – edit the rule
3. Bin – delete the rule

By default the rule shows any products for any products – i.e. the recommendations are random.

Edit takes inside the rule configs. All conditions that tell the widget which products to pick and with which product to demonstrate are set here.

On this screen, you’ll see the rules. Each rule consists of five parts:

1. Rule name: In the screenshot above, the rule name is Related Products. You can click on the pencil icon to edit the rule name.
2. Rule status: The default rule is Shown for any product, Displays all products. This means that the recommendations are random.
3. Configuration:
   • Widget title: The widget title overrides the general rule title when this specific rule is in effect.
   • Max products to display: You can enter a number here to show the maximum products that the rule will display.
   • Sort products by: This configures the sorting order.
4. Which product pages will display this widget: This refers to the product/products that will trigger the recommendations.
   • All products mean the widget will appear with any product.
   • Specific products list the items which will activate this specific rule.
   • All conditions/Any condition tells the app to either consider all the conditions before launching the widget.
5. Which products will be displayed in the widget: The actual recommendations are set here. This part of the rule defines what exactly to pick from your inventory and show as product recommendations as defined in parts 1-4 above.

+Add new condition opens a series of dropdown menus where the required condition can be configured and saved.

Once you are done with setting the rule configurations, the app will know the exact product or product group that the widget will recommend.

For each of the rule configurations, you can check the effect of the condition by clicking Preview.

When you’re done editing, click the Save button at the top right corner.

Congratulations! The rule will be implemented, and your widget will be live.

Configure the look of a widget

Now the widget has a rule and it’s time to tweak the look of the widget.

Widget Title sets the text site visitors will see above the slider with the recommendations.

Template selector has a dropdown with available pre-built templates along with the Default Template which fits most store themes and has all available features included.

Product Limit defines the max amount of recommended items the widget will host. Leave it blank to leave it limitless.

Placement Type and Path configs are responsible for moving the widget on the page. It is based on element classes and id’s on the page structure. Type dropdown defines the position of the widget and Path tells the app to which element on the page the widget must be anchored.

These are advanced features for users familiar with HTML / CSS basics. Our Support team will always advise the correct settings if you don’t feel confident enough.

Options below help configure the look of the widget

All configs are instantly previewed right below the customization options

Once all rules are set the performance of the widget can be checked in Widget Content Preview system. Enter the title of the reference product and see what the app finds. These recommendations will populate the widget.

Populating pages with Widgets.

Add widgets to pages

Widgets screen lists all widgets that are currently created. You have to perform one last step to add the widgets to your pages. To do so, hover next to any widget and you will see the + Add menu with the list of pages you can put your widget on. Select a page, and your widget will be added to that page.

Analytics module of Recom.ai pulls data from all widgets and represents the performance in graphical and numerical forms: diagrams and numbers.

Main filters include dropdown with:

1. Active widgets
2. Metric – report by impressions (views), clicks on recommended products, Add-to-cart clicks, purchases and sales
3. Date range for the reporting period.

Below the graph there is a table chart view with the stats.

Template is a designed layout of widget on the frontend. There is a Default Template which fits most themes and several more templates designed to fit most popular themes. From this page you can clone templates and code custom ones if needed. This section of the app’s admin panel is for developers and code-savvy users mostly.

The Billing screen is related to the current plan and billing history. It shows the detailed breakdown by daily views, by 30 days and the actual bills by the app.

Settings screen has 3 features:

1. IP/DDNS exclusion – Recom.ai utilizes Usage-based billing model. It counts impressions / views i.e. appearance of widgets on the pages to define the shifting plans. Submit your IP for an exclusion to make sure your own views are not counted when you visit your store to check the effect of your rules and widgets.
2. Add snippet to active theme – a specific feature used only when you change your active theme. In most cases adding our snippet to the new theme is automatic but sometimes manual action is required.
3. Sync products forces update of your stock and collections. The app monitors all changes to your collections but it might take time to update everything. This is a manual option to speed the process up.

User Guide is where this guide lives. Refer to it whenever you need to fresh up the basics or proceed to Get help to contact our support.

You can contact our support team for any queries on this page. We are happy to help you with anything, so feel free to message us if you have any questions.

Happy selling!

For easy reference, here are the definitions of terms:

1. Widgets. A widget displays the recommendations for products on your frontend. It is represented as a slider with products in it.
2. Rules
   • Rule is a set of conditions that you can configure to tell the app what to display in a widget as product recommendations.
   • Attributes are used by Shopify to group together or differentiate products. Some examples of attributes are “Collection”, “tag”, “type”, and “title”.
   • Condition is a combination of attribute and a logical operator (for example, “equal to”, “is not”, “less than”).
3. Templates. A template is a designed layout of how the widget will look like on the frontend. There is a Default template which fits most themes and several more templates designed to fit other popular themes.