> For the complete documentation index, see [llms.txt](https://even-financial.gitbook.io/developer-center/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://even-financial.gitbook.io/developer-center/marketplace-integrations/partner-pages/auto-insurance-marketplace.md).

# Auto Insurance Marketplace

How to get started with a Partner Page integration for Engine's Auto Insurance Marketplace.

## Standard Partner Page Integration

### Partner Page URL Syntax & Components

All Partner Pages utilize custom URLs and tracking to ensure all transactions are correctly attributed. To integrate the **Partner Pages** on your website, you would place the following URL on your page in your desired location.

{% hint style="info" %}
**PLEASE NOTE**: Your Engine representative will provide you with your specific partner page URL. Do not try to reproduce from the sample URL outlined below.
{% endhint %}

<pre><code>https://moneylion.com/network/<a data-footnote-ref href="#user-content-fn-1">{channel}</a>/<a data-footnote-ref href="#user-content-fn-1">{zone}</a>/
</code></pre>

* **Channel:** Placeholder to be replaced with precise values in the embed code provided to you.
* **Zone:** Placeholder to be replaced with precise values in the embed code provided to you.

If implementing using an anchor \<a> tag, you may consider having the link open in a new tab with a `target="_blank"` attribute:

{% code overflow="wrap" %}

```html
<a href="https://moneylion.com/network/{channel}/{zone}/" target="_blank">Desired Link Text</a>
```

{% endcode %}

***

## Different Auto Insurance Experiences

This feature currently requires Partner Manager involvement to launch – contact your assigned Partner Manager for support.

### Short Form Experience

{% columns %}
{% column %}

<figure><img src="https://3849802388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MeMvVDbjd8vJWZ9Hwf0%2Fuploads%2FFvBhPNwpPW1wYTHb3bNE%2FScreenshot%202026-10-07%20at%207.58.22%E2%80%AFAM.png?alt=media&amp;token=402f51ad-5907-407c-a109-a66d9b954000" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="https://3849802388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MeMvVDbjd8vJWZ9Hwf0%2Fuploads%2FlMOznNv3NaSCGaAPyC6L%2FScreenshot%202026-10-07%20at%208.02.11%E2%80%AFAM.png?alt=media&amp;token=03790712-56e7-47ba-b511-8dde6da3470f" alt=""><figcaption></figcaption></figure>

{% endcolumn %}

{% column %}

<figure><img src="https://3849802388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MeMvVDbjd8vJWZ9Hwf0%2Fuploads%2FSgsg7UNEFMRmNsWuVgJT%2FScreenshot%202026-10-07%20at%208.02.21%E2%80%AFAM.png?alt=media&amp;token=6e3e77de-63d0-4e19-ae60-84f21d90d2d3" alt=""><figcaption></figcaption></figure>

{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}

<figure><img src="https://3849802388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MeMvVDbjd8vJWZ9Hwf0%2Fuploads%2FOR6qge0N4nBm3w5s52gi%2FScreenshot%202026-10-07%20at%208.02.29%E2%80%AFAM.png?alt=media&amp;token=4854b52d-f3c1-425e-8783-0ff03f3ff4fe" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="https://3849802388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MeMvVDbjd8vJWZ9Hwf0%2Fuploads%2FpP70OzjujB6B6vw18CVr%2FScreenshot%202026-10-07%20at%208.02.39%E2%80%AFAM.png?alt=media&amp;token=bdcc5d7a-7a18-422f-a23d-4d3299effe06" alt=""><figcaption></figcaption></figure>

{% endcolumn %}

{% column %}

<figure><img src="https://3849802388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MeMvVDbjd8vJWZ9Hwf0%2Fuploads%2FGyMogsiAdfO1oObdLd8t%2FScreenshot%202026-10-07%20at%208.02.51%E2%80%AFAM.png?alt=media&amp;token=c603d359-e906-4d2e-8615-d140258c0e16" alt=""><figcaption></figcaption></figure>

{% endcolumn %}
{% endcolumns %}

<figure><img src="https://3849802388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MeMvVDbjd8vJWZ9Hwf0%2Fuploads%2FhFPiw8mgxGtaZUwhuTFl%2FScreenshot%202026-10-07%20at%208.03.21%E2%80%AFAM.png?alt=media&amp;token=b4751555-2499-44da-81e3-87a3cf3caf61" alt=""><figcaption></figcaption></figure>

***

## Client Tags & Pre-filling Customer Data

Engine Partner Pages support the ability to add certain tags with varying use cases, which are outlined in this section.

{% hint style="info" %}
**Tags vs. Pre-fill**

**Client tags:** Used for attribution and reporting (prefix **tag**)

* Used to send your own metadata to Engine in order to enrich reporting and attribution with Engine data

**Prefill customer data:** Used as a query string parameter to send **non-PII** information (prefix **app**)

* Decreases friction in the user experience and increases application submission rates
* Useful when you already have that info on hand for that user, or want the front-end to default to particular values
  {% endhint %}

### How to Implement Client Tags for Reporting & Customer Data Pre-fill

{% hint style="danger" %}
For Auto Insurance specifically, **please use subId1 for click ID & subId2 for placement id**
{% endhint %}

To **add client tags** to a Partner Page integration for the purpose of enhanced reporting, add query string parameters to the respective URL in the following format\*:

```actionscript-3
?tag.key_1=value_1&tag.key_2=value_2
```

To **prefill customer data fields** in a Partner Page for the purpose of decreased friction in user experience, add query string parameters to the respective URL in the following format\*:

```actionscript-3
?app.key_1=value_1&app.key_2=value_2
```

{% hint style="info" %}
\*The first query parameter appended at the end of a URL/path should start with a question mark `?`; all subsequent parameters should start with an ampersand `&`.
{% endhint %}

#### Sample Partner Page URL

{% code overflow="wrap" %}

```ada
https://moneylion.com/network/{channel}/{zone}/search?app.zipcode=10011&tag.clientId=1234
```

{% endcode %}

<mark style="color:$primary;">In the above example,</mark> <mark style="color:$primary;">`clientId`</mark> <mark style="color:$primary;">is available as a tag for reporting purposes and the partner page "loan amount" field will be pre-populated with the value of "$</mark>10,000" for the consumer <mark style="color:$primary;">when the page is rendered.</mark>

### Supported Client Tag Keys

Below are the client tag keys that are currently supported.

{% columns %}
{% column %}
**Most common**

* `tag.clientId`
* `tag.subId`
* `tag.subId1`
* `tag.subId2`
* `tag.campaignId`
  {% endcolumn %}

{% column %}
**Also supported**

* `tag.agentId`
* `tag.clickId`
* `tag.deviceId`
* `tag.medium`
* `tag.sourceId`
* `tag.subId3`
* `tag.target`
* `tag.trafficsource`
* `tag.userId`
  {% endcolumn %}
  {% endcolumns %}

{% hint style="danger" %}
**Client tag keys are case-sensitive.** `subid` and `subId` are separate reporting keys.
{% endhint %}

<table><thead><tr><th width="46.0185546875"></th><th width="414.4017333984375">Example</th><th>Why</th></tr></thead><tbody><tr><td>❌</td><td><code>?tag.sub1={}&#x26;tag.sub2={}</code></td><td>Unsupported tags</td></tr><tr><td>❌</td><td><code>?tag.subId1={}&#x26;tag.subId2={}</code></td><td><code>{}</code> is a literal placeholder. Engine stores empty values.</td></tr><tr><td>❌</td><td><code>?tag.subId1=value1&#x26;tag.subId2=value2</code></td><td><code>value1</code> and <code>value2</code> are literal text, not real click values.</td></tr><tr><td>✅</td><td><code>?tag.subId1=8f3a2b1c9d&#x26;tag.subId2=4e7c1a92f0</code></td><td>Each key has a real value for that click.</td></tr></tbody></table>

If a different key is needed, please reach out to your Partner Manager - we *may* be able to accommodate, but adding nonstandard keys will increase the time it takes Engine to report Client Tag values back to you and is therefore not recommended.

### **Auto Insurance Supported Query Parameters**

Engine's Auto Insurance marketplace accepts the following parameters and values for customer data pre-population purposes:

| Field                                                                                                                                                                                                                                                    | Parameter                   | Acceptable Values                                                                                                                                                                                        |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Date of Birth                                                                                                                                                                                                                                            | `app.dateOfBirth`           | Date string of the format YYYY-MM-DD                                                                                                                                                                     |
| Zip Code                                                                                                                                                                                                                                                 | `app.zipcode`               | US 5-digit numeric ZIP code, e.g. `10001`. No leading/trailing whitespace                                                                                                                                |
| Number of Vehicles                                                                                                                                                                                                                                       | `app.numberOfVehicles`      | Integer between 1 and 5                                                                                                                                                                                  |
| Current Issuer                                                                                                                                                                                                                                           | `app.currentIssuer`         | String issuer name matching the enum values from Engine's API Reference for the Schema `AutoInsuranceIssuer`                                                                                             |
| Military Status                                                                                                                                                                                                                                          | `app.is_military`           | Boolean (`true`/`false`)                                                                                                                                                                                 |
| Home Owner Status                                                                                                                                                                                                                                        | `app.is_home_owner`         | Boolean (`true`/`false`)                                                                                                                                                                                 |
| <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>The fields defined below are only used for Engine's legacy Auto Insurance experience (likely anything integrated prior to August 2026).</strong></p></div> |                             |                                                                                                                                                                                                          |
| Age Range                                                                                                                                                                                                                                                | `app.ageRange`              | <ul><li>AGE\_RANGE\_18\_20</li><li>AGE\_RANGE\_21\_24</li><li>AGE\_RANGE\_25\_34</li><li>AGE\_RANGE\_35\_44</li><li>AGE\_RANGE\_45\_54</li><li>AGE\_RANGE\_55\_64</li><li>AGE\_RANGE\_65\_PLUS</li></ul> |
| Multiple Vehicle Status                                                                                                                                                                                                                                  | `app.has_multiple_vehicles` | `true`                                                                                                                                                                                                   |
| Insured Status                                                                                                                                                                                                                                           | `app.is_currently_insured`  | `true`                                                                                                                                                                                                   |

[^1]: Placeholder to be replaced with precise values in the embed code provided to you


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://even-financial.gitbook.io/developer-center/marketplace-integrations/partner-pages/auto-insurance-marketplace.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
