Getting Started
The dealer or marketing team should have a Facebook Ads property they intend to link with Modal Checkout data, and a working knowledge of Facebook's Business Manager platform.
From the Facebook Business management platform, copy the Pixel base code or Pixel ID and send it to support@modalup.com along with the website domain for which you're requesting the integration.
As soon as the Pixel is enabled by Modal's Integration and Support team, Modal Checkout will send pageviews and events to the recipient's Facebook Event Manager account for analysis and retargeting.
Pageviews and Events
Please refer to this guide for our full library of virtual pages and events.
Event Parameters: Modal Page Path
The Modal digital retailing tool has an internal page structure so that each step of the process has its own page URL. The properties are encoded in the virtual page URL path as follows.
modalup.com/<siteId>/<product>/<virtualPage>/<flow>
With each Facebook Pixel event, the following metadata parameters are also sent:
| parameter | example value | description |
| modal_page_path |
modalup.com/100/checkout/ LeadForm/CHECKOUT:PURCHASE:SAVINGS |
Full virtual page path containing the subsequently described values |
| modal_dealer_id | 100 | Modal website ID for this integration |
| modal_page_name | LeadForm | Virtual page title corresponding to this specific Modal screen |
| modal_session_type | CHECKOUT:PURCHASE:SAVINGS | See Flows below |
| modal_pixel_version | 1 | Modal data schema version for this event |
Flows
The order events occur varies based on the flow the user takes through Checkout. The flow is primarily determined by the button the user clicks to initiate Checkout and whether or not lead collection is required to unlock the price. Each event sent to GA includes the flow label as a property. The form of the flow label is:
<product>:<button>:<button-type>
Where
<product> is currently always CHECKOUT.
<button> is the button the user clicked to launch Checkout. It is one of:
|
PURCHASE |
The Express Purchase button. |
|
PAYMENT |
The Build Payment button. |
|
TRADE |
The Value trade button. |
<button-type> is the type of the button the user clicked to launch Checkout. It is one of:
|
REGULAR |
Lead information is not collected upon entering Checkout. |
|
LEAD |
Lead information is collected upon entering Checkout. |
|
SAVINGS |
Lead information is collected upon entering Checkout and the button CTA is changed to indicated savings are available. |
The complete list of possible flow labels currently available are:
- CHECKOUT:PAYMENT:LEAD
- CHECKOUT:PAYMENT:REGULAR
- CHECKOUT:PAYMENT:SAVINGS
- CHECKOUT:TRADE:LEAD
- CHECKOUT:TRADE:REGULAR
- CHECKOUT:TRADE:SAVINGS
- CHECKOUT:PURCHASE:LEAD
- CHECKOUT:PURCHASE:REGULAR
- CHECKOUT:PURCHASE:SAVINGS
- UNKNOWN
In practice, dealers should never see UNKNOWN.
Comments
0 comments
Please sign in to leave a comment.