Recommendation Onboarding

Personalized recommendations are delivered through Recommendation Widgets. They can be placed in many locations on a website, such as the homepage, product detail page, pre-cart, cart, success page, or other custom placements.

There are several types of Recommendation Widgets, and they can be integrated in different ways depending on how much of the UI and request flow you want to own.

Common steps

These steps are required for all recommendation integrations:

1. Register a new account.
2. Add the Data Collector.
3. Import item data through the Item Feed.
4. Choose an integration option.

See Integration options to decide between:

• Perselio-managed widgets — fastest integration, UI provided by Perselio.
• Browser SDK + native widgets — custom frontend UI, Perselio called from the browser.
• Backend to Perselio API — custom frontend UI, Perselio called from your backend.

Next steps by integration option

Perselio-managed widgets

1. Optionally enable Add-to-cart support.
2. Prepare Recommendation Anchors.
3. Perselio provides a preview using a URL parameter, for example webpage_url?saexp=perselio.
4. Review the preview.
5. Go live.

Browser SDK + native widgets

1. Add the Perselio JavaScript SDK.
2. Build and render widgets in your own frontend.
3. Track rendered recommendation surfaces correctly.
4. Test and go live.

Backend to Perselio API

1. Call the Perselio API from your backend.
2. Build and render widgets in your own frontend.
3. Track rendered recommendation surfaces correctly.
4. Test and go live.