Skip to main content

API Details

info

To open the API details right click on an API and select edit or doubleclick on an API.

BikeFeed

Add additional URL parameters

You will find the mapping in the API Details under BikeFeed

Bike Feed Menu

Scroll down until you can see Product URL parameters. Product URL parameters

Available options

You can set one or more product URL parameters if you like. The key name is free of choice. The preselection of available fields for the values are:

  • &{originCode}: originally requested product code
  • &{newCode}: product code of the recommended bike
  • &{bodyHeight}: entered body height of the customer
  • &{inseam}: entered inseam of the customer
  • &{armLength}: entered arm length of the customer
  • &{gender}: selected gender of the customer
  • &{optimizedBodyHeight}: calculated height based on all values
  • &{customId}: whatever you set up in the customId column of the bike feed mapping
  • &{price}: price of the recommended bike
  • &{priceSale}: sale price of the recommended bike

Optional you can add any additional fields from your feed information as well. Additional properties

tip

&{newCode} might be the easiest and most reliable options to identify the bike to select as this is the returned product code.

Add parameters

To add the parameters to the link URL simply add a key value pair and click the plus icon. By default parameters will be added to the URL with a prefixed &. You can replace this by selecting the checkbox Hash which results in adding the properties with an prefixed #. Product URL parameters

Finish with the Save Button. Product URL parameters

Result

Once additional parameters have been mapped and saved links to new tabs from your Recommendation Engine will include these parameters. This might look the following:

https://wwww.yourbikeshop.com/bikes/mtb/scott-scale-980&variationId=&{variationId}#gtin=&{newCode}

&{variationId} and &{newCode} will be replaced in the widget with the information from your provided feed.

In the Recommendation Engine, this results in the following URL.

https://wwww.yourbikeshop.com/bikes/mtb/scott-scale-980&variationId=1063202#gtin=7615523114986.