1. Summary

The module integrates the Nosto marketing automation service, that produces personalized product recommendations on the site.

The module adds the needed data for the service through Drupal blocks. There are two kinds of blocks added; tagging blocks and element blocks.

Tagging blocks are used to hold meta-data about products, categories, orders, shopping cart and customers on your site. These types of blocks do not hold any visual elements, only meta-data. The meta-data is sent to the Nosto marketing automation service when customers are browsing the site. The service then produces product recommendations based on the information that is sent and displays the recommendations in the element blocks.

Element blocks are placeholders for the product recommendations coming from the Nosto marketing automation service. The blocks contain only an empty div element that is populated with content from the Nosto marketing automation service.

Drupal Project page and Download

You can find Drupal Project and download link here.

Dependencies

Drupal version 7.x and Ubercart version 3.x.

 

2. Installation and Nosto module configuration

Start the installation by logging in to your Drupal admin and go to Modules > Install module

In the next screen either install directly from an FTP server or upload the module package

 

If installation was made accordingly you’ll get a following message. Click Enable newly added modules.

 

Browse down the list to Ubercart – Extra and look for Nosto Tagging and enable the module by checking and saving the settings on the bottom of the page.

 

Browse back up and configure the module settings by clicking configure

 

Insert the accountID into the text-field and save. The product tagging settings define how the module can access the data from your site, required for Nosto to function properly. Please match these with your Drupal structure.

After clicking save  the script is positioned in the page template and Nosto can now track traffic and visitors, but in order to interpret the content of pages correctly we need to tag Html objects on different page types. In Drupal this is done with tagging blocks.

Tagging blocks are used to hold meta-data about products, categories, orders, shopping cart and customers on your site. These should be placed on the correct pages in order for the Nosto to be able to function properly.

Element blocks are used as placeholders for the product recommendations coming from Nosto. Element blocks will feature visual elements visible for visitors browsing the site.

Technically the blocks contain only an Html div element, which will load the visible recommendation when the page itself is loaded.

Navigate to menu > Structure > Blocks

 

Look for Nosto Tagging tag blocks, five altogether. Enable the elements and select region including the meta-data sent to Nosto. By default, this is Content.

 

Enabling Nosto Elements is done by enabling Nosto Tagging element. In the example we enable pre-defined element product page 1. Click configure to edit settings

 

In the element settings pay attention to Nosto ID. This is the unique ID for the Nosto recommendation element. Equivalent element by ID is also in your Nosto account under menu Campaigns > Recommendation slots  where design, context and recommendation settings are set for the recommendation. On the contrary, in Drupal admin you define the display settings for the element.

Edit the display settings for the recommendation as you may and save the block.

 

Next browse any product page and insert parameter: ?nostodebug=true&nostopreview=true in your browser’s address field after the page url. Example: www.acme.com?nostodebug=true&nostopreview=true > click any product.

If you have done the implementation correctly the debug-toolbar should appear and also the recommendation element.

 

When you click the show debug info you can easily debug if a detail is missing or erroneous. Required missing or erroneous details are highlighted in red.

3. Top sellers element

A “Top Sellers” page and a corresponding menu item are created by the Nosto module. The page features the Nosto element displaying the top selling products in the store. Enable the block similarly to other Nosto elements.

4. Customising the installation

Note that you need not use all the default blocks and that you can change what recommendations are shown in which block.

You can also add your own element blocks by creating new Drupal blocks, or modifying template files, and adding the div-element: <div class=”nosto_element” id=”{id of your choice}”></div>

Further instructions on how to configure the module can be found in the uber-install.txt file

Did this answer your question?