Integrations › Analytics

Analytics: how FoxPlug reads Amplitude, Fathom, Firebase, Google Analytics 4, Matomo, Mixpanel, Plausible, Simple Analytics, Umami, Vercel Web Analytics

Numbers that move after you ship. Each of these is read only, and each becomes posts, changelog entries and things to fix.

Amplitude

Read onlyBuilt, not yet read live

A product-analytics tool for events, funnels and user behaviour.

What it reads

Moments

Set up

  1. Open Settings, Projects, your project, General tab.
  2. Click Manage next to API Key and copy it.
  3. Click Manage next to Secret Key, generate one if needed and copy it at once; it is shown only when made.
  4. Paste apikey:secretkey into FoxPlug; type eu in the region box for EU projects.

What it never reads

How it differs

Amplitude gives counts per named event and a daily active user figure, so FoxPlug reports your biggest events by name and your active users. Unlike PostHog it never reads a person table.

What does FoxPlug need from Amplitude?

The project's API key and secret key, pasted as apikey:secretkey. Amplitude shows a secret key only when it is generated.

Does FoxPlug read my users?

No. It asks for event counts, unique-user counts and the daily active user count. No profile, email, user ID or event property is requested.

My project is on the EU servers. Does that work?

Type eu in the region box. The reader then calls Amplitude's EU address.

Fathom

Read onlyBuilt, not yet read live

A paid, privacy-first web analytics service with a simple dashboard and no cookies.

What it reads

Moments

Set up

  1. Open app.usefathom.com/api.
  2. Click Create new, name it FoxPlug, set permissions to Read only (all sites) or Site-specific, then Save changes.
  3. Copy the token now.
  4. Optionally copy the Site ID of the site to read.
  5. Paste the key (and Site ID) into FoxPlug.

What it never reads

How it differs

Fathom returns uniques, visits, pageviews, average duration and bounce rate per day from one aggregation call, with the site chosen by Site ID. Plausible does the same over a different API and needs the domain; Fathom is the one whose API calls count against your pageview quota.

Does reading Fathom cost me pageviews?

Fathom counts every API request against your monthly pageview allowance, so FoxPlug reads only when you press, not continuously.

Where is the Site ID?

In your Fathom dashboard for the site: a short run of letters like ABCDEFGH.

Is the token read-only?

The guide has you create it with Read only permission.

Firebase

Read onlyBuilt, not yet read live

Google's app platform; Google Analytics for Firebase reports mobile and web app events through a linked GA4 property.

What it reads

Moments

Set up

  1. Firebase console: Project settings, Integrations, Google Analytics card; read the linked GA4 Property ID.
  2. Google Cloud (same project): APIs and services, Library, enable Google Analytics Data API.
  3. IAM and Admin, Service Accounts, create one, Keys tab, Add key, Create new key, JSON.
  4. Copy the full JSON contents.
  5. analytics.google.com Admin, Property access management for the linked property: add the service account's client email as Viewer.
  6. Paste the Property ID and the JSON key into FoxPlug.

What it never reads

How it differs

Identical to Google Analytics 4 in what FoxPlug reads: lcnc-ga4-pull serves both keys with one report (users, sessions, screen page views, average session duration, bounce rate by day). The only differences are the connect panel's steps, which start in the Firebase console, and the label.

Is Firebase read differently from GA4?

No. A Firebase Analytics property is a GA4 property, and the same function reads both with the same report; the saved connection records which of the two it is.

Where do I find the property ID?

In the Firebase console under Project settings, Integrations, on the Google Analytics card.

Why is my first pull empty?

If you only just linked Firebase to Analytics, Google says data can take up to 24 hours to flow.

Google Analytics 4

Read onlyBuilt, not yet read live

Google's web and app analytics product, reporting users, sessions, sources and conversions for a property.

What it reads

Moments

