Proxy-Integration über Cloudflare Workers für First-Party-Routing. Fügen Sie Ihrer Cloudflare-Anwendung in Minuten Besucheridentifikation, Bot Detection und Smart Signals hinzu.
Fügen Sie das SDK mit Ihrem bevorzugten Paketmanager zu Ihrem Projekt hinzu.
npm install wrangleryarn add wranglerpnpm add wranglerMit dem minimalen Setup einsatzbereit werden.
// Cloudflare Workerexport default { async fetch(request, env) { const url = new URL(request.url) if (url.pathname.startsWith('/tracio/')) { return fetch('https://edge.tracio.ai' + url.pathname) } return fetch(request) }}Produktionsreife Muster mit Fehlerbehandlung, Ladezuständen und erweiterter Konfiguration.
// Cloudflare Worker — production proxyexport default { async fetch(request: Request, env: Env): Promise<Response> { const url = new URL(request.url) if (!url.pathname.startsWith('/tracio/')) { return fetch(request) } // Strip the /fp prefix and proxy to your tracio.ai server const targetPath = url.pathname.replace(/^\/tracio/, '') const target = `https://${env.TRACIO_ORIGIN}${targetPath}${url.search}` const headers = new Headers(request.headers) headers.set('X-Forwarded-For', request.headers.get('CF-Connecting-IP') || '') headers.set('X-Real-IP', request.headers.get('CF-Connecting-IP') || '') const response = await fetch(target, { method: request.method, headers, body: request.method !== 'GET' ? request.body : undefined, }) // Cache static agent script for 1 hour const res = new Response(response.body, response) if (targetPath.includes('/agent')) { res.headers.set('Cache-Control', 'public, max-age=3600') } return res },}Alle verfügbaren Optionen zum Initialisieren und Konfigurieren des SDK.
publicKeystringIhr öffentlicher Schlüssel aus dem Dashboard — sicher im Browser auslieferbarendpointstringIndividuelle Endpunkt-URL für Proxy-geroutete Deployments — eine explizite URL hat Vorrang vor regionregionstringDatenregion: us oder eutimeoutMsnumberTimeout für den gesamten getResult()-Aufruf, in MillisekundenlinkedIdstringIhre interne Konto-ID für den angemeldeten Nutzer, damit Besuche auf demselben Gerät verknüpft werden könnentagstringFrei wählbares Label für die Identifikationsanfrage, z. B. checkout oder logindebugbooleanProtokolliert Script-Lebenszyklus und Netzwerkaktivität in der Browser-KonsolescriptUrlstringVollständige Überschreibung der Agent-Script-URL — für Self-Hosting oder Subresource IntegrityVertiefen Sie sich mit der vollständigen API-Referenz, der Webhook-Konfiguration und fortgeschrittenen Leitfäden.
Vollständige API-Referenz, Integrationsleitfäden und Best Practices.
Echtzeit-Ereigniszustellung, Payload-Schema und Signaturprüfung.
Konfigurieren Sie Echtzeit-Ereignisbenachrichtigungen für jede Geräteidentifikation.
Fügen Sie Ihrer Cloudflare-Anwendung in unter 5 Minuten Device-Fingerprinting hinzu.