Magento

This guide will help you configure the Magento Tweakwise Master Extension. All options depend on the level you purchase from Tweakwise. In addition, you can choose whether you do the settings per storeview or use the default configuration.

Step 1: Link Tweakwise instancekey

Go to the General module and enter the instancekey provided by Tweakwise under Authentication key.

Step 2: Activate Tweakwise for search [Level Standard and higher]

In the Search module, activate Tweakwise on your search results page. If you have several languages, set them up separately for each language.

Setting

Input

Description

Recommended

Enabled

Yes/No 

Activate Tweakwise on the search results page.

Yes

Searchbanners enabled             

Yes/No

Activate the ability to show decorated Searchbanners in Tweakwise in the shop.

Yes

Tweakwise search template to use in search results 

Dropdown

Select the filter template that you created in Tweakwise to be used on the search results page, if it differs from the default filter template.

* Default template

Search language             

Dropdown

Select which language should be used for the search function so that the conjugations of the correct language can be included. You can set this for each storeview. Are you missing a language? If so, contact your Onboarding Specialist.

Correct language

Step 3: Activate Tweakwise for the search suggestions [Level Standard and higher].

In the Autocomplete module, activate Tweakwise for the search suggestions in your shop.

Setting

Input

Description

Recommended

Enabled

Yes/No 

Activates Tweakwise autocomplete

Yes

Use Suggestions Autocomplete             

Yes/No


Uses the latest autocomplete module in Tweakwise.
With separate category and property suggestions.

Yes

Show parent category             

Yes/No

Show parent category to category suggestions

Yes

Stay in category             

Yes/No

Only show suggestions from the currently viewed category.     

No

 

Step 4: Activate Tweakwise on the category pages [Level Medium and higher].

In the layered navigation module, activate Tweakwise on the category list page. The following settings are recommended:

Setting

Input

Description

Recommended

Enabled

Yes/No 

Enables Tweakwise on category list pages.

Yes

Hide facets with only one option

Yes/No

Do not display filters once there is only one filter value.Tweakwise has settings to set this per filter, when you set this setting to ‘yes’, Tweakwise settings are ignored.

No

Use default Magento filter renderer

Yes/No

Adopt front-end settings from Magento itself instead of display settings from Tweakwise. This therefore ignores the settings from the Tweakwise app and uses Magento's default settings. When set to ‘yes’, SEO and Ajax do not work.

No

Ajax filtering

Yes/No

Filter actions are performed using Ajax instead of navigation. This means that only the products are updated and not the entire page is refreshed.

Yes

Filter form             

Yes/No

Provide a button near the filters that allows you to specify that filter actions are only executed after clicking the button instead of real-time.

No

Filter url query arguments

Dropdown

Determine whether URL parameters are also added to the requests and thus sent along to Tweakwise. Three options:

  • Don't filter: all parameters are sent along to Tweakwise
  • Specify: determine which parameters are sent along. When this is selected, an extra option appears in which the parameters you want to exclude can be selected.
  • Regex: Do this on the basis of a regex.

Don’t filter

URL Strategy

 

Dropdown

Define how you want the URLs to be constructed when using filters. Two options:

  • Query params (?colour=Red&size=m): this adds the whole parameter.
  • SEO path slugs (color/red/size/m): this adds the selected filter and the selected filter value neatly slash-separated to the url.

SEO path slugs

Step 5: Setting up SEO [Optional]

With the SEO module, you decide which filters are and are not indexable. These settings can be configured for the entire shop, but it is also possible to configure them at category level. You will find Tweakwise settings for this under Category > Catalog. The category-level settings overwrite the settings you make here.

Setting

Input

Description

Recommended

Enabled

Yes/No 

SEO enable. Indexing filter values. If you set this module to Yes, all filters are no longer indexable.

Yes

Filter Whitelist             

Text field

Select the filters that should always be indexed.

-

Filter Values Whitelist

Text field

Select the filter values that should always be indexed. Note: The filter must also be between the ‘Filter whitelist’. Entering certain values here will exclude other values from this filter.

-

Max allowed selected filter

Numeric

Maximum number of filters allowed to be indexed.

2

 

Step 6: Activate Tweakwise recommendations [Level Recommended and above]

Before you can activate this module, it is important that certain things are set up in the Tweakwise app. Contact your Onboarding Specialist to get the additional information through. These settings can be set up for the entire shop, but it is also possible to set them up at category level. Under Category > Catalog you will find the Tweakwise settings for this. The category-level settings overwrite the settings you make here.

Setting

Input

Description

Recommended

Related products enabled

Yes/No 

Activate the related products from within Tweakwise App. From Tweakwise, you can use up-sell and/or cross-sell templates for this. This setting applies to showing related products on every PDP from Tweakwise. This replaces the related products from Magento with those from Tweakwise.

Yes

Default related products template

Dropdown

Select the desired recommendation template from Tweakwise here. We recommend using the group code here. This ensures that you can make adjustments at category level in Tweakwise.

-Group code-

Default related products group code

Text field

Enter the name of the group code in Tweakwise here.

-

Upsell enabled             

Yes/No

Activate upsell from the Tweakwise app. This will replace the upsell from Magento with that from Tweakwise.

Yes

Default upsell template

Dropdown

Choose the desired recommendation template from Tweakwise here. Recommend using the group code here. This ensures that you can make adjustments at category level in Tweakwise.

-Group code-

Default upsell group code

Text field

Enter the name of the group code in Tweakwise here.

-

Featured products enable 

Yes/No

Activate featured products from within the Tweakwise app. In Tweakwise, this is called ‘Featured products’. These products can be deployed anywhere using a widget.

Yes

Default featured product template

Dropdown

Choose the featured recommendation rule created in Tweakwise.

-

Only show products from current category for featured products

Yes/No

Set this setting to Yes if you only want to show featured products from the current category.

Yes

Crosssell enabled

Yes/No

Shows cross-sell product in cart. This overrides the default cross-sell products in the cart.

Yes

Default crosssell type

Dropdown

Choose whether you want to use a cross-sell template or a featured product template from Tweakwise.

 

Default crosssell template

Dropdown

Choose the cross-sell rule you want to use for the entire shop. Or choose -Group code- to use group codes (only available when using crosssell template).

 

Default crosssell groupcode

Text field

Enter the name of the group code in Tweakwise here.

-

Limit max number of products for group codes

Numeric

Specify the maximum number of products to be shown when using a grouping code.

-

Step 7: Activate Personal Merchandising [Additional module and Level Premium].

In the Personal Merchandising module, activate the operation of this module.

Setting

Input

Description

Recommended

Enabled

Yes/No 

Activate personal merchandising

Yes

Cookie name

Text field

Name of the cookie in which the Tweakwise profile information can be found as entered in the measurement script.

-

 


Has reading the relevant articles not helped you?