Set up

  1. In the Google Cloud Console (right project selected): APIs and services, Library, enable Google Analytics Data API.
  2. IAM and Admin, Service Accounts, create a service account named FoxPlug; it needs no Cloud role.
  3. Open it, Keys tab, Add key, Create new key, JSON; a.json file downloads.
  4. Copy the entire JSON contents.
  5. In analytics.google.com Admin, Property access management: add the service account's client email as Viewer on that property.
  6. Property details: copy the Property ID (digits).
  7. Paste the Property ID and the full JSON key into FoxPlug.

What it never reads

How it differs

Same puller and same API call as Firebase; GA4 is the website property. Compared with Plausible, Fathom and Umami it needs a service-account JSON key and a Viewer grant instead of an API key, and its bounce rate and session length are averages of daily values.

Why a service account instead of signing in with Google?

FoxPlug reads GA4 with a service-account JSON key that you add as a Viewer on the property. That is the credential the connect panel asks for.

Which ID is the Property ID?

A plain number from Admin, Property details. A code starting G- is a Measurement ID and will not work.

Does FoxPlug see my conversions or traffic sources?

No. The report asks only for users, sessions, pageviews, average session duration and bounce rate by day.

Matomo

Read onlyChecked with a real account

An open-source web analytics platform, available as Matomo Cloud or self-hosted.

What it reads

Moments

Set up

  1. In your Matomo open Administration, Personal, Security.
  2. Create New Token and confirm your password.
  3. Describe it FoxPlug and choose the View access level.
  4. Copy the token (shown once).
  5. Administration, Websites, Manage: note the ID column for your site.
  6. Paste your Matomo address, the Site ID and the token into FoxPlug.

What it never reads

How it differs

Matomo is the one in this group where FoxPlug makes three calls (range summary, daily summary, daily pageviews) against an address you provide, so it works for self-hosted installs as well as Matomo Cloud. It gives bounce rate, average time on site and unique visitors where available; Umami and Plausible are read on their own hosts or by key alone.

Does FoxPlug work with self-hosted Matomo?

Yes. The Matomo address is part of the saved connection, so cloud and self-hosted installs are both read from the address you enter.

What access does the token need?

The View access level, the lowest. The token only reads the sites your user can see.

Is my token exposed?

The pull sends it in the body of a POST request rather than in the URL.

Mixpanel

Read onlyBuilt, not yet read live

A product-analytics tool for events, funnels and retention.

What it reads

Moments

Set up

  1. Open your Mixpanel project settings, Service Accounts (Owner or Admin needed).
  2. Add a service account named FoxPlug and copy the username and secret at once; the secret is shown once.
  3. Open Organization settings, Projects, your project, and copy the Project ID.
  4. Paste username:secret into FoxPlug, then the Project ID (add |eu or |in for those regions).

What it never reads

How it differs

Mixpanel gives counts per named event, so FoxPlug reports your top events by name and the unique people behind each, rather than page visits. Unlike PostHog it never reads a person table, and unlike Plausible or Fathom it needs no website.

What does FoxPlug need from Mixpanel?

A service account username and secret, and your Project ID. Mixpanel shows the secret once, when the account is made.

Does FoxPlug read my users?

No. It asks for event counts and unique-user counts only. No profile, email, user ID or event property is requested.

My project is in the EU or India. Does that work?

Add a bar and eu or in after the Project ID. The reader then calls the matching Mixpanel address. Mixpanel says a project's region cannot be changed once it is made.

Plausible

Read onlyBuilt, not yet read live

A lightweight, privacy-friendly web analytics tool, cloud or self-hosted.

What it reads

Moments

