Every official SDK is listed below. Pick one to jump straight to its setup guide.

Web

JavaScriptVueNuxtReactNext.jsw-chat.js

Mini programs

WeChatAlipayDouyin

Mobile

AndroidiOSHarmonyOS

Cross-platform

React NativeFlutteruni-app

Server

Node.jsPHPPythonJavaGo

Support matrix

Platform	Package / entry	Distribution	Version	Minimum	Autocapture
Website	w.js	<script> tag	1.0.0	See JavaScript (w.js)	Pageviews and more; see JavaScript (w.js)
Vue / Nuxt / React / Next.js	No separate package; reuse w.js	Manual	—	—	Same as w.js
WeChat / Alipay / Douyin mini programs	@webcount/miniprogram (entries /wx, /my, /tt)	npm	0.1.0	Devtools that can build npm packages	Launch, foreground and background, page view and leave, share, favorite; clicks off by default
Android	com.webcount.WebCount	Kotlin sources in the repo, no Maven coordinate	0.1.0	minSdk 21	Forward the lifecycle yourself; report crashes yourself
iOS	WebCount	SPM	0.1.0	iOS 13	Launch, foreground and background, uncaught exceptions and signal crashes
HarmonyOS	@webcount/harmony	Sources in the repo, no ohpm manifest	0.1.0	API 12 (as labeled in the console)	Depends on the adapter you implement
React Native	@webcount/react-native	npm	0.1.0	react-native ≥ 0.72	Launch and foreground/background (AppState); React Navigation screens
Flutter	webcount_flutter	pub	0.1.0	Dart ≥ 3.0, Flutter ≥ 3.10	Navigator screens; everything else depends on the native SDK
uni-app	@webcount/uni-app	npm	0.1.0	—	Mini program targets match the mini program SDK; app targets depend on the adapter
Node.js server	WebCount class (@webcount/node)	Source file	1.0.0	Node.js 18 (global fetch)	Not applicable
PHP server	Webcount\WebCount	Source file	1.0.0	PHP 8.0, curl extension	Not applicable
Python server	webcount.WebCount	Source file	1.0.0	Python 3.7, standard library only	Not applicable
Java server	com.webcount.WebCount	Source file	1.0.0	Java 11	Not applicable
Go server	package webcount	Source file	1.0.0	Go 1.18	Not applicable

Scroll sideways to see more

Platform guides:

• Web: JavaScript (w.js), Vue guide, Nuxt guide, React guide, Next.js guide, Chat widget (w-chat.js), CMS & site builders
• Mini programs: WeChat mini program, Alipay mini program, Douyin mini program
• Native apps: Android, iOS, HarmonyOS
• Cross-platform: React Native, Flutter, uni-app
• Server: Node.js server SDK, PHP server SDK, Python server SDK, Java server SDK, Go server SDK

webcount in package names

Package, class, and module names still use the historical identifier webcount / WebCount (for example @webcount/miniprogram and com.webcount:android). Those are the TapCub SDKs. There is no second package line under the TapCub name.

Install commands come from the console

ConsoleApp analyticsConfigurationSDK code and ConsoleMini programsConfigurationSDK code print the install command and an init snippet with your site key and collection host filled in. The package names and versions on this page match those screens.

Client SDK capabilities

The mini program SDK has its own JavaScript core. HarmonyOS, React Native, and uni-app app targets reuse the @webcount/app-sdk core. Both cores behave the same for queueing, retry, and remote config (React Native persists only when you pass AsyncStorage). Android and iOS are separate native implementations, and version 0.1.0 does less than that core. Flutter only bridges calls, so its behavior equals the native SDK it calls.

Capability	Mini program / HarmonyOS / React Native / uni-app	Android 0.1.0	iOS 0.1.0
Persistent local queue	Yes: chunked local storage, default cap 10,000 events, 7 days, 1 MB	No: memory only	No: memory only
Retry	429 / 5xx / network errors back off from 1 s, cap 300 s; after 10 consecutive failures, switch endpoint when several are configured	No backoff; a failed batch stays in memory until the next send	No backoff; a failed batch stays in memory until the next send
Remote config (SDK remote config card)	Applied	Not read	Not read
Launch / foreground events	Automatic (React Native needs AppState; HarmonyOS and uni-app app targets come from the adapter)	Call onLaunch / onShow / onHide yourself	Automatic
Screen events	Automatic on mini programs; React Native uses navigationHook; others depend on the adapter	Manual trackScreen	Manual trackScreen
Crashes	Reported when the adapter supplies a crash hook	Manual reportException	Uncaught exceptions and signals are captured
User profile (setProps)	Writes the user profile	Registered as event super properties	Registered as event super properties

Scroll sideways to see more

Shared client conventions

Two-step init. Every client SDK calls preInit first (store config and bind the lifecycle; no network and no device read), then init after the user accepts the privacy policy (fetch site config, create a device id, start sending). If the site does not require consent, call both at startup.

Register the application id. Non-web uploads use appId (mini program appid, Android applicationId, iOS bundle id, HarmonyOS bundleName) as a source check: the SDK places it in the host portion of the upload URL, and an id that is not registered in the console is dropped silently. Register it with Add app identifier on ConsoleApp analyticsConfigurationSDK code or ConsoleMini programsConfigurationSDK code. The value must match appId at init. React Native and Flutter reuse the iOS / Android application id. uni-app reuses the mini program and app application ids.

