Install edge middleware

​

Before you start

• A paid plan that includes AI Traffic, and project management permission. See Set up AI Traffic.
• An app you can deploy with request middleware, such as Next.js, Express or Node.

​

Generate the ingest key

1. In Settings › Integrations, open Edge middleware under Crawler sensors.
2. Select Generate ingest key.
3. Copy the Server-side ingest key into a server or edge environment variable as DEVTUNE_AI_TRAFFIC_INGEST_KEY. Never expose it in browser code.

​

Install the package

pnpm add @devtune/ai-traffic

​

Next.js

// proxy.ts
import { createDevTuneAiTrafficMiddleware } from '@devtune/ai-traffic';
import {
  NextResponse,
  type NextFetchEvent,
  type NextRequest,
} from 'next/server';

const trackAiTraffic = createDevTuneAiTrafficMiddleware({
  ingestKey: process.env.DEVTUNE_AI_TRAFFIC_INGEST_KEY!,
});

export function proxy(request: NextRequest, event: NextFetchEvent) {
  trackAiTraffic(request, event);

  return NextResponse.next();
}

​

Express

import express from 'express';
import { createDevTuneAiTrafficExpressMiddleware } from '@devtune/ai-traffic/express';

const app = express();

app.use(
  createDevTuneAiTrafficExpressMiddleware({
    ingestKey: process.env.DEVTUNE_AI_TRAFFIC_INGEST_KEY!,
    origin: process.env.DEVTUNE_AI_TRAFFIC_ORIGIN!,
  }),
);

​

Node HTTP

import { createServer } from 'node:http';

import { createDevTuneAiTrafficNodeHandler } from '@devtune/ai-traffic/node';

const trackAiTraffic = createDevTuneAiTrafficNodeHandler({
  ingestKey: process.env.DEVTUNE_AI_TRAFFIC_INGEST_KEY!,
  origin: process.env.DEVTUNE_AI_TRAFFIC_ORIGIN!,
});

createServer((request, response) => {
  trackAiTraffic(request, response);

  response.statusCode = 200;
  response.end('ok');
}).listen(3000);

​

Vercel OIDC without an ingest key

• A site deployed on Vercel. Other hosts keep using the ingest key.
• @devtune/ai-traffic 0.11.0 or later.

​

Link the Vercel project

1. Enter the Vercel team ID. In Vercel, it is in the team’s Settings › General, under Team ID, and starts with team_.
2. Enter the Vercel project ID. It is in the project’s Settings › General, under Project ID, and starts with prj_.
3. Select Add Vercel project.

​

Configure the middleware

// proxy.ts
import { createDevTuneAiTrafficMiddleware } from '@devtune/ai-traffic';
import {
  NextResponse,
  type NextFetchEvent,
  type NextRequest,
} from 'next/server';

const trackAiTraffic = createDevTuneAiTrafficMiddleware({
  projectId: process.env.DEVTUNE_AI_TRAFFIC_PROJECT_ID!,
});

export function proxy(request: NextRequest, event: NextFetchEvent) {
  trackAiTraffic(request, event);

  return NextResponse.next();
}

​

Switch from an ingest key

const trackAiTraffic = createDevTuneAiTrafficMiddleware({
  projectId: process.env.DEVTUNE_AI_TRAFFIC_PROJECT_ID!,
  ingestKey: process.env.DEVTUNE_AI_TRAFFIC_INGEST_KEY,
});

​

Preview deployments

​

Link status

1. Check both IDs on the link against Vercel. A mistyped ID never matches, and DevTune records nothing from that deployment. Remove the link and add it again with the right IDs.
2. Check that projectId in the middleware matches the DevTune project ID shown in Settings.
3. Check that Snippet and middleware collection is switched on in Settings › Integrations. While it is off, DevTune rejects every batch.
4. Check which Vercel environment received the traffic. Previews count only with Preview deployments on, and custom environments never count.

​

Remove a link

​

Verifying crawler identity

​

Delivery and statuses

​

Check the middleware is working

1. Deploy, then request a page the middleware runs on with a crawler user agent. Replace the address with your own:
   curl -A "GPTBot/1.3" https://www.example.com/
   
2. In Settings › Integrations, reload the page. Until DevTune accepts its first event, the Edge middleware row reads Installation has not been confirmed. Within a few minutes it reads Active, with Last ingest and a time, and lists your hostname. A linked Vercel project also changes from Not seen yet to Last seen.
3. Don’t expect the test request in the verified totals. It didn’t come from OpenAI’s network, so it isn’t counted as a verified crawl.

​

If something goes wrong

• Check that DEVTUNE_AI_TRAFFIC_INGEST_KEY, or DEVTUNE_AI_TRAFFIC_PROJECT_ID on Vercel, is set in the environment you deployed.
• Check that Snippet and middleware collection is switched on in Settings › Integrations. While it is off, DevTune rejects every batch.
• Pass a logger to see failed or dropped sends. See delivery.
• On Vercel without an ingest key, work through Link status.

​

Next steps

• Advanced sensor settings - identity checks, proxies, delivery tuning and package versions
• Set up AI Traffic - connect website analytics, Search Console and the tracking snippet
• Reading AI Traffic - what each view counts