See here for instructions on how to turn a parameter into a custom dimension.
NEW: dealer_referrer
When a dealership website has the CDK Digital Retail Roadster as an iframe, this parameter will contain the URL of the dealership website from which the user entered the Digital Retail experience. This provides a known referral source and enables reporting on traffic originating from dealership websites into the Digital Retail application.
NOTE: This field may return null if the user did not enter Digital Retail from a dealership website, if the browser session was reset, or if browser privacy/security settings prevented access to the stored referral information. This field is only applicable for embedded Digital Retail iframe experiences where a valid referring dealership URL is available when the experience is launched.
| Parameter Name | Custom Dimension? | Description |
| store_name | Yes | Dealership name (ex. toyotademo) |
| user_type | Yes | Is the user an online shopper or client staff |
| oem_code | Yes | The number assigned by the manufacturer to the dealer (ex. 406A08) |
| user_id | Yes | Unique ID assigned to an identified customer or agent (ex. 39021033) |
| affiliation | Yes | Name of company associated with event (liveperson) |
| affiliation_id | ID number of agent, employee, company, phone extension, or session connected with the event (332093jda-2389dajewd-32893dsa) | |
| comm_phone_number | phone number associated with event (E.164 phone number formatting) | |
| comm_status | Yes | start, close, engage, inject, send_deal, send_payment, send_appt, directions, idle, timeout, load, video_start, video_end, connect, ring, appt_set, crm_update, appt_booked, blocked, failed, connected |
| comm_type | Yes | chat, sms, voice, video, form, email |
| currency | Yes | USD,CAD,EUR,GBP,FRF |
| department | Yes | sales, service, parts, trade, credit, body_shop, admin, accessories, hr, custom_shop, rentals, unknown, quick_lube |
| element_position | top, top_left, top_right, bottom, bottom_right, bottom_left, slide_left, slide_right, floating, pop-up | |
| element_state | active, cleared | |
| element_subtype | cta_button, cta_icon, nav_button, nav_icon, nav_tab, hamburger_menu, mega_menu, sidebar_menu, inline_menu, hyperlink, content, share_icon, image, input_field, toggle, dropdown, | |
| element_text | Yes | Text on the cta button, hyperlink, menu, or message on image (if available) |
| element_text_selection | ||
| element_title | Name of the data field or adjacent text | |
| element_type | Yes | header, banner, popup, form, digital_retailing_tool, trade_tool, chat_tool, accessibility_tool, search_tool, scheduling_tool, gallery, map, footer, video, item_details |
| element_value | Yes | value of itemlist filter, search terms, and universal field values |
| event_action | Yes | click, slide, open, close, exit, increase, decrease, clear, check, uncheck, redirect |
| event_action_result | Yes | play, restart, vr_play, spin, popup, slideout, exit, error, search, calc, start, stop, redirect, open, close, increase, decrease, clear, check, uncheck, next_step |
| event_owner | Yes | The name of the company who sends the events into GA4 (ie. cdk_digital_retail) |
| flow_name | Yes | The pre-defined name of the flow |
| flow_outcome | Yes | start, stop, close, recalc, download, submit, unlock, proceed, lead, approved, declined, error, added, removed |
| flow_stage | Yes | a numeric value associated with the flow_name data field |
| form_name | Yes | Name of the form provided by the form owner |
| form_type | Yes | item, consumer_contact, trade, recall, parts, accessories, service_appointment, pre-order, finance_credit, human_resources, body_shop, custom, research, surveys, unknown |
| item_color | Yes | pull from standardized 3rd party lookup table |
| item_condition | Yes | new, used, salvage, dealer_cpo, oem_cpo, cpo, unknown |
| item_fuel_type | Yes | gas, diesel, liquified_natural_gas, electric, propane, nitrogen, methane, unknown |
| item_id | Yes | vehicle identification number, serial number, which is assigned by manufacturer |
| item_inventory_date | Date the vehicle was added to the inventory | |
| item_make | Yes | ford, toyota, honda, etc. |
| item_model | Yes | crv, tacoma, rav4, etc. |
| item_payment | Yes | lease, finance, cash |
| item_price | Yes | price of item (used for eCommerce reports) |
| item_results | number of results returned on the screen from a search query | |
| item_type | Yes | sedan, coupe, suv, cuv, crossover, truck, commercial_truck, van, trailer, 5th_wheel, luxury, domestic, |
| item_variant | Yes | xle, sle, mdx, etc. |
| item_year | Yes | model year |
| itemlist_filter | max_mileage, min_mileage, max_price, min_price, min_year, max_year, min_payment, max_payment | |
| link_url | destination URL if the CTA takes the consumer to a new page | |
| media_type | Yes | video, image, vr, slider, gallery, offer, 360_platform |
| page_type | Yes | item, itemlist, contact, directions, service, parts, accessories, body_shop, home, build_to_order, custom, complaint, employment, recall, finance, credit, trade, commercial, showroom |
| dealer_referrer | Yes | The dealership website URL from which the user entered the Digital Retail experience (only applicable for iframes where there is a proper embed url present) |