Additional resources

Useful resources for Marketplace Motors catalogs

Offline Conversion API

Using these APIs, you will be able to send offline conversion events and see how many customers viewed or clicked on Facebook ads and Marketplace listings before converting.

Motors follows the standard Offline Conversion API, adding certain Motors specific fields. In order to implement the Motors Conversion API, visit https://developers.facebook.com/docs/marketing-api/offline-conversions and add the following fields on step 4. Upload Offline Events:

Match keys

Match keys compare a conversion to a user

KeyDescription

email

Email address(es)

Hash

phone

Phone number(s)

Hash

fn

First name

Hash

ln

Last name

Hash

madid

Apple or Android advertising ID

Hash

zip

ZIP code(s)

Hash

ct

City

Hash

st

State

Hash

country

Country

Hash

dob

Date of birth (DD format)

Hash

doby

Date of birth (YYYY format)

Hash

gen

Gender

Hash

age

Age

Hash

lead_id

Lead ID of Marketplace leads

Custom data

Custom data compares a conversion to a dealer

FieldDescription

custom_data.{VIN}

VIN

custom_data.{PLATE}

Vehicle plate

custom_data.{dealer_id}

dealer_id from the catalog upload

content_ids

vehicle_id from the catalog upload

content_type

Set to VEHICLE

Event details

Event details describe the offline conversion event that took place

Upload frequency:

Daily, within 48 hours of the event

FieldDescription

event_name

Event type enum:

ViewContent

Search

AddToCart

AddToWishlist

Lead = Had a phone call or other qualified lead

CompleteRegistration = Appointment setup

InitiateCheckout = Dealer visit

AddPaymentInfo = Test drive

Purchase = Vehicle sold

Other = Service


Required

event_time

Time of the event

Required

value

Purchase value. Set to 0 for events without a purchase.

Required

currency

Currency code

Required

Facebook Pixel

The Facebook pixel is a snippet of JavaScript code that allows you to track visitor activity on your website. It works by loading a small library of functions which you can use whenever a site visitor takes an action (called an event) that you want to track (called a conversion).

https://developers.facebook.com/docs/facebook-pixel