AddThisFeature

Google Analytics Server Events

Report confirmed outcomes to Google Analytics when browser tracking cannot be trusted.

involved Analytics

What it adds

Server-side delivery of completed conversions to Google Analytics, joined to the browser session and deduplicated against it.

What your agent is told to do

5
  1. 1

    Identify the outcomes the browser cannot see or reports unreliably — a payment confirmed by a webhook, a subscription that renewed, a signup completed after a redirect, anything blocked by an ad blocker — and send those from the server.

  2. 2

    Capture the analytics client identifier from the browser when the visit begins, store it against the session or the record, and send it with the server event so the conversion joins the same session and campaign rather than appearing as a new anonymous visit.

  3. 3

    Generate a stable event identifier at the moment the outcome happens and use it for both the browser and the server send, so the provider can collapse the pair into one event. Assign each event type a primary origin and treat the other as the fallback.

  4. 4

    Keep the measurement credential in server configuration only, never in a browser bundle, and never send an email address, a name, a payment detail, a health or financial attribute, or anything else the provider's policies prohibit. Send an opaque internal identifier if a user must be identified.

  5. 5

    Queue every send through the app's existing background processing so the user's transaction commits and returns without waiting on the provider. This entry owns server-side delivery only; if the app has a separate brief for browser tracking, that one owns page views and in-page interactions.

Edge cases it handles

8
  • Without the browser's client identifier the server event lands as a brand-new session with no campaign attribution, which makes the conversion useless for measuring acquisition. Capture and store it early, and record what happens when it is absent.
  • The same conversion sent from both the browser and the server double-counts unless both carry the same stable event identifier. Generate that identifier once, at the outcome, not independently on each side.
  • Session and campaign context is only legitimately available for a visit the app actually observed. Do not fabricate a source, and do not reuse a stale identifier from a previous visitor on a shared device.
  • Sending prohibited values — email addresses, names, payment details, or sensitive category attributes — breaches the provider's terms and can have the property's data deleted. Enforce an allowed parameter list rather than passing the record through.
  • Server sends must not sit on the request path. Queue them, so a slow or unreachable provider cannot delay a checkout or leave a transaction half-finished.
  • Events accepted at the endpoint can still be discarded downstream for a malformed or unknown parameter, often with no error returned. Validate against the configured event and parameter schema before sending, and verify in the provider's own debug view.
  • Events arriving long after the fact may fall outside the provider's accepted time window and be dropped. Send promptly, and set expectations for anything replayed from a backlog.
  • Rate limits and outages need backoff with jitter and a bounded queue. Failing telemetry must never fail or retry the underlying business transaction.

Definition of done

8
  • Outcomes the browser cannot reliably observe are reported from the server.
  • Server events carry the stored client identifier and join the originating session and campaign where one was observed.
  • Browser and server sends of the same conversion share one stable event identifier and are counted once.
  • No prohibited or personally identifying value is sent, enforced by an allowed parameter list.
  • Sends are queued off the request path and never delay or fail the user's transaction.
  • Credentials exist only in server configuration, and outages result in backoff and a bounded queue rather than lost transactions.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.