Conversion Flows
The SDK supports two conversion modes: Redirect and Instant Checkout.
Redirect Flow
Use redirect mode when:
- The host application already has a strong PDP experience
- Additional merchandising context is needed before checkout
- The customer should remain in the existing browsing journey
Redirect Lifecycle
Widget resolves products
The SDK fetches promoted products from the advertisement service based on the placement configuration.
User interacts with conversational prompt
The user engages with the conversational widget, exploring product recommendations.
User selects a product or CTA
The user taps on a product card or call-to-action button.
SDK triggers navigation delegate
The SDK invokes the configured navigation handler or route open function.
Host application opens the product detail page
The user lands on the PDP within the host application for full product details.
Instant Checkout Flow
Use instant checkout mode when:
- The goal is low-friction conversion
- The promoted item is straightforward to purchase
- Variant choice, shipping, and payment can be completed in a compact flow
Instant Checkout Lifecycle
Widget resolves products and commerce payload
The SDK fetches promoted products along with the commerce data needed for purchase.
User selects a purchase CTA
The user taps a buy or checkout call-to-action within the widget.
SDK opens embedded checkout container
An in-place checkout sheet or modal is presented without navigating away.
User confirms options and completes purchase
The user selects variant, shipping, and payment options and confirms the order.
SDK emits purchase outcome events
The SDK fires checkout_completed or checkout_abandoned events for analytics.
Choosing a Conversion Mode
Start with redirect mode if your checkout dependencies are not yet unified. Use instant checkout for high-confidence, low-friction purchase scenarios.
| Criteria | Redirect | Instant Checkout |
|---|---|---|
| Existing strong PDP experience | ✓ | |
| Low-friction single-product purchase | ✓ | |
| Needs additional merchandising context | ✓ | |
| Compact variant/shipping/payment flow | ✓ | |
| Keep user in browsing journey | ✓ | |
| Maximize conversion rate | ✓ |