Upsell & Cross-Sell

Usage

Use the following code to retrieve product recommendations data

Example

window.FastSimonSDK.productRecommendationByWidget({
    productID: "1233231",
    withAttributes: true,
    recent:["12345","67890"],
    widgetsIDS: ["123457878"],

    callback: (response) => {
        // draw widget
    }
});

Options

Option	Type	Description
productID	string (required)	response will be based on this product
callback	(Response) => void (required)	callback to handle the results
widgetsIDS	string[] (required)	An array of widget IDs from the Fast Simon dashboard to specify which widgets should return recommendations.
recent	string[]	add tracked recent product ids, example: ["2323","123"]
withAttributes	boolean	include product attributes in the response

Response

TypeScript Typing

interface Widget {
    productID: string
    widgetID: string
    categoriesIDs: string[]
    payload: Product[]
    sources: string
    title?: string
}

interface Response {
    action: "recommendations",
    payload: Widget[]
}

Reporting Implementation (must for analytics)

Please follow the guideline to report shopper behaviour on the recommendation widget in order to get accurate Analytics in the Fast Simon dashboard as well as greater personalized accuracy

1. Products Viewed From Upsell/Cross-Sell - report whenever product is clicked from the widget
2. Report Products Shown - report when recommendation products are displayed to users

Report Recommendations Products Shown

Use this event to report when products from recommendations are shown to users for analytics and personalization tracking.

Example

window.FastSimonSDK.event({
    eventName: window.FastSimonEventName.RecommendationsProductsShown,
    data: {
        products: [
            {
                "l": "Women's Classic Nylon 89 Shoes",
                "c": "USD",
                "u": "/products/reebok-womens-classic-nylon-89-shoes-muted-clay-pink-clay-leisure-blue-132131",
                "p": "90.00",
                "t": "https://cdn.shopify.com/s/files/1/0862/7834/0912/files/JPG-100230796_SLC_eCom_large.jpg?v=1751303079",
                "id": "9891167699248",
                "sku": "100230796-8.5",
                // ... other product properties
            },
            {
                "l": "Another Product Name",
                "c": "USD", 
                "p": "45.00",
                "id": "9891167699249",
                // ... other product properties
            }
        ],
        widget_id: "related-products-widget", // optional
        sourceProductID: "product-page-id-123" // optional
    }
});

Data Properties

Property	Type	Description
products	Product[] (required)	Array of recommended products that were shown
widget_id	string (optional)	Identifier for the recommendation widget
sourceProductID	string (optional)	The source product ID (usually current product page)

Product Object Properties

Each product in the products array should include:

• id: Product ID
• l: Product label/name
• c: Currency
• p: Price
• u: Product URL
• t: Thumbnail image URL
• sku: SKU identifier
• Other product attributes as needed

When to Use

Use this event to report when recommendation products are displayed to users:

• Product Page Recommendations: When related/similar products are shown
• Upsell/Cross-sell Widgets: When recommendation widgets render products
• Cart Recommendations: When products are recommended in cart/checkout
• Category Page Recommendations: When recommended products appear on collection pages

Best Practices

1. Call after products are actually visible: Only report when products are rendered and visible to users
2. Include widget_id: Helps distinguish different recommendation contexts
3. Include complete product data: Ensure all required product properties are present