Event Parameters
Event parameters are the key/value pairs FunnelTrack ships alongside each event to your ad platforms and analytics destinations — Meta's custom_data, GA4's params, Google Ads' eventValues, and equivalents on TikTok, Pinterest, Snapchat, Reddit, LinkedIn, Microsoft Ads, and OpenAI. They drive revenue attribution, product-level reporting, and custom-audience segmentation. The good news: FunnelTrack auto-injects the vast majority of them — you only map what's specific to your business.
What FunnelTrack handles automatically
Don't manually map any of these — they're wired up for you out of the box.
Purchase, Subscribe, StartTrial, AddToCart, InitiateCheckout, AddPaymentInfo, PlaceAnOrder, and CompletePayment events, FunnelTrack injects the standard ecommerce parameter set from the source payload — no mapping required.- •Revenue + currency — pulled from
event.revenueandevent.currency. Read from the source-of-truth field on each source (order total for ClickFunnels / HighLevel / Stripe orders, lead value for opportunities). Currency defaults toUSDwhen the source doesn't supply one. - •content_ids — built from
event.properties.product_ids: the array of SKUs or product UUIDs the source ships on each order. - •contents[] — the Meta dispatcher builds a per-item array
[{ id, item_price, quantity }, ...]fromevent.properties.line_items(normalized shape{ product_id, name, unit_price, quantity }). The same normalized line-items feed GA4items[], Google AdscartData.items[], TikTokcontents[], Pinterestline_items[], Snapchatproducts[], Redditproducts[], and OpenAIdata.contents[]. - •num_items — total quantity across the line items (sum of
line_items[*].quantity). - •order_id— the source's transaction identifier, passed through as the platform-appropriate key:
order_idfor Meta, TikTok, Pinterest, Snapchat, and Google Ads;transaction_idfor GA4 and Microsoft Ads;conversion_idfor Reddit. This also doubles as the dedup key on Meta CAPI. - •content_type — defaults to
productper integration config (the Meta connection page'smeta_content_typesetting overrides this if you sellproduct_groupbundles). - •Source attribution metadata —
source_platformplus source-specific identifiers (e.g.calendly_event_type_uuid,highlevel_workflow_id,highlevel_event_name) are written into the event properties so you can reference them in templates and filters.
When to add manual event parameters
Five scenarios that come up regularly — most accounts never need more than these.
- Sending custom business data alongside the event. Your lead form collects a
budgetfield that you want to use to build a high-intent custom audience in Meta. Map it as a custom parameter namedlead_budgetand Meta will receive it incustom_dataon every dispatch. - Sending UTMs that didn't come through the standard click-ID path. Some CRMs ship an attribution surface of their own — HighLevel exposes
attributionSource.utmSourceon every workflow webhook, for example. If the visitor never had a FunnelTrack session (so the standard click-ID path didn't fire), you can surface that asutm_sourceon the outbound event by mapping it manually. - Sending GA4 standard event parameters.GA4's Purchase event accepts
coupon,shipping, andtaxas standard parameters. In the GA4 routing card, pick the GA4 Purchase event from the dropdown, then add acouponparameter that pulls from your payload'scustomData.discount_codefield. - Per-destination overrides. The same source event can ship different parameter sets to different destinations. Example: Meta gets
lead_qualityas a custom param so you can build a lookalike, while Google Ads gets it baked into the conversion value via a different mapping on the Google Ads card. - Static values for cross-event reporting. Map a literal value like
funnel_stage: "tof"to every form-submit event from your top-of-funnel page set so your reporting can roll up by funnel stage without you having to encode it in every form.
How manual mapping works
Two field types, one place to configure them.
Field types
- •Webhook field — a dynamic value pulled from the inbound payload via dotted-path lookup. Examples:
tracking.utm_source,order.line_items[0].price,customData.event_name. The dropdown shows you every field FunnelTrack discovered from the most recent submission on that source. - •Static value — a literal string you type in. Same value on every event that fires through this card.
Where to add them
On any source → destination routing page, open the event card's Add Event modal and expand the Custom Parameters section. Click Add Parameter, give it a key name (the name the destination will receive), pick the value type, and either choose the field from the discovered-fields dropdown or type in your static value. Save the card and the parameter ships on every future event.
Template syntax (advanced)
For users composing values from multiple payload fields.
Parameter values support {{field_path}} templating for cases where one outbound value should be composed from multiple payload fields. Example: setting lead_full_name: "{{first_name}} {{last_name}}" builds a combined name from two separate fields on the submission.
Common questions
value parameter on a Purchase event, it replaces the auto-injected revenue value from event.revenue. Useful for adjusting reported conversion value (e.g. sending lead score instead of order total).lead_value on Meta and conversion_valueon Google Ads with no conflict — they're configured independently.Ready to configure events?
Open your Integrations and add a custom parameter on any source → destination routing card.
Configure events for one of your destinations →Related concept
Identity fields — email, phone, name, IP, click IDs — work differently. Read the companion guide.
Learn about User Data Parameters →