Skip to main content
Share call and conversation data with Piwik PRO Analytics to understand what’s driving calls from your website, using the Tracking HTTP API.
A Piwik Visitor ID ties call events to the visitor.

​
Before you begin

Invoca reports events server-side for a visitor, which causes Piwik to update that visitor’s geo-location to Ashburn, United States. If you rely heavily on geo-location reporting in Piwik, this integration may not be a good fit. Decide whether you need the Basic or Advanced installation steps: if you’re integrating one Piwik Site, or multiple Sites already separated into distinct Invoca Profiles/Campaigns, use Basic. If you’re tracking multiple Piwik Sites through a single Invoca Tag, Profile, and Campaign, use Advanced.

​
Basic installation steps

  1. Log in to Piwik PRO Analytics. Copy your sub-domain from the URL (for example, invoca-demo in https://invoca-demo.piwik.pro/analytics/#/). Copy your Site ID from the Site overview page — repeat for each Site you’ll integrate separately.
  2. In Invoca, determine whether to integrate at the Network level (one Piwik Site) or Profile level (multiple Sites mapped to separate Invoca Profiles/Campaigns). Click Integrations > Manage Integrations, click the Piwik PRO tile, and create a “collection” — enter a friendly name, the sub-domain, and the Site ID from step 1.
  3. Create an Action (a Call or Signal to report as a Piwik Event). Choose Send Call or Send Signal Events, enter a friendly name, optionally filter by Profile or Campaign, and set Triggered By to All Calls or Signal. Enter the Event Name exactly as you want it in Piwik — use a + in place of any space (for example, Closed+Won).
  4. Update your Invoca Tag: click the gear icon, then Invoca Tags, find your Tag, and create a new draft. Find the Piwik Visitor ID parameter, set Data Source Type to JavaScript Data Layer, and enter Piwik.getAsyncTracker().getVisitorId() as the Data Source Name (use Piwik.getTracker().getVisitorId() instead if you use Piwik’s synchronous tracker). If needed, set the Full Landing Page URL parameter’s Data Source Name to window.location.href. Test, then click Save & Go Live. If the Piwik tag sets its Visitor ID after the Invoca Tag runs, enable “Re-Run Attribution” (5 seconds is a reasonable starting point).

​
Advanced installation steps

Use this path if multiple Piwik Sites share one Invoca Tag, Profile, and Campaign.
  1. Copy your Piwik sub-domain, as in Basic step 1.
  2. Create a Marketing Data field to dynamically capture the Piwik Site ID: Type Short text, Partner API Name pk_site_id, Friendly Name “Piwik Site ID”, Attribution Model Last.
  3. In Invoca, integrate at the Network level (typical for advanced setups). Create the Piwik collection with the sub-domain, and enter <pk_site_id> in the Site ID field so Invoca dynamically populates it per call.
  4. Create Actions the same way as Basic step 3, typically filtering by “All Profiles.”
  5. Update your Invoca Tag to capture both the Piwik Visitor ID (Piwik.getAsyncTracker().getVisitorId()) and Piwik Site ID (Piwik.getAsyncTracker().getSiteId()), both as JavaScript Data Layer sources, plus the Full Landing Page URL field if needed.

​
Validate that events are reaching Piwik

In Invoca: click Integrations > Manage Integrations, open the Piwik PRO tile, then the Action you created, and review the Delivery Details chart. If you used the Advanced installation, expect errors on calls where the Tag couldn’t capture a Site ID — for example, static numbers like Google Call Extensions — consider a rule-based Signal to filter those out. In Piwik: go to Settings > Tracker debugger to review recent sessions in real time (last 6 hours), or check Reports > Custom Events > Event Names for Invoca-reported totals.

​
FAQs

Does Invoca pass Revenue? Yes, as the event value. What fields does Invoca pass by default? Piwik Visitor ID, Piwik Site ID, Full Landing Page URL, Event Category (always “Invoca”), Event Action (always “Call”), Event Name, and Event Value (the Revenue field). How does Invoca send data? Using the Tracking HTTP API. Can I add more parameters? Not currently — contact your CSM if you have a parameter you’d like to add. How does Piwik associate the event with Source, Medium, etc.? Invoca passes the Full Landing Page URL including the query string, which Piwik references to determine source, medium, and content. What happens if an event is sent outside the session window? Piwik ties it to the same visitor ID but counts it as a new session. Why do visitors show a location of Ashburn, United States? Invoca reports events server-side, so Piwik uses Invoca’s server IP for that session’s location — it reverts to the visitor’s actual location the next time they resume their web session.

​
Where to go next

Last modified on September 25, 2026