Skip to main content

s2sBodyPwaEvent

At least one of wsid or cuid is required. Sending both is best.

app_tokenstringrequired

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

Example: abcf2270-XXXX-XXXX-XXXX-34903c6e1d53
event_idstringrequired

The 10-character custom event ID (Settings → Custom Events). first_open and uninstall_ are not supported.

Example: 99VEGvXjN7
wsidstring

Web session ID sent on the visit. The conversion is matched on wsid first, then cuid. Required if cuid is not sent.

Example: ws-4f9c2a71
cuidstring

Your customer/user ID. Required if wsid is not sent. Sending both links them, so later cuid-only conversions still attribute.

Example: customer-9981
revenue object

Revenue, as a string or number.

oneOf
string
currencystring

3-letter currency code; defaults to the app's currency.

Example: INR
order_idstring

Order ID.

Example: ORD-4471
product_idstring

Product ID.

Example: SKU-12
c_codestring

Coupon code.

Example: DIWALI10
param1string

Custom value. param1 … param10 are supported.

Example: checkout_v2
param2string
param3string
param4string
param5string
param6string
param7string
param8string
param9string
param10string
event_valueobject

Free-form JSON object.

Example: {"tier":"gold","items":3}
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 are ignored — use the ip field.

property name*string
event_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: 1790580942
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. The same token on a different event (e.g. a purchase, then a refund) is accepted.

Example: ORD-4471-purchase
modestring

Possible values: [production, testing]

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

Default value: production

s2sBodyPwaEvent
{
  "app_token": "abcf2270-XXXX-XXXX-XXXX-34903c6e1d53",
  "event_id": "99VEGvXjN7",
  "wsid": "ws-4f9c2a71",
  "cuid": "customer-9981",
  "revenue": "4999.00",
  "currency": "INR",
  "order_id": "ORD-4471",
  "product_id": "SKU-12",
  "c_code": "DIWALI10",
  "param1": "checkout_v2",
  "param2": "string",
  "param3": "string",
  "param4": "string",
  "param5": "string",
  "param6": "string",
  "param7": "string",
  "param8": "string",
  "param9": "string",
  "param10": "string",
  "event_value": {
    "tier": "gold",
    "items": 3
  },
  "ip": "49.36.140.1",
  "ua": "Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36 Chrome/120 Mobile",
  "headers": {},
  "event_time_unix": 1790580942,
  "s2s_id": "ORD-4471-purchase",
  "mode": "production"
}