Dynamic Event Values

SignalRelay lets you attach parameters (value, currency, content_name, etc.) to an event, either as a fixed value or extracted at runtime from on-page data sources. Most sources are Free; only JS variables and DOM text need Pro.

Supported Sources

1. Static Value (Free)

A fixed value you type in the rule (e.g. currency = EUR). It is enforced on the server for every event with that rule’s name, including events sent with window.signalRelay.track().

2. WordPress Post Meta (Custom Fields) (Free)

Extract values from any custom field attached to the current post or CPT (e.g. _price, property_id, doctor_specialty).

Advantage: Resolved securely on the server and 100% compatible with page caching.

3. URL Parameters (Query Strings) (Free)

Read parameters directly from the browser URL (e.g. ?plan=premium&source=newsletter).

Advantage: Resolved in the visitor browser at runtime, never mixing data across cached page hits.

4. Form Field (Free)

Take the value of a field of the submitted form.

5. JavaScript Variables (`window.myVariable`) (Pro)

Map global JavaScript objects (such as window.currentUser or dataLayer) directly to event properties.

6. DOM Text (CSS Selector) (Pro)

Extract inner text from any DOM element upon trigger (such as the text inside h1 or price in .total-amount).

Value and Currency

Platforms expect value as a number and a currency next to it. SignalRelay helps in two ways:

Numbers. A value (also price, quantity, num_items, predicted_ltv, tax and shipping) sent as a plain decimal string such as "49.90" becomes a number. Anything else, such as "49,90" or "$49", is left exactly as received, because guessing a locale would turn a price into a wrong price.
Default currency. Any event that has a numeric value and no currency is sent with your Default currency. A currency you map yourself always wins.

Set the default in Settings → SignalRelay → Settings, card Currency, field Default currency, with a three-letter ISO 4217 code such as EUR, then click Save. The field shows the code in use. Until you set one, it is your WooCommerce store’s currency when WooCommerce is active, and USD otherwise; empty the field and save to go back to that automatic choice. The signalrelay_default_currency filter still overrides it. It is one value for the whole site, and the browser pixel reads it from the page, so clear your page cache after changing it.