FAQs
Find quick answers to the most common setup and reporting questions. For step-by-step help, follow the related guides below each answer.
Do I need to add the script to every page?
Add it to a shared layout or template so it loads on every page you want to measure. Do not add it twice to the same page.
Does the script track single-page app navigation?
The first page load is automatic. Call window.gum.page() after a client-side route change that does not reload the document.
How do I track a purchase?
Call window.gum.track() after a completed purchase and include a numeric revenue property if you want revenue in the Events report.
Can I proxy analytics through Next.js?
Yes. Choose Next.js in the project Setup panel and add the generated client component and Route Handler. Collection requests use your own domain before the server forwards them to Gumanalytics.
Can I install Gumanalytics on Shopify or WordPress?
Yes. Settings includes Shopify theme instructions and a WordPress WPCode installation. Both use the generated project script so replay, heatmap, and sampling options remain synchronized.
Can an image track page views?
Yes. Use a transparent 1px pixel, the [x online] badge, a custom uploaded image, or enable track=1 on an embeddable analytics graph. Image tracking records the metadata exposed by the request but cannot collect JavaScript-only engagement or interaction data.
Can I link the same user across devices?
Yes. Set the same stable tracking ID after sign-in on each device. You can also set a display name, and earlier sessions from the same anonymous visitor are attached to that identity.
Does Gumanalytics track UTM campaigns?
Yes. UTM source, medium, campaign, term, content, and campaign ID are captured with the visit. A ref query parameter is treated as UTM source when utm_source is not present. Attribution remains available for traffic filtering, session investigation, and conversion analysis.
Are session replay and website heatmaps optional?
Yes. Enable either feature per project in Settings, choose its sample rate, and publish the updated HTML or Next.js installation from Setup. They continue collecting when enabled in the embed installation even if standard project analytics collection is disabled.