Set up

  1. Select the team that owns the site, open account settings, API Keys.
  2. Click New API Key, choose Stats API, copy the key (shown once), then Create API Key.
  3. Note the site domain as Plausible lists it (example.com, no https://).
  4. Paste the key and the domain into FoxPlug.

What it never reads

How it differs

Compared with Fathom, Umami and Simple Analytics, Plausible's v2 query returns visitors, visits, pageviews, bounce rate, visit duration and views per visit in one call, plus a daily series in a second. Its bounce rate and duration come ready-made (duration is a mean). It needs a Business-plan API key and always reads plausible.io.

Do I need a paid Plausible plan?

Plausible's own docs call the Stats API a Business plan feature, so a cheaper paid tier will not do, per FoxPlug's connect guide.

What goes in the site box?

The bare domain exactly as Plausible lists it, such as example.com, with no https:// and no trailing slash.

Does it work with self-hosted Plausible?

The pull's host is fixed to plausible.io, so the code reads only the cloud service. The guide says self-hosted steps match, but the code shows no host setting.

Simple Analytics

Read onlyChecked with a real account

A privacy-first, cookie-free web analytics service.

What it reads

Moments

Set up

  1. Open your Simple Analytics account settings (not a site).
  2. Create an API key; it starts sa_api_key_ (needs a trial or a plan with API access).
  3. Copy it.
  4. Note the site as listed, for example example.com without https://.
  5. Paste the key and the site into FoxPlug.

What it never reads

How it differs

The leanest of the privacy-first group: one call returns only visitors, pageviews and a daily histogram. There are no sessions, no session length and no bounce rate (Plausible, Fathom and Matomo give them), and the key belongs to your user rather than a team.

What is the 'site' field?

The domain exactly as Simple Analytics lists it, such as example.com. FoxPlug strips https:// and any path before using it.

Does a public site need a key?

The code sends the key when one is saved and notes that a public site answers without it, but FoxPlug's connect form requires the key.

What is missing compared with Plausible?

Simple Analytics' Stats API gives no sessions, session duration or bounce rate, so FoxPlug reads only visitors and pageviews.

Umami

Read onlyBuilt, not yet read live

An open-source, privacy-focused web analytics tool, run as Umami Cloud or self-hosted.

What it reads

Moments

Set up

  1. From the side-nav profile button choose Settings, then API keys.
  2. Click Create key (Umami may ask you to upgrade first).
  3. Copy the key.
  4. Open the website; its Website ID is the UUID in the address bar.
  5. Paste the key, Website ID and, if self-hosted, your host.

What it never reads

How it differs

Umami returns bounces as a count and total time as a sum, so FoxPlug converts them (bounces divided by visits; total time divided by visitors, labelled a mean). Plausible and Fathom hand back rates and means directly. Its daily list has sessions and pageviews but no daily visitors, and it can point at a self-hosted host.

Does this work with self-hosted Umami?

The pull supports a host field and sends both header styles. FoxPlug's own guide says the key steps are only confirmed for Umami Cloud.

What is the Website ID?

The UUID in the address bar when you view that website in Umami, not its name.

Why did Umami ask me to upgrade?

FoxPlug's guide notes this gate was seen when creating a key, and it does not attribute it to Umami's documentation.

Vercel Web Analytics

Read onlyBuilt, not yet read live

Vercel's built-in visitor and pageview analytics for projects deployed on Vercel.

What it reads

Moments

Set up

  1. Make sure Vercel is connected under Your deploys.
  2. In Vercel, check Web Analytics is switched on for the project.
  3. Open Settings, General and copy the Project ID (starts prj_).
  4. If a team owns it, copy the Team ID or short name.
  5. Paste the Project ID (and team) into FoxPlug.

What it never reads

How it differs

The only tool in this group with no key of its own: it borrows the Vercel deploy connection. It makes two aggregate calls (by day, by device type) and returns only visitors and pageviews, like Simple Analytics, but covers production traffic of one Vercel project and depends on your Vercel plan for look-back.

Do I paste a Vercel token for analytics?

No. FoxPlug uses the Vercel connection you already made under Your deploys and only asks for the Project ID.

Does it count preview deployments?

No. Only production traffic counts, as Vercel defines it.

Why are there no sessions or bounce rate?

The aggregates read give pageviews and visitors only, so session and bounce fields stay empty.

FoxPlug reads this tool only when you press Check for what's new, and only to read. Plans and limits are on the pricing page. Questions: support.