WooCommerce Recommendations

常见问题

Why do I need an account with nToklo?

You need one because user activity data is sent from your site to our servers and stored there, so that we can process the data, understand your user behaviour, and send back recommendations when you request them. The computations have to be run on our servers and, with up to 100,000 events per day supported for free accounts, you really don’t want to have all of that data taking up disk space on your server.

How do I set up an nToklo account?

From within the WordPress admin page, as the first step after activating the plugin. Just go to /wp-admin/admin.php?page=woo-recommendation-settings. You’ll see two buttons – one for new customers and one for customers who already have an nToklo account. Clicking one of these will display a panel with a registration form. Complete the form and you’ll see a confirmation page with a code for you to copy from the panel into the textarea in your settings page, which is highlighted in a yellow panel.

How do I put recommendations or a chart on my page?

Assuming that you have already set up an account

You can place recommendations or charts on your store pages using the nToklo widgets, either on the widgets page by dragging a widget on to a sidebar, or by using shortcodes.

1) Via the widgets menu

This is the easiest way and is recommended for non-technical users. Go to the Appearance > Widgets page and drag either or both of the WooCommerce recommendation widgets on to your sidebar (WooCommerce chart or WooCommerce recommendations). Next you can configure settings for each widget and preview them on your store.

2) Using shortcodes

This method gives you greater flexibility when positioning your widget but is slightly more complicated

For recommendations, you should call:

[ntoklo_recommendations $arguments]

Where $arguments can be any of the following:

Key
Accepted values
Defaults

title
String
Recommended for you

max_items
An integer between 1 – 9.
3

layout

• row_3
• row_4
• column_image_above
• column_image_right
• grid_2_column
• grid_3_column
• grid_4_column

row_3

widget_color

• plum
• pink
• orange
• green
• blue
• dark_blue

plum

These arguments should be passed as query string parameters, such as:

layout=grid_2_column&widget_color=blue&max_items=4

Meaning that call to a recommendation widget might look like this:

[ntoklo_recommendations layout=grid_2_column widget_color=blue max_items=4]

Charts are called in a similar way, but with different options:

[ntoklo_chart $arguments]

$arguments for charts can be any of the following:

Key
Accepted values
Defaults

title
String
Recommended for you

max_items
Integer between 1 and 100
10

tw

• DAILY
• WEEKLY

DAILY

widget_color

• plum
• pink
• orange
• green
• blue
• dark_blue

plum

A call to a chart widget might look like this:

[ntoklo_chart title="Top 10" max_items=10 widget_color=dark_blue]

How do I change the style of the widget?

There are seven layout options for the recommendations widget, and one for the chart widget, as well as 6 colour schemes available to both.

I’ve set up an account and placed widgets on my page, but I can’t see recommendations or charts – why not?

1. Have you waited at least 24 hours since installing the plugin?
2. Has there been any user activity on your site?

If there is very little activity on your site, we won’t know very much about either your catalogue or your user behaviour, so it’s very difficult for us to make recommendations.

My recommendations don’t make sense – why not?

If there is very little activity on your site, we won’t know very much about your product catalogue or user behaviour, so we have to make recommendations based on what we do know.

Yesterday I saw recommendations on my site but now there aren’t any – why not?

If there was no activity on your site yesterday, then we can’t serve recommendations

How do I see what’s been happening on my site?

The nToklo console at https://console.ntoklo.com/login will show you analytics or user activity on your site, including:

The nToklo console shows information about user activity on your store – think of it like Google Analytics, with a retail focus. You can:

1. See a snapshot of all activity on your site on the platform usage tab. How busy are you today / this week / this month?
2. See how well your recommendations are converting on the recommendations performance tab.
3. Find out what the best performing location for recommendations is and reposition them if necessary.
4. View your purchase funnel on the item activity tab, where user browsing history is broken down for you into browse, preview and purchase events.
5. See which times of the day, week and month are the busiest on the user activity tab.
6. See summary figures for today, this week and this month, in relation to the average, busiest and quietest days / weeks / months on on all four tabs.
7. Keep track of real-world events such as promotional campaigns, overlaying the data on the graphs using our annotations.

We’ve packed a ton of features into this console but still kept it easy to use, so why not take a look? Please note that you’ll need an up-to-date browser, such as Chrome, Safari or Firefox (or IE10).