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. Make sure products are identifiable on your pages.
4. Import item data through the Item Feed.
5. 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. Mark the rendered blocks so they can be measured — see Marking Rendered Recommendations.
4. Test and go live.

Backend to Perselio API

1. Decide how your backend obtains the visitor's identity — see User Identification. This is the step most backend integrations get wrong, so do it before writing the API calls.
2. Call the Recommendation API from your backend.
3. Build and render widgets in your own frontend.
4. Mark the rendered blocks so they can be measured — see Marking Rendered Recommendations.
5. Test and go live.