Table of Contents
1. Overview
2. Installation Instructions
3. Changelog
Overview
Adding the Modal script is a simple process, requiring adding our script tag to the header and a simple data tag to every page. After adding the script tag Modal staff will configure the rest. Email support@modalup.com for help.
Installation Instructions
1. You will need your Modal `Website ID` for each dealer website which will be supplied to you.
2. Add the Modal `Website ID` for the correct site to the script tag paste inside <head> tag.
<script src="https://www.drivemotors.com/button/<WEBSITE_ID>" class="drivemotors" async></script>
Example:
<script src="https://www.drivemotors.com/button/12345" class="drivemotors" async></script>
3. You can confirm tag installation by opening your browser console and verify the following message being displayed.
Modal: Script successfully installed, waiting for configuration by Modal team.
4. Add the following tag to your VDP pages and SRP result rows. One <span> tag is required per vehicle. On SRP page each vehicle needs a tag inside its containing HTML element.
<span class="drivemotors"
data-ext-dealer-code="<DEALER_CODE>"
data-vin="<VIN>"
data-msrp="<MSRP>"
data-price="<PRICE>"
data-stock-code="<STOCK>"
data-model-num="<MODEL_NUM>"
data-model-trim="<MODEL_TRIM>"
data-ext-color="<EXT_COLOR>"
data-int-color="<INT_COLOR>"
data-is-new="<IS_NEW>"
data-miles="<MILES>"
></span>
| Param | Required | Description | Sample Value |
|---|---|---|---|
| DEALER_CODE | Yes | Unique code, account ID or name of dealership that car belongs to. (Dealer defined) |
5010, west-motors, or East Motors |
| VIN | Yes | VIN number | 1GCCS1940S8149015 |
| MSRP | Yes | MSRP/List price | 36000 |
| PRICE | Yes | Selling/advertised price without applying rebates | 32999.99 |
| STOCK_CODE | Yes | Dealer's stock code | ABC12345 |
| MODEL_NUM | Yes | Manufacture's model number/code (Helps Modal get the correct car information) |
123XB |
| MODEL_TRIM | Yes | Manufacture's model trim name | Base, LS, GT or Premium |
| EXT_COLOR | No | Exterior color name (optional but helps Modal get the correct car information) |
Slate Metallic Grey |
| INT_COLOR | No | Interior color name (optional but helps Modal get the correct car information) |
Tan Leather |
| IS_NEW | Yes | New or used boolean | true, false, 0, or 1 |
| MILES | Yes | Odometer mileage | 31 |
Example:
<span class="drivemotors" data-ext-dealer-code="north-motors" data-vin="1GCCS1940S8149015"
data-msrp="24000" data-price="21999.99" data-stock-code="ST9123"
data-model-num="AB123" data-model-trim="GTS"
data-ext-color="Slate Metallic Grey" data-int-color="Tan Leather" data-is-new="true"
data-miles="42"></span>
SRP Example
Search Results:
<ul>
<li>
[vehicle result row 1...]
<span class="drivemotors" data-ext-dealer-code="north-motors"
data-vin="1GCCS1940S8149015" data-msrp="24000" data-price="21999"
data-model-num="AB123" data-model-trim="GTS"
data-stock-code="ST9123" data-ext-color="Slate Metallic Grey"
data-int-color="Tan Leather" data-is-new="true" data-miles="42">
</span>
<li>
<li>
[vehicle result row 2...]
<span class="drivemotors" data-ext-dealer-code="west-motors"
data-vin="1GCCS1940S8149016" data-msrp="32000" data-price="30100"
data-model-num="AB123" data-model-trim="GTS"
data-stock-code="ST9124" data-ext-color="Bright Blue"
data-int-color="Black" data-is-new="false" data-miles="42245">
</span>
<li>
<ul>
Changelog
- 1.0 / October 1, 2020: Initial release.
- 1.1 / November 3, 2020: Update text.
Comments
0 comments
Please sign in to leave a comment.