Identifying high return probability orders

Customers often order multiple items with the intention of returning some of them. This is often the case for fashion products, where customers order multiple sizes or colors to try them on and return the ones that don't fit. The high return probability identification is a (optional) feature that you can use to evaluate the cart and determine if the cart contents are likely to be returned, and only offer reusable packaging if it is likely to be returned. This makes it more cost-efficient to use reusable packaging as there are almost no empty returns.

High value carts

To offer reusable packaging for carts exceeding a certain value (e.g. 500€), you can set the cartValueThreshold property to the desired value.

const heyCircleUI = new HeyCircleUI((checked: boolean) => {}, {
    ...
    cartConfig: {
      cartValueThreshold: 500,
      ...
    },
    ...
}

Reusable packaging will then be offered to the customer if the cart value exceeds the threshold.

High quantity carts

To offer reusable packaging for carts with a high quantity of items (e.g. 10 items), you can set the cartItemQuantityThreshold property to the desired value.

const heyCircleUI = new HeyCircleUI((checked: boolean) => {}, {
    ...
    cartConfig: {
      cartItemQuantityThreshold: 10,
      ...
    },
    ...
}

Reusable packaging will then be offered to the customer if the cart quantity exceeds the threshold.

Similar items

To offer reusable packaging for carts with similar items, you can set the uniqueSharedVariantProperty property to compare items by their "id" or by their "name".

const heyCircleUI = new HeyCircleUI((checked: boolean) => {}, {
    ...
    cartConfig: {
      uniqueSharedVariantProperty: 'name' | 'id',
      ...
    },
    ...
}

Reusable packaging will then be offered to the customer if the cart contains similar items. Example cart:

• Runner's shoe | 40 | White
• Runner's shoe | 40 | Black

Here you would set the uniqueSharedVariantProperty to 'name' and the uniqueSharedVariantPropertySeparator to '|', so that the items are considered similar.

You can set different thresholds and properties to evaluate the probability:

• cartValueThreshold: The cart value threshold for the active choice popup
• cartItemQuantityThreshold: The cart item quantity threshold for the active choice popup
• returnProbabilityThreshold: The return probability threshold percentage (between 0 and 100). If you want to offer reusable packaging if there is a 95% return probability, set this value to 95.
• uniqueSharedVariantProperty: The attribute of the cart items that is shared between the items. This can be the name or the ìd of the product.
• uniqueSharedVariantPropertySeparator: (Optional) A separator for the unique shared variant property. This is only needed if the unique shared variant property is a combination of multiple attributes. This can vary depending on the product data structure.

const heyCircleUI = new HeyCircleUI((checked: boolean) => {}, {
    ...
    cartConfig: {
      cartValueThreshold: 10,
      cartItemQuantityThreshold: 5,
      returnProbabilityThreshold: 95,
      uniqueSharedVariantProperty: 'name' | 'id',
      uniqueSharedVariantPropertySeparator: '-',
    },
    cart: {
      totalValue: 100, // Initial total value of the cart
      currency: "EUR", // Currency of the cart
      items: [
        {
          id: "1", // The id of the product
          name: "Product - 1", // The name of the product
          value: 100, // The value of the product in cents
          quantity: 1, // The quantity of the product
        },
      ],
    },
    ...
}