Link to a specific configuration in the configurator
Vehicle ad platforms want a landing page for one exact car — a model in a particular colour and trim, at a particular price. You can build a configurator URL that opens already set to that configuration, so the visitor lands on the car in the ad instead of a blank configurator.
Everything is done in the URL. No dashboard setup is required.
Steps
- Start with the configurator's normal address, for example
https://<your-domain>/<locale>/configurator/<configurator-code>. - Add any of the parameters below, separated by
&. The first one is joined with?. All of them are optional and can be combined. - Open the finished URL to check it, then give it to your ad platform.
Choose the car — prefill
A JSON object of configurator option codes, URL-encoded. The keys are the configurator's field names and the values are its option codes; both come from the configurator itself.
?prefill={"badge":"_More","exterior":"_SparklingBlack","wheels":"_Wheels_20"}
Choose the customer type — customer_type
Opens the configurator priced for a private or a business buyer.
| Value | Meaning |
|---|---|
consumer, personal, private |
Private buyer |
commercial, business |
Business buyer |
?customer_type=business
Choose the finance product — preferred_finance_type
The type of finance product to select, or cash for "No financing".
Always set this on an ad landing page. Without it the configurator picks the default product, which is decided by the showroom's finance settings — it may be the lowest-priced product, the first by display order, or "No financing" if the showroom defaults to cash. A finance configuration applies to whichever product is selected, so if you don't pin the product you can't be sure the price in the ad is the price on the page.
?preferred_finance_type=matrix_lease
Choose the finance configuration — finance_config
The contract term, annual distance and down payment, as a base64-encoded JSON object:
| Key | Meaning |
|---|---|
term |
Contract length, in the unit the finance product uses (usually months) |
km |
Allowance per year |
deposit |
Down payment, in cents — 500000 is 5,000 |
Every key is optional; anything you leave out keeps the finance product's own default. Encode the JSON as base64 and pass the result:
{"term":36,"km":15000,"deposit":500000}
?finance_config=eyJ0ZXJtIjozNiwia20iOjE1MDAwLCJkZXBvc2l0Ijo1MDAwMDB9
The configuration applies to whichever finance product ends up selected, so pair
it with preferred_finance_type — see above. It has no effect while "No
financing" is selected, which has no term, distance or down payment: don't
combine it with preferred_finance_type=cash, and don't leave the product
unpinned on a showroom that defaults to cash. The values aren't lost either way
— they appear as soon as a finance product is selected.
Result
Opening the URL shows the configurator already set to your configuration, with the finance calculator on the term, distance and down payment you asked for. The visitor can still change anything — their changes are kept from that point on.
If a value doesn't apply to the finance product that gets selected — a term it doesn't offer, a distance outside its range, a down payment above its maximum — the configurator falls back to the nearest valid value rather than showing a price it can't quote. This means a link keeps working after a finance product's terms change, so it's worth re-checking a long-running ad's landing page whenever finance terms are updated.