How do I change my integration type?

  • Updated

You can change your integration type for Product Recommendations by contacting your Customer Success Manager. 

Change the integration type

The Product Recommendations onboarding team works with you to change the integration type, which usually takes a month or one development sprint. To complete the integration process, the team does the following:

Tracking

To configure tracking on your site, you must add a one-line script to every page.

  • To integrate recommendations on a staging, UAT, or test environment – Provide the test environment URL and login details to the onboarding team and add the following script to all pages on the test site: 
    <script type="text/JavaScript" src="<sitename>.uat.productrecs.optimizely.com/tracker/peerius.page" charset="UTF-8"></script>
  • To integrate recommendations on a live site – See Peerius tracking tag for information on integrating recommendations based on the location of your Product Recommendations instance. 

You must add the following IPs to the allowlist to ensure Product Recommendations receives tracking data:

    • Office – 80.87.30.105
    • Prod-Scheduler2 – 89.187.117.121
    • Tracker – 217.114.85.164, 4.158.60.99, and 9.223.57.127 
    • Portal – 217.114.85.199
    • UAT – 89.187.117.115, 80.87.30.107, and 4.208.220.142

Implement the recommendations

Use the following steps to implement the recommendations on your sites:

  • Rendering and styling – Product Recommendations sends recommendations to the sites in a JSON array. Use the information contained in this array to render the products in the desired locations and styling. By default, Product Recommendations sends all available product details received from the product feed. You can also control this and change it to refCodeOnly so that Product Recommendations only sends the ref codes or the SKU numbers of the products. You must access the rest of the information from your systems (for example, from Hybris).
  • Configuration – The onboarding team configures the strategy for the recommendations based on the signed Scope of Work (SoW), considering any specific rules provided. 
  • Review – Recommendations are available for review on the test site and the live site under a special URL parameter: the Show Personalized Recommendations (SPR) key. By adding the parameter of /?spr=1 to your URL, you can review what the recommendations look like when they are live without being visible to your customers. For example, www.sitename.com/?spr=1.
  • Go-live – After reviewing, the onboarding team removes the SPR key, displaying the recommendations to all site visitors.