Profile key
In Tweakwise's Personal Merchandising, selecting the source for the 'profile key'—a unique identifier like customerID or cookieID—is left to you. While non-authenticated users are typically tracked using a cookie-based ID, once a user logs in, switching to an account-specific ID is recommended.
Product key
The 'product key' should correspond to Tweakwise's product number. For features like personalized feeds.
To start using the Personal Merchandising's personal features, such as personal feed, last viewed and previously bought, you need to follow the following steps:
1. Push data to Tweakwise
2. Retrieve data from Tweakwise
Step 1: Push data to Tweakwise
You push the data to the Tweakwise Analytics API using a Javascript plugin. Place the plugin on your site using GTM and push the data that comes into GTM through to the API using the scripts below.
Tracking Script
Place the tracking script on all pages where data needs to be tracked. The tracking script needs to be placed before the push.
var tweakwiseKey = 'NAVIGATOR_KEY'; var profileKey = 'PROFILE_KEY'; (function(w, d, l, i, p, u) { w['_twa'] = l; w[l] = w[l] || []; w[l].push({ 'twa.start': new Date().getTime(), event: 'twa.js' }); w[l].push({ 'twa.instance': i, event: 'twa.init' }); w[l].push({ 'twa.profile': p, event: 'twa.profile' }); var f = d.getElementsByTagName('script')[0], j = d.createElement('script'); j.async = true; j.src = u; f.parentNode.insertBefore(j, f); })(window, document, 'tweakwiseLayer', tweakwiseKey, profileKey, "//navigator-analytics.tweakwise.com/bundles/scout.js");
Tracking Methods
There are two methods for pushing data to the Tweakwise Analytics API:
Product View
The Product View method is meant to measure the views of a product. The push works as follows:
tweakwiseLayer.push({ event: 'productView', data: { profileKey: 'XXX', productKey: 'AA-43242312-1' } });
Purchase
The Purchase method is meant to measure orders. The push works as follows:
tweakwiseLayer.push({ event: 'purchase', data: { profileKey: 'XXX', productKeys: ['AA-43242312-1', 'AA-43242312-2', 'AA-43242312-3'] } });
Search
The Search method is meant to measure search queries. The push works like this:
tweakwiseLayer.push({ event: 'search', data: { profileKey: 'XXX', searchTerm: 'Brabantia' } });
Step 2: Retrieving data from Tweakwise
You need to retrieve the processed data from Tweakwise in order to show it in your shop. You can do this by building a parameter into all relevant pages.
See https://developers.tweakwise.com/ under Navigation for further information.
We've made the retrieval of data extra easy for Magento users.
The Personal Merchandising feature is supported from Tweakwise extension version 3.3.0. We've added a new module to the extension: Personal Merchandising:
When you set it to 'Yes', you can also set in which cookie the profile key is saved:
This should be the same profile key as the one you've supplied in step 1's tracking script.