How to get a back-URL for Parts-Catalogs

  1. Introduction
  2. What is a back-URL
  3. How to obtain a back-URL
  4. Functionality verification
  5. FAQ
  6. Technical Support

Introduction

The back-URL is an important parameter for Parts-Catalogs integration. It defines where the user is redirected after selecting the auto part. The proper configuration of this parameter ensures the correct parts search on your website

What is a back-URL

The back-URL is a link template that determines where a user is redirected on your website after selecting an auto part in the catalog. The following values are inserted by default into this template:

  • {code} - the selected part number
  • {brand} - the manufacturer brand
  • {vin} - the VIN
  • {lang} - the user’s browser language

How to obtain a back-URL

The easiest way to get a valid back-URL is the following:

  1. Go to your website
  2. Search for any part (for example, by the part number 8W0133843A)
  3. Once the results page loads, copy the page URL from your browser
  4. In the copied URL, replace:
    • the specific part number with {code}
    • the brand name with {brand}

Example:

Original URL after performing a search:

https://yoursite.com/search?article=8W0133843A&manufacturer=AUDI

Transformed back-URL:

https://yoursite.com/search?article={code}&manufacturer={brand}

Functionality verification

To ensure your setup is correct:

  1. Insert the prepared back-URL into your application configuration:
<div id="parts-catalog"
  data-key="YOUR-API-KEY"
  data-back-url="https://yoursite.com/search?article={code}&manufacturer={brand}"
></div>
  1. Test the catalog functionality:
    • Select any auto part.
    • Clicking the auto part should result in a correct redirection to your website.
    • The correct values for the part number and brand must be substituted into the URL.

FAQ

Which parameters can I use in the back-url?
  • {code} - the part number
  • {brand} - the manufacturer brand
  • {vin} - the VIN
  • {lang} - the user's browser language
Why does the redirection go to the wrong address?
  • Check the URL format on your website
  • Make sure the parameter names match those used in your search system
  • Verify that any special characters in the URL are correctly encoded
Can I add additional parameters?

Yes, you can add your own parameters to the URL:

https://yoursite.com/search?article={code}&brand={brand}&source=catalog
I have multiple websites. How do I configure the back-url for each one?

You can use relative paths:

<div id="parts-catalog"
  data-key="YOUR-API-KEY"
  data-back-url="/search?article={code}&manufacturer={brand}"
></div>

Technical Support

💡 If you have problems when setting up the back-URL, please contact our Technical Support team.

📚 Additional materials: