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.
Set up the settings at default configuration level:
- Go to Stores > Configuration > Catalog > Tweakwise.
Step 1: Link Tweakwise instancekey
In the General section, enter the instance key provided by Tweakwise. The field is labelled "Authentication key".
Step 2: Activate Tweakwise for search
In the Search section, 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
In the Autocomplete section, activate Tweakwise for the search suggestions in your shop.
| Setting | Input | Description | Recommended |
|---|---|---|---|
| Enabled | Yes/No | Activate Tweakwise suggestions | Yes |
| Use Suggestions Autocomplete | Yes/No | Uses the latest autocomplete module in Tweakwise. | Yes |
| Show parent category | Dropdown | Show parent category to category suggestions | Yes |
| Stay in category | Dropdown | Only show suggestions from the currently viewed category. | No |
Step 4: Activate Tweakwise on the category pages
Tweakwise Commerce Pages
In the layered navigation section, 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)
In the SEO section, 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
Tweakwise Recommendations
Before you can activate this section, 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: Step 7: Activate Personal Merchandising
Tweakwise Commerce Pages + Merchandising level Expert
| 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. | - |