Advanced attribution, custom data capture, and referral-domain mapping settings for the Invoca Tag. For basic setup — accessing, deploying, and going live — see Invoca Tag: Access, Deploy, and Go Live.Before you begin: You need access to the Settings area of your Invoca account and an existing Invoca Tag. Revisit this guide any time you install a new integration or create a custom Marketing Data field.
NoteThe Collect IP Address and Collect User Agent settings below configure your account to capture real caller data. If your organization has specific data-handling or compliance requirements, confirm these settings with your privacy or legal team before enabling them.
Configure caller attribution settings
- In Settings > Invoca Tags, select the Tag you want to configure.
- On the Revision History tab, click New Draft (or select your existing draft).
- Scroll to the Attribution tile, where you can edit:
- Attribution Window — how long Invoca treats a visitor to your landing page as the same unique visitor. Defaults to 30 days.
- Reset Attribution Cache — the Marketing Data parameters Invoca uses to determine paid-search attribution. Defaults to
gclid,utm_source, andutm_medium— the standard Google Ads click identifier and campaign-source/medium parameters used in URL tracking. If any of these change during a visitor’s session, Invoca resets that visitor’s attribution.
Capture custom Marketing Data
In the Marketing Data table, for each parameter you want your Tag to capture:- In Data Source Type, choose where Invoca should look: a URL parameter in the query string, a first-party cookie, or a JavaScript Data Layer variable.
- In Data Source Name, enter the field name:
- URL Parameter — leave blank unless it differs from the field’s Partner (API) Name.
- Cookie — must be a first-party cookie on your domain.
- JavaScript Data Layer — a variable or function name defined on your site. For complex JavaScript, use the Custom Code block below instead of putting the logic in this field — see Invoca Tag Wizard - Custom Code.
- Toggle Enabled on for each field you want to collect. New fields are disabled by default.
Advanced settings
- Parameters required to run — limit your Tag to trigger only when specific parameters are present (for example, to omit direct traffic). You can also require an exact
parameter=valuematch; Invoca supports one value per parameter. - Re-Run Attribution After — re-attempt Marketing Data capture after a set number of seconds, so promo numbers swap immediately while slower-loading parameters still get captured.
- Capture Organic Sources — fills in UTM parameters (the standard campaign-tracking fields —
utm_sourceandutm_medium— used in a page’s URL) with a default value when organic traffic arrives without them. For example, this credits a visit to Google if noutm_mediumparameter is present. - Collect IP Address — captures a caller’s IP address as part of their attribution data. See the compliance note at the top of this page.
- Collect User Agent — captures a caller’s User Agent (browser and device information) as part of their attribution data. See the compliance note at the top of this page.
Referral-domain defaults
When Capture Organic Sources is on, this table shows theutm_medium and utm_source values Invoca assigns based on a visitor’s referring domain: