Skip to main content

s2sBodyPwaClick

app_tokenstringrequired

Your App Key (Settings → Development → SDK Integration). Must belong to an app created with platform Web.

Example: abcf2270-XXXX-XXXX-XXXX-34903c6e1d53
wsidstringrequired

Web session ID — one per browser session, created by you. The primary match key. If your site also runs the browser SDK, use the same wsid your page generates.

Example: ws-4f9c2a71
urlstringrequired

The landing page URL, with its query string. Every attribution parameter is read from here, not from the endpoint URL.

Example: https://shop.example.com/landing?pid=partner123&camp=diwali_sale
cuidstring

Your customer/user ID, if known at visit time. Strongly recommended: it keeps attribution working after the session ends, on another device, or after cleared storage.

Example: customer-9981
referrerstring

Used as an attribution fallback.

Example: https://www.google.com/
ipstring

The end user's IP. Omit it and geo resolves to your server's location.

Example: 49.36.140.1
uastring

The end user's user agent — needed for device type, OS version and locale.

Example: Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36 Chrome/120 Mobile
headers object

Extra end-user headers, e.g. Accept-Language. Forwarded-IP headers (X-Forwarded-For, X-Real-IP, Cf-Connecting-Ip) are ignored — use the ip field.

property name*string
click_time_unixinteger

Unix seconds (not milliseconds); defaults to now. Accepted up to 7 days in the past and 1 hour into the future. Anything outside that is replaced with the current time.

Example: 1790580000
s2s_idstring

Possible values: <= 200 characters

Idempotency token, unique per app + event + token for 24 hours. Must be deterministic (derived from your order ID or the gateway's event ID) so a retry produces the same value. A repeat returns {"success": true, "message": "duplicate, ignored"}.

Example: visit-ORD-4471
modestring

Possible values: [production, testing]

testing keeps data out of live reporting; it appears in the panel's test views.

Default value: production

s2sBodyPwaClick
{
"app_token": "abcf2270-XXXX-XXXX-XXXX-34903c6e1d53",
"wsid": "ws-4f9c2a71",
"url": "https://shop.example.com/landing?pid=partner123&camp=diwali_sale",
"cuid": "customer-9981",
"referrer": "https://www.google.com/",
"ip": "49.36.140.1",
"ua": "Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36 Chrome/120 Mobile",
"headers": {
"Accept-Language": "en-IN,en;q=0.9"
},
"click_time_unix": 1790580000,
"s2s_id": "visit-ORD-4471",
"mode": "production"
}