The Invoca Tag swaps your phone numbers for unique tracking numbers, captures where each visitor came from, and ties that data to the call. This article explains what visitors see, how long a number stays with a visitor, and how long attribution lasts.The Invoca Tag is a JavaScript snippet on your website. It connects each visitor’s browsing session to the phone call that follows, so your reports show which marketing sources drive calls. This article covers what the Tag does on your site and what to expect once it’s live. For setup steps, see Access, deploy, and go live.
What the Tag does
The Tag does three things each time a visitor loads a page:- Swaps phone numbers. The Tag finds the phone numbers on your page and replaces them with Invoca promo numbers (tracking numbers from a RingPool, which is a group of Invoca numbers assigned to your campaigns). Each visitor sees a different number, so Invoca knows which visitor is calling when someone dials it.
- Captures marketing data. The Tag reads attribution details from the visitor’s browser session, including:
- URL parameters, such as
utm_source,utm_medium, andgclid(the Google Click ID). - First-party cookies on your domain.
- Values from your site’s JavaScript data layer.
- The referring search engine, when a visitor arrives without tracking parameters (with Capture Organic Sources turned on).
- URL parameters, such as
- Recognizes returning visitors. The Tag stores a visitor ID in a cookie. If a visitor clicks a paid ad on Monday and calls on Thursday, the Tag lets Invoca link that call back to the Monday ad, as long as the visit falls within your Attribution Window.
What visitors see on your site
With the Tag running, an Invoca tracking number appears wherever your page shows a hard-coded phone number. Different visitors see different numbers at the same time. Callers hear the same experience as before: the number routes to the same destination you set up in Invoca.How long a visitor keeps the same number
A visitor keeps the same promo number for 5 minutes by default, and the timer restarts while the visitor stays on the page. After the visitor leaves and the 5 minutes pass, Invoca can show that number to another visitor. The 5-minute value is the recommended setting for the RingPool’s number session lifetime. To change it, see RingPool Management.How long attribution lasts
Attribution lasts for the Attribution Window you set in the Tag, which is 30 days by default. A returning visitor within that window keeps the marketing data from their original visit. Each time the Tag runs, it extends the window. Browsers can shorten this. Safari limits first-party cookie storage to 7 days or less, no matter what Attribution Window you set. Other browsers can also delete cookies after a period of inactivity.
A reverse proxy routes the Invoca Tag through your own domain so that browsers treat it as first-party. It extends Safari’s limit to 7 days but doesn’t remove it. For details on the cookie, see Does the Invoca Cookie’s 100-Year Max Age Mean Data Is Stored That Long?. For newer Safari privacy changes, see Navigating Safari 26.2 Privacy Updates with Invoca.