ga

Utilities for server side processing of Google Analytics in Deno CLI and Deploy.

When you server side render pages, it can be more efficient to not add Google Analytics to the client side app, and instead send the messages directly via your edge worker. This library provides a framework for doing this.

Usage

The library is designed to generate a measure message for each request and response handled by a Deno CLI or Deno Deploy server. These messages are then queued up and asynchronously batched to Google Analytics.

`createReporter()`

If you are using the Deno HTTP APIs directly, std/http, or various other HTTP frameworks, createReporter() will return a function which can be used to dispatch messages to Google Analytics.

You need to create the reporter function, and then call the reporter with information about the current request and response.

import { createReporter } from "https://deno.land/x/g_a/mod.ts";

const reporter = createReporter();

If you are using the low-level Deno API for HTTP servers, usage of the reporter would look something like this:

import { createReporter } from "https://deno.land/x/g_a/mod.ts";

const ga = createReporter();

for await (const conn of Deno.listen({ port: 0 })) {
  (async () => {
    const httpConn = Deno.serveHttp(conn);
    for await (const requestEvent of httpConn) {
      let err;
      const start = performance.now();
      try {
        // processing of the request...
        const response = new Response(/* response details */);
        await requestEvent.respondWith(response);
      } catch (e) {
        err = e;
      } finally {
        await ga(requestEvent.request, conn, response, start, err);
      }
    }
  })();
}

If you are using the std library HTTP API then it would look something like this:

import { createReporter } from "https://deno.land/x/g_a/mod.ts";
import { serve } from "https://deno.land/std/http/server.ts";
import type { ConnInfo } from "https://deno.land/std/http/server.ts";

const ga = createReporter();

function handler(req: Request, conn: ConnInfo) {
  let err;
  let res: Response;
  const start = performance.now();
  try {
    // processing of the request...
    res = new Response(/* response details */);
  } catch (e) {
    err = e;
  } finally {
    ga(req, conn, res!, start, err);
  }
  return res!;
}

serve(handler);

`createReportMiddleware()`

If you are using oak, then createReportMiddleware() can be used to create middleware which will

import { createReportMiddleware } from "https://deno.land/x/g_a/mod.ts";
import { Application } from "https://deno.land/x/oak/mod.ts";

const ga = createReportMiddleware();
const app = new Application();

app.use(ga);
// register additional middleware...

app.listen({ port: 0 });

Conn	A narrowed down version of `Deno.Conn` which only contains the information which the library usages.
MetaData	Specialized data fields that are supported being set via a callback.
Reporter	The interface returned from `createReporter()` that is then called to enqueue measurement messages to be sent to Google Analytics.
ReporterOptions	Options which can be supplied to the `createReporter()` factory function.
ReportMiddlewareOptions	Options which can be supplied to the `createReporterMiddleware()` factory function.

Functions

Interfaces

ga

Usage

`createReporter()`

`createReportMiddleware()`

createReporter	Create and return a function which will dispatch messages to Google Analytics.
createReportMiddleware	Creates and returns a reporting measurement middleware for oak, which will generate and send to Google Analytics measurements for each request handled by an oak application.