Custom Algorithms

Overview

Custom algorithms are algorithms you create that are based on core algorithms and include filters and fallbacks.

There are two types of Custom Algorithms:

  1. Unbxd-defined: Also known as a Starter Pack, these are a default list of custom algorithms pre-defined by Unbxd. You cannot edit or delete them. You can, however, duplicate them. For the full list of Unbxd-defined custom algorithms and its fallbacks, click here.
  2. User-defined: List of custom algorithms you’ve created. You can edit, delete, and duplicate user-defined algorithms.

UI Components

Field

Description

Create an algorithm based on

Allows you to select the algorithm you want to use for the custom algorithm. The options available are:

  • Recommended For You
  • Top Sellers
  • Bought Also Bought
  • Viewed Also Viewed
  • More Like This
  • Recently Viewed
  • Complete The Look
  • Cross-Sell
  • Category Top Sellers
  • Brand Top Sellers To create a hybrid algorithm, click Create Hybrid.

Observation Period

Allows you to indicate the specify the time duration considered by the algorithm to produce the results.

Custom Filter Rules

Allows you to set specific filters to refine products that will be displayed within the widget. You can create 2 types of filters:

  • Dynamic: When the value of the filter is dependant on the anchor product.
  • Static: When the value of the filter is independent of the anchor product.

Location

When enabled, the recommendations generated by the algorithm are at the city-level.

Fallback

Allows you to choose the alternate algorithm which is used to generate results.
Fallback: ndicates the fallback is based on the algorithm you chose in the Create an algorithm based on field. You can specify the base algorithm you want to use and the number of slots for the widget. Manual Fallback: Indicates the fallback is manual with a static list of products to display. By default, Fallback is enabled. When fallback is disabled, widgets will not display any product recommendations.

Custom algorithms help you make your own custom widget formats.

You can create custom algorithms based on:

  1. Recommended For You
  2. Top Sellers
  3. Bought Also Bought
  4. Viewed Also Viewed
  5. More Like This
  6. Recently Viewed
  7. Complete The Look
  8. Cross-Sell
  9. Category Top Sellers
  10. Brand Top Sellers

Starter Pack Algorithms

These algorithms are Unbxd-defined custom/hybrid algorithms with specific observation periods and pre-defined fallbacks.

Custom AlgorithmObservation PeriodCore AlgorithmFallback
Recommended For YouAll 18 Slots: Recommended For YouRecently Viewed, Top Sellers
Top Sellers30 daysAll 18 Slots: Top SellersRecommended For You, Recently Viewed
Top Sellers by location30 daysAll 18 Slots: Top SellersRecommended For You, Recently Viewed
Optimize for new Users30 daysSlots 1–3: Recently Viewed<br>Slots 4–6: Top Sellers<br>Slots 7–9: Recently Viewed<br>Slots 10–18: Top Sellers
Wisdom Of The Crowd – Users also bought30 daysAll 18 Slots: Bought Also BoughtViewed Also Viewed, More Like This
Wisdom Of The Crowd – Users also Viewed30 daysAll 18 Slots: Viewed Also ViewedBought Also Bought, More Like This
Similar Products (based on category and title)30 daysAll 18 Slots: More Like This
Similar products – Bought Also Bought30 daysSlots 1–3: Bought Also Bought<br>Slots 4–6: More Like This<br>Slots 7–9: Bought Also Bought<br>Slots 10–18: More Like ThisViewed Also Viewed, More Like This
Similar products – Viewed Also Viewed30 daysSlots 1–3: Viewed Also Viewed<br>Slots 4–6: More Like This<br>Slots 7–9: Viewed Also Viewed<br>Slots 10–18: More Like ThisBought Also Bought, More Like This
Complete The Look30 daysAll 18 Slots: Complete The Look
Cross Sell – Similar products30 daysAll 18 Slots: More Like This
Cross-sell30 daysAll 18 Slots: Cross SellMore Like This
Category Top Sellers30 daysAll 18 Slots: Category Top Sellers
Category Top Sellers by location30 daysAll 18 Slots: Category Top Sellers

Create

