Installare il Plugin di Tracking GEO AI Labs Audit

Prerequisiti

Prima di installare il plugin di tracking, devi creare una chiave Tracking dalla dashboard AI Labs Audit. Questo ti fornirà le tue 4 credenziali:

Plugin WordPress

Il plugin WordPress è il metodo più semplice per iniziare. Gestisce tutto automaticamente: rilevamento dei bot IA, buffering degli eventi e invio programmato.

Installazione

Hai due opzioni per installare il plugin:

Configurazione

Come funziona

PHP Generico

Per i siti PHP non WordPress, utilizza il tracker PHP autonomo con rilevamento automatico integrato. Installalo tramite Composer o copiando il file unico.

Installazione

composer require ailabsaudit/tracker

In alternativa, scarica AilabsTracker.php dal repository GitHub e includilo direttamente.

Esempio di utilizzo

use AilabsAudit\Tracker\AilabsTracker;

$tracker = new AilabsTracker(
    apiKey: 'your-api-key',
    apiSecret: 'your-hmac-secret',
    clientId: 'your-client-id',
    apiUrl: 'https://ailabsaudit.com/api/v1',
    enableDetection: true,
    bufferStorage: '/tmp/ailabs_buffer.json'
);

// Chiamare in cima al tuo front controller
$tracker->detect();

Node.js

Per i backend Node.js (Express, Fastify, Next.js, ecc.), utilizza il package npm ufficiale con middleware Express integrato e rilevamento automatico.

Installazione

npm install @ailabsaudit/tracker-node

In alternativa, copia src/index.js dal repository GitHub.

Esempio di utilizzo

const { AilabsTracker, createMiddleware } = require('@ailabsaudit/tracker-node');

const tracker = new AilabsTracker({
  apiKey: 'your-api-key',
  apiSecret: 'your-hmac-secret',
  clientId: 'your-client-id',
  apiUrl: 'https://ailabsaudit.com/api/v1',
  enableDetection: true,
});

// Middleware Express — rileva bot e referral automaticamente
app.use(createMiddleware(tracker));

// Arresto pulito — svuota il buffer rimanente
process.on('SIGTERM', () => tracker.shutdown());

Python

Per i backend Python (Django, Flask, FastAPI, ecc.), utilizza il package pip con middleware WSGI/ASGI e rilevamento automatico.

Installazione

pip install ailabsaudit-tracker

In alternativa, copia tracker.py dal repository GitHub.

Esempio di utilizzo

from ailabsaudit_tracker import AilabsTracker, WsgiMiddleware

tracker = AilabsTracker(
    api_key="your-api-key",
    api_secret="your-hmac-secret",
    client_id="your-client-id",
    api_url="https://ailabsaudit.com/api/v1",
    enable_detection=True,
)

# Middleware WSGI — rileva bot e referral automaticamente
app.wsgi_app = WsgiMiddleware(app.wsgi_app, tracker)

# Arresto pulito — svuota il buffer rimanente
import atexit
atexit.register(tracker.shutdown)

Cloudflare Worker

Distribuisci il tracker come Cloudflare Worker per intercettare e analizzare le richieste in edge, senza alcun impatto sul tuo server di origine.

Installazione

npm install -g wrangler

[vars]
API_URL = "https://ailabsaudit.com/api/v1"

wrangler secret put API_KEY
wrangler secret put API_SECRET
wrangler secret put CLIENT_ID

wrangler deploy

Come funziona

Pixel JavaScript

Un tracker client leggero (< 2 KB) che aggiungi come un semplice tag script. Ideale per siti statici, landing page o quando non hai accesso al server.

Installazione

Aggiungi il seguente tag script al tuo HTML, appena prima del tag di chiusura </body>:

<script src="/path/to/tracker.js"
  data-tracker-id="YOUR_TRACKER_ID"
  data-api-url="https://ailabsaudit.com/api/v1/collect">
</script>

Cosa traccia

Verifica

Una volta distribuito il tracker, verifica che tutto funzioni correttamente dalla tua dashboard AI Labs Audit.

Funzionalità avanzate del tracking GEO

Rilevamento degli URL allucinati

Il tracker rileva automaticamente gli URL allucinati -- pagine che i modelli AI citano o verso cui puntano ma che non esistono sul tuo sito (risposte 404 ai crawl dei bot AI). Vengono tracciati e riportati nella tua dashboard, permettendoti di creare il contenuto mancante o impostare redirect per catturare questo traffico generato dall'AI.

Tracciamento del traffico referral AI

Oltre ai crawl dei bot, il tracker monitora il traffico referral AI -- le visite reali degli utenti provenienti da piattaforme AI come ChatGPT, Perplexity, Copilot, You.com e altre. Questi dati ti aiutano a capire come la visibilità AI si traduce in traffico reale sul tuo sito.

Correlazione crawl dei bot / punteggi di audit

L'attività dei bot tracciata funge da indicatore di conoscenza web: più i bot AI crawlano frequentemente le tue pagine, più è probabile che il tuo contenuto sia indicizzato nella loro base di conoscenza. Questo si correla con i tuoi punteggi GEO nativi vs. web, fornendo un collegamento diretto tra l'attività di crawl e le prestazioni di visibilità AI.

Risorse correlate

Glossario: Tracking IA | URL allucinato | GEO | AEO

Tutorial correlati: Audit programmati | Pagina vetrina | Creazione cliente