Collection host. Set endpoint to the host shown on the SDK code page (host only, no path). The SDK appends /api/v1/pulse for events and /api/v1/pulse/cfg for site config. Samples write this host as .

Plan. Mini program and app uploads require a plan that includes that platform group. The free plan includes the website only. Professional and above include website, mini program, and app. If the plan does not include the platform, the collector drops the upload silently. See Plans & quotas.

Identity and collection tier. A persistent device id and identity calls such as login take effect only when the project is in identify mode (collection tier 3). In anonymous mode the SDK still sends events, but it does not write a device id, and identity calls are ignored. See Privacy choices before you start and Identify users.

China mode. After you pass region: 'cn' at init (the spelling on each platform is on that page), the SDK waits until you grant consent before it collects. Call init only after the user agrees.

Check. After integrating, open ConsoleApp analyticsRealtime or ConsoleMini programsRealtime. A $app_start or $mp_launch event means the path is open.

Shared server protocol

The five server SDKs are thin wrappers around one endpoint: POST /api/v1/track, header Authorization: Bearer plus the API key, body { "events": [ … ] }. Create the key at ConsoleConfigurationSettingsAPI keys. Its scope must include track:write (labeled Server track in the UI). The key starts with wck_ and is shown once, at creation.

POSThttps://app.tapcub.com/api/v1/track

Scopetrack:write

Each event object accepts the fields below. A field that is not listed fails validation for the whole batch:

typestringDefault: track

`track`, `track_signup`, `bind`, `unbind`, `profile_set`, `profile_set_once`, `profile_unset`, `profile_increment`, `profile_append`, `item_set`, `item_delete`, `track_update`, `track_overwrite`, `group_set`.

eventstring

Event name, 1–100 characters. Required for `track`. Defaults to `sign_up` for `track_signup`.

login_idstring | null

Login id, ≤ 200 characters. When present, the server binds identity in the same request.

login_id_typestringDefault: login

`login`, `email`, `mobile`, `unionid`, `openid`, `custom`. Plaintext `email` / `mobile` is SHA-256 hashed first, and the response includes a warning.

device_idstring | null

Device id with a type prefix (for example `mp_uuid:`, `ios_idfv:`, `android_id:`, `custom:`). After the prefix: 8–64 characters from letters, digits, `_`, and `-`. A bad format is ignored and returned as a warning.

identitiesobject

Extra identities. Keys are the id types above.

timeintegerDefault: receive time

Timestamp in milliseconds. If it differs from server time by more than 72 hours, it is replaced with the receive time.

insert_idstring

Idempotency key, ≤ 36 characters.

session_idstring | null

Session id, ≤ 32 characters. Without it, the event is left out of session metrics.

propertiesobject

Event properties. Values are strings (≤ 1000), numbers, booleans, null, or arrays of objects (≤ 100 items). At most 50 keys are stored. Arrays are stored as JSON strings.

unsetstring[]

Property names to remove for `profile_unset`, ≤ 50.

incrementobject

Numeric increments for `profile_increment`, keyed by property name.

appendobject

Values to append for `profile_append`, keyed by property name, ≤ 20 items per array.

item_typestring

Item type for `item_set` / `item_delete`, ≤ 40 characters.

item_idstring

Item id for `item_set` / `item_delete`, ≤ 80 characters.

groupstring

Account subject, `type:id`.

contextobject

`ip`, `user_agent`, `url`, `platform` (default `server`), `country` (2 letters), `lang`. Other keys are dropped.

Limits and meaning:

• 1–1000 events per request. Each API key may send at most 600 requests per minute; above that the response is 429.
• Query debug=1: validate only, do not store, and return a result per event. validation_behavior=enforce: reject any event that carries a warning.
• Events with insert_id are deduplicated first-write-wins: duplicates in the same batch, and duplicates of an event already stored within one day, are dropped. track_update / track_overwrite find the stored event by insert_id and merge or replace properties.
• A success body looks like { "received": 2, "accepted": 2, "rejected": 0, "events": 2, "results": [] }. results lists only failed or warned items (index, ok, warnings).
• A missing key returns 401 NO_API_KEY. An invalid key, or a key without track:write, returns 401 BAD_API_KEY. A body that does not match the shape above returns 400 VALIDATION.

How server events fit next to front-end data is in Server-side & merging and Server events & log import. The log-style /api/v1/server/events endpoint is in Server events.

How to choose

• Website only: use w.js. See JavaScript (w.js). For a single-page framework, follow that framework’s guide for routing.
• Mini program: native projects use @webcount/miniprogram. uni-app projects use @webcount/uni-app to pick a core. The H5 target uses w.js instead.
• Native app: integrate the iOS and Android SDKs separately. HarmonyOS needs an adapter you implement.
• React Native: use the JavaScript package @webcount/react-native. It does not depend on a native module.
• Facts that should come from the server, such as orders, payments, and refunds: use a server SDK or call /api/v1/track directly, and send insert_id so retries do not double-count.

More of the choice is in Choose how to connect and Platforms.

Versions and upgrades

Mini program, app, and cross-platform SDKs are 0.1.0. The server SDK library version is 1.0.0. A project can set a minimum SDK version in SDK remote config. SDKs on the JavaScript core (mini program, HarmonyOS, React Native, uni-app) stop sending and raise sdk_outdated when they are below that version. Android and iOS 0.1.0 do not read remote config, so this setting does not apply to them. Remote config is documented in Collection controls. Version history is in Changelog.