Skip to main content

Analytics

Admin → Analytics (https://admin.finmatch.io/analytics/). Requires admin:analytics. The page subtitle is Performance insights and data visualization. Recent Analytics Data uses Integration with your existing analytics system.

Event capture by merchant​

The live control on this page is the Event capture by merchant matrix at the top. Where: Admin → Analytics (this page, top section). Requires admin:analytics and a deployed Merchant API with /admin/analytics-capture-config.

When capture is off, the SDK skips the network call and the Analytics Cloud Run service returns 204 (no BigQuery insert). Live config: configs/analytics-capture-config.json

  • Global default — capture on or off for merchants with no override.
  • Per-merchant switches — only stored when they differ from the default.
  • Search placeholder Filter merchants…. Empty table: Loading… / No merchants returned from the API. Column Capture on. Reload reloads the matrix.
  • When the global default is on, the hint is Turn capture off per merchant below to cut BigQuery volume for that site. When it is off: Only merchants switched on below send events; everyone else stays off.
  • Save changes writes gs://finmatch-shared/configs/analytics-capture-config.json (localhost writes the file in the repo; production goes through merchant-api GET/PUT /admin/analytics-capture-config).

Save changes​

Click Save changes after you toggle Global default or a per-merchant Capture on switch.

  1. The button shows Saving… (unicode ellipsis) and is disabled. Reload, the global checkbox, and the per-merchant switches are also disabled until the PUT finishes. Distinct from Recent Analytics Data Loading analytics data....
  2. There is no success toast. On success the meta line updates to include last config update plus the API timestamp.
  3. Failure paints an inline .analytics-capture-error with the API error / message (or the response text). The button returns to Save changes. Switch state stays as you left it until Reload.

When capture is off, the storefront SDK skips the network call and the Analytics Cloud Run service returns 204 (no BigQuery insert). If ANALYTICS_ALLOWED_MERCHANT_ID is set on that service, it overrides this matrix.

Merchant detail also has an Analytics tab. The banner is Storefront analytics capture; Change status here jumps to this page’s matrix. Do not copy invoice or SKU figures from cost tools into this public docs site. See Merchant Page Editing → Analytics.

Placeholder metric cards​

The four cards under the matrix (Total Users, Applications, Conversion Rate, Mobile Usage) are static HTML placeholders. They are not live platform metrics. Do not quote those numbers.

Recent Analytics Data​

Recent Analytics Data sits under the placeholder cards. Treat the three actions as diagnostics, not a KPI dashboard.

Idle copy under the actions: Click "Load Latest Data" to view analytics from your existing system. While the fetch runs: Loading analytics data.... That three-dot loading string is distinct from the capture-matrix Loading…. The page also auto-runs Load Latest Data about half a second after first paint, so the idle line is often already replaced.

Load Latest Data​

Click Load Latest Data (or wait for the auto-run).

  1. The panel shows Loading analytics data....
  2. The reader fetches one current-month JSONL from gs://finmatch-finance-marketing-assets/analytics/archive/ (hard-coded test merchant in analytics-reader.js). If that file is missing or unreadable, it paints sample copy headed Analytics Overview (Analytics system is active and collecting data!).
  3. When the JSONL loads, the heading is Current Month Analytics with Total Events, Unique Pages, and Mobile Traffic. Catch paints Error loading analytics: plus the message and the archive path.

The unused admin/js/analytics.js still paints Latest Analytics Summary (Total Events / Unique Users / Conversion Rate) if that script is loaded. The live Analytics page includes analytics-reader.js only. Do not quote sample conversion or revenue figures from either script.

Export Report​

Export Report always downloads a two-row CSV named finmatch-analytics-YYYY-MM-DD.csv. Columns: Generated At, Location. Location is gs://finmatch-finance-marketing-assets/analytics/archive/. It does not export the loaded JSONL or the on-screen summary.

View Raw Data​

View Raw Data opens the public GCS prefix https://storage.googleapis.com/finmatch-shared/analytics/ in a new tab. That is a different bucket from the JSONL archive Load Latest Data reads. Do not expect the archive files there.

Top Performing Merchants​

Top Performing Merchants is a static table (Merchant / Applications / Conversion / Revenue). Load Latest Data fills it.

  • JSONL path: the four cells are merchant id, event count, session-load count, and modal-open plus click count. The column headers stay Applications / Conversion / Revenue even then — do not quote those headers as those metrics. Empty: No data available.
  • Sample path: one info row (Analytics data is being collected / Implement backend API to display merchant-specific statistics). Do not quote pound figures from this table.