Ga4 Data Health (ga4-data-health)

Summary

GA4 API health: real-time users, daily metrics, traffic drops, and sales-tracking health (purchase, begin_checkout and add_to_cart). Webshops without a linked property warn instead of skipping. A checkout-to-purchase conversion drop, or a 40% purchase-volume drop while checkouts continue, warns that part of the payment path stopped sending purchase.

Classification

• Category: SEO
• Plugin id: ga4-data-health
• Version: 1.2.0
• Target types: WEBSITE, WEBSHOP
• Weight class: LIGHT
• Risk level: not set on plugin object
• Browser required: No (HTTP / Node / other — see source)
• Tier / group: Tier 1 — HTTP-only

Schedule

• scheduleHints: { defaultInterval: '0 */6 * * *', priority: 5 }
• Prerequisites: None declared on this plugin.

Configurable inputs

Public keys are derived from inputSchema: z.object({ ... }) (underscore-prefixed keys are runtime-only and omitted here).

Field	Notes
ga4PropertyId	Zod field in inputSchema — see source for defaults, min/max, and .describe().
minDailyUsers	Zod field in inputSchema — see source for defaults, min/max, and .describe().
maxRealtimeDropPct	Zod field in inputSchema — see source for defaults, min/max, and .describe().
checkSalesTracking	Zod field in inputSchema — see source for defaults, min/max, and .describe().
salesLookbackDays	Zod field in inputSchema — see source for defaults, min/max, and .describe().
salesBaselineDays	Zod field in inputSchema — see source for defaults, min/max, and .describe().
minBaselinePurchases	Zod field in inputSchema — see source for defaults, min/max, and .describe().

Runtime / injected config

• Target secret ga4_service_account (JWT) for GA4 APIs.

What it does

• Runs as part of the worker test execution pipeline; results become Run rows and may create Finding records.
• GA4 API health: real-time users, daily metrics, traffic drops, and sales-tracking health (purchase, begin_checkout and add_to_cart). Webshops without a linked property warn. Conversion or volume drops while checkouts continue warn that a payment path stopped sending purchase.
• For finding titles, metrics, and artifacts specific to this plugin, refer to the implementation linked below.

Source

packages/test-plugins/src/plugins/ga4-data-health.ts