Our recommendations offers two powerful ways to boost your sales: Featured Products and Upselling & Cross-Selling.

The Recommendations Plugin can be used to implement a standardized version of the Tweakwise recommendations in your platform. It supports both featured and up- and cross sell recommendations.

💡

Tip

To learn more about configuring featured products, read our product guides on featured products.

Installation

Make sure you have followed the Installation guide.

The Recommendations Plugin needs to be initialized manually. You can choose to show either:

• featured: typically used for a fixed set of products on a homepage or other content/landing page.
• related: typically used for lists of related, crosssell or upsell products on product detail pages.

Featured recommendations

Featured recommendations are typically used for a fixed set of products on a homepage or other content/landing page.

To target these recommendations use the featured option.

Copy the following snippet into your HTML. The snippet should be placed on the position of where you want the recommendations to appear.

<div id="featured-recommendations"></div>

<script>
  window.addEventListener("twn.recommendations.ready", function () {
    window.tweakwiseRecommendations({
      output: "#featured-recommendations",
      instancekey: "INSTANCEKEY",
      featured: {
        id: "ID"
      }
    });
  });
</script>

Next, replace INSTANCEKEY and ID with the correct values.

• The INSTANCEKEY should be replaced with your own instance key. You can find it in Tweakwise on the Tweakwise App Dashboard.
• The ID should be replaced with the unique featured recommendations ID. You can find this ID in Tweakwise.

Related recommendations

Related recommendations are gnerally used for displaying a list of related products, like up- and cross sell products.

To target these recommendations use the related option.

Copy the following snippet into your HTML. The snippet should be placed on the position of where you want the recommendations to appear.

<div id="related-recommendations"></div>

<script>
  window.addEventListener("twn.recommendations.ready", function () {
    window.tweakwiseRecommendations({
      output: "#related-recommendations",
      instancekey: "INSTANCEKEY",
      related: {
        productId: "PRODUCTID",
        groupKey: "GROUPKEY"
      }
    });
  });
</script>

Next, replace the INSTANCEKEY, PRODUCTID and GROUPKEY with the correct values:

• The INSTANCEKEY should be replaced with your instance specific key.
• the PRODUCTID should be replaced with the ID of the product for which you want to show recommendations.
• the GROUPKEY should be replaced with the group key that is linked to the up- and cross sell recommendations. You can find this key in Tweakwise.

Important: the product should be available as item in Tweakwise.

Notes

• The featured & related options are mutually exclusive. If used in combination, featured has precedence.
• For Lightspeed implementations, use product.vid as related.productId.