Lägg till SDK:n i ditt projekt med din föredragna pakethanterare.
npm install wrangleryarn add wranglerpnpm add wranglerKom igång med den minimala konfigurationen.
// 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) }}Produktionsklara mönster med felhantering, laddningstillstånd och avancerad 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 },}Alla tillgängliga alternativ för att initiera och konfigurera SDK:n.
publicKeystringDin publika nyckel från dashboarden — säker att skicka med i webbläsarenendpointstringAnpassad endpoint-URL för proxyroutade driftsättningar — en explicit URL vinner över regionregionstringDataregion: us eller eutimeoutMsnumberTimeout för hela getResult()-anropet, i millisekunderlinkedIdstringDitt interna konto-ID för den inloggade användaren, så att besök som delar enhet kan kopplastagstringFritt formulerad etikett kopplad till identifieringsbegäran, t.ex. checkout eller logindebugbooleanLoggar skriptets livscykel och nätverksaktivitet till webbläsarkonsolenscriptUrlstringFullständig åsidosättning av agentskriptets URL — för self-hosting eller Subresource IntegrityGå djupare med den fullständiga API-referensen, webhook-konfiguration och avancerade guider.
Fullständig API-referens, integrationsguider och bästa praxis.
Händelseleverans i realtid, nyttolastschema och signaturverifiering.
Konfigurera händelseaviseringar i realtid för varje enhetsidentifiering.
Lägg till enhetsfingerprinting i din Cloudflare-applikation på under 5 minuter.