pieowlDocs
SDKs Overview

SDKs Overview

Choose the right way to send events to Pieowl. Script tag, JavaScript, React Native, bot tracking, and the HTTP API for every other language.

Pieowl has SDKs for the web, Node.js and React Native. For every other language, you send events with a plain HTTP request to the Track API.

Quick start

For most web projects, start with one of these:

Web and browser

Simple integration

  • Script Tag: Add analytics with one <script> tag
    • No build step
    • Works on any website
    • Tracks page views automatically

JavaScript and TypeScript

  • Web SDK (@pieowl/web): Browser SDK with TypeScript types

    • Typed API
    • Page views, outgoing links and data-track clicks, chosen in Settings → Site
    • Optional session replay
  • JavaScript (Node / Generic) (@pieowl/sdk): Core SDK

    • Works in Node.js and other JavaScript runtimes
    • No framework needed
    • Full tracking API

Frontend frameworks

Next.js, Astro and Nuxt use the Script Tag, plus @pieowl/bots on the server for AI crawlers and the ad-blocker proxy:

Server side

  • JavaScript (Node / Generic) (@pieowl/sdk): Server-side events from any Node.js server. See Express | Setup guide

  • AI crawlers and bots (@pieowl/bots): Report the AI crawlers and search bots the script can't see

    • Next.js, Express, Hono, Cloudflare Workers and any server with a Fetch Request
    • Never blocks or slows your pages
    • Includes a proxy that serves the script from your own domain, past ad blockers
  • HTTP API for other languages: Pieowl doesn't ship native SDKs for these languages. Each page shows how to send events with the language's own HTTP tools:

Mobile

  • React Native (@pieowl/react-native) | Setup guide

    • iOS and Android
    • Built for Expo
    • Optional offline queue
  • Swift: Send events from iOS and macOS apps with the HTTP API

  • Kotlin: Send events from Android apps with the HTTP API

Need help choosing?

Core features

Every SDK and the HTTP API support:

Event tracking

Track custom events with properties to see what users do.

User identification

Link events to your users and build user profiles.

Global properties

Set properties once and send them with every event (SDKs only).

Increment and decrement

Change numeric properties on user profiles.

Privacy

No cookies, and IP addresses are never stored.

API reference

To track events with plain HTTP requests, read the Track API.

Support

Email us at hello@pieowl.com.