To create a custom algorithm:

  1. Click Manage > Algorithms.
  2. On the Manage Algorithms page, click Custom.
  3. Click the Create New button. The Create Custom Algorithm page appears.
  4. Type in a name for the algorithm in the title text field.
  5. Click the Create an algorithm based on a drop-down box and select the required algorithm.
  6. To choose the number of slots you want to apply the algorithm on, click the Slots drop-down arrow. By default, the algorithm is applied to all 18 slots.
  7. To create filter rules, click Add within Custom Filter Rules. You can create Dynamic or Static filters.
  8. To enable fallbacks, click the Fallback toggle button. You can choose between:
    • Fallback: Indicates the fallback is based on the algorithm you chose in the Create an algorithm based on field. You can specify the base algorithm you want to use and the number of slots for the widget. To add fallbacks, click Add.
    • Manual Fallback: Indicates the fallback is manual with a static list of products to display.
      Note: By default, Fallback is enabled. When fallback is disabled, widgets will not display any product recommendations.
  9. Click the Save button. The new custom algorithm will appear in the Manage Algorithms table.
    You have successfully created a custom algorithm.

Preview

Specific widgets will require specific information to display recommendation previews.

To preview:

  1. Click Manage > Algorithms.
  2. On the Manage Algorithms page, click Custom.
  3. Click the drop-down arrow for the required user-defined algorithm within the Manage Algorithms table.
  4. Click Preview. The Preview Algorithm page appears.

Depending on the widget, type the User ID, Product ID, or Category ID to view product recommendations.

  1. Click Preview. To exit, click the X.
  2. The preview gives you a visual snapshot of the algorithm.

Edit

Unbxd allows you to edit and modify user-defined custom algorithms.

  1. Click Manage > Algorithms.
  2. On the Manage Algorithms page, click Custom.
  3. Click the drop-down arrow for the required user-defined algorithm within the Manage Algorithms table.
  4. Click Edit. The Create Custom Algorithm page appears.
  5. To edit the title of the algorithm, type in a name in the title text field.
  6. To edit the algorithm, click the Create an algorithm based on the drop-down box and select the required algorithm.
  7. To create a hybrid, click Create Hybrid. To know how to create a hybrid algorithm, click here.
  8. To choose the number of slots you want to apply the algorithm on, click the Slots drop-down arrow. By default, the algorithm is applied to all 18 slots.
  9. To enable fallbacks, click the Fallback toggle button. You can choose between:
    • Fallback: Indicates the fallback is based on the algorithm you chose in the Create an algorithm based on field. You can specify the base algorithm you want to use and the number of slots for the widget. To add fallbacks, click Add.
    • Manual Fallback: Indicates the fallback is manual with a static list of products to display.
      Note: By default, Fallback is enabled. When fallback is disabled, widgets will not display any product recommendations.
  10. Click the Save button.

You have successfully edited your custom algorithm.

Delete

You can delete user-defined custom algorithms.

📘

Note

Algorithms once deleted cannot be retrieved.

To Delete

  1. Click Manage > Algorithms.
  2. On the Manage Algorithms page, click Custom.
  3. Click the drop-down arrow for the required user-defined algorithm within the Manage Algorithms table. Click Delete.
  4. Click Yes, Delete.

You have successfully deleted your custom algorithm.

Duplicate

To duplicate:

  1. Click Manage > Algorithms.
  2. On the Manage Algorithms page, click Custom.
  3. Click the drop-down arrow for the required custom algorithm within the Manage Algorithms table.
  4. Click Duplicate. The Create Custom Algorithm page appears.To edit the title of the algorithm, type in a name in the title text field.
  5. To edit the algorithm, click the Create an algorithm based on the drop-down box and select the required algorithm.
  6. To create a hybrid, click Create Hybrid. To know how to create a hybrid algorithm, click here.
  7. To choose the number of slots you want to apply the algorithm on, click the Slots drop-down arrow. By default, the algorithm is applied to all 18 slots.
  8. To enable fallbacks, click the Fallback toggle button. You can choose between:
    • Fallback: Indicates the fallback is based on the algorithm you chose in the Create an algorithm based on field. You can specify the base algorithm you want to use and the number of slots for the widget. To add fallbacks, click Add.
    • Manual Fallback: Indicates the fallback is manual with a static list of products to display.
    📘

    Note:

    By default, Fallback is enabled. When fallback is disabled, widgets will not display any product recommendations.

  9. Click the Save button.
    You have successfully duplicated a custom algorithm.