Auto Insurance
Server Side
🌐 Endpoint: https://api.myadoptimizer.com/api/MAOListingsServerAPI
⚙ HttpMethod: GET
📑 Response Format: JSON
Generic Query String Parameters
-
LandingPageToken: This Token will be provided by your account manager
-
Device: Desktop o Mobile. Some 3rd Party AdNetworks or Private Exchange Campaigns might require this value to be provided when using Server Side integration
-
ClientIP: This is the user’s IP
-
CurrentURL: Optional, the URL where listings will be displayed
-
SourceID: Optional, tracking variable
-
ExtClickID: Optional, tracking variable
- UserAgent: Optional, Mozilla/() ()
- CustomVar1: Optional, tracking variable (Max length - 75)
- CustomVar2: Optional, tracking variable (Max length - 75)
- CustomVar3: Optional, tracking variable (Max length - 75)
- CustomVar4: Optional, tracking variable (Max length - 75)
- CustomVar5: Optional, tracking variable (Max length - 75)
Specific Query String Parameters for Auto Insurance
Query String Params Names | Data Type | Allowed Values |
---|---|---|
ZipCode* | string | 5 char US zip code |
State* | string | 2 char US state code (Uppercase) |
Accidents* | string | None,1,2,3+ |
BusinessOwner* | string | Yes, No |
CreditScore* | string | Excellent, Good, Fair, Poor |
CurrentInsurer* | string | Allstate, GEICO, Farmers, Liberty Mutual, Progressive, Nationwide, State Farm, Travelers, USAA, Other |
Drivers* | string | 1,2,3+ |
DUI* | string | Yes, No |
Gender* | string | Male, Female, Other |
HomeOwner* | string | Yes, No |
InsuredStatus* | string | Yes, No |
Married* | string | Yes, No |
MilitaryStatus* | string | Yes, No |
SR22* | string | Yes, No |
VehicleMake* | string | Acura, Audi, BMW, Buick, Cadillac, Chevrolet, Chrysler ,Dodge, Ford ,GMC, Honda, Hyundai, Infiniti, Isuzu, Jaguar, Jeep, Kia, Lexus, Mazda, Mercedes, Mercury, Nissan, Porsche, Subaru, Toyota, Volvo, Other |
VehicleYear | integer | 2024,2023,2022,2021,2020,2019,2018,2017,2016,2015,2014,2013,2012,2011,2010,2009,2008,2007, 2006,2005,2004,2003,2002,2001,2000,1999,1998,1997,1996,1995,1994,1993,1992, 1991, 1990 |
VehiclesToInsure | integer | 1,2,3 |
Age | integer | 1 - 99 |
FName ± | string | |
LName ± | string | |
Email ± | string | |
Phone ± | string | |
Address ± | string | |
City ± | string | |
MediaChannel | string | Social, Facebook, Native, Email, Display, SEM, SEO, SMS, Push, Affiliate, ChannelA, ChannelB, ChannelC, ChannelD, ChannelE |
*Case Sensitive
±PII Fields
API Response
-
destURL: This is the Click URL. Please use the value from this field when a click is triggered.
-
impressionUrl: In the event that you are not planning to render all listings returned by this API you need to use this trigger. This is a call back URL to track live impressions. If a listing is displayed in your result set, please trigger the impressionUrl of that listing.
-
displayUrl: This is the value from “Display URL” in the Campaign Ad Copy
-
trackingURL: This is a Image Pixel to track leads or form submits from Clicks. This is optional to implement, but it is used to provide traceability from a click to a lead submit
-
revenue: Actual payout per click based on bid modifiers.
-
baseRevenue: Base bid per click. It’ll vary based on bid modifiers.
-
bidModifierLog: The log that shows how the baseRevenue bid was modified.
-
advertiserName: The name of the advertiser - The ID of the advertiser
-
campaignPhoneNumber: A unique phone number assigned to the campaign to track and measure calls.
-
ctaLabel: New Specifies the text displayed on the call-to-action button.
-
adResultCallStatusID: An ID representing the campaign’s call status, where:
ID | Status | Allows calls |
---|---|---|
1 | Click To Call is Active | TRUE |
8 | Campaign is out of schedule | FALSE |
13 | Click to Call Monthly Cap Reached | FALSE |
14 | Click to Call Daily Cap reached | FALSE |
15 | Click to Call is Off | FALSE |
16 | Campaign is off | FALSE |
Example response:
{ "searchResultId": "3e9c9fa9-bfb7-47bd-8221-d2d111ebde38", "duration": 595, "items": [ { "itemId": "159", "brandName": "esurance", "networkSort": 1, "requestDuration": 374, "sourceID": null, "extClickID": null, "advertiserId": "53", "advertiserName": "Assurance IQ - 249", "displayName": "Save time. Save paperwork. Save Dollars.", "headline": "Car insurance can be so simple. And so affordable.<br />We're making insurance surprisingly painless<br />Click for quote today and save big!<br />", "blurbs": [ "Car insurance can be so simple. And so affordable.", "We're making insurance surprisingly painless", "Click for quote today and save big!" ], "imageUrl": "https://cdn.myadoptimizer.com/maojsfiles/images/LogoAdvertiser_000000_20f8cac8-121a-4d17-9a26-24d744b8b75b.JPG", "displayURL": "http://www.google.com" "destUrl": "https://api.myadoptimizer.com/api/MAOHttpRedirect?src=https://www.esurance.com/&LandingPageID=16&EventID=3e9c9fa9-bfb7-47bd-8221-d2d111ebde38&AdNetworkAPIID=16&cpc=11.27&Brand=esurance&Title=Save time. Save paperwork. Save Dollars.&CB=2mh319GLuFmMowM78sQmQw==&M=RatzBRmIdXToBqVWXvRlmw==&Weight=11.27&BidModifiers=50.00&NetworkAdID=159&SourceID=&LandingPageURL=", "impressionUrl": "https://api.myadoptimizer.com/api/MAOSaveResults?LandingPageID=26&AdNetworkAPIID=29&EventID=ae9540ce-7f31-405e-b21c-f11e7a2168b8&AdCampaignID=311&RequestTypeID=4", "revenue": 11.27, "baseRevenue" : 7.51, "bidModifierLog": [ "Consumer Credit: Good - Value: 50.00%", "States: CA - Value: -10.00%", "Tuesday: 14:18 - Value: 10.00%" ], "weight": 11.27, "statusId": 1, "trackingURL": "https://api.myadoptizer.com/api/MAOLeadTracking?AdNetworkAPIID=27&LandingPageID=24&EventID=8b448cc4-da0b-4f70-b180-c0c883282a49&IP=128.1.1.1&AdCampaignID=168", "campaignPhoneNumber": "+11234567890", "callToAction": "Call Now", "adResultCallStatusID": 1, "ctaLabel": "Request Info" }]}
External Ad Networks Setup Optional
To integrate the following Ad Networks, MAO will need the following values.
Media Alpha
api_token
placement_id
Transparent.ly
pubcampaignId
Clicks.NET
Affcamid
Key
Quinstreet
Src