POST
/
v2
/
tracks
Send a list of tracked (user action) events to PlayerZero
curl --request POST \
  --url https://sdk.playerzero.app/v2/tracks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-PzBucket: <x-pzbucket>' \
  --header 'X-PzProd: <x-pzprod>' \
  --data '[
  {
    "id": "<string>",
    "identity": {
      "userId": "<string>",
      "email": "<string>",
      "anonId": "<string>"
    },
    "value": "<string>",
    "type": "<string>",
    "ts": "<string>",
    "attributes": {}
  }
]'
This is an advanced feature. We recommend exploring our SDKs and other integrations first before implementing a direct integration with our API endpoint. The most common use case for this endpoint is to send errors and tracked events from mobile and iOS devices.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-PzProd
boolean
required

Specifies whether this data is coming from a production source or not.

​
X-PzBucket
string
required

The name of the dataset you'd like to associate this data to. Not required, but highly recommended.

Body

application/json · object[]
​
identity
object
required
​
value
string
required

The value of the event. This may be something like Opened App or Started Onboarding. Label this as something that would cue you to know what the user was doing in this moment.

​
ts
string
required

The timestamp of the event in JSON format (ie. 2023-11-25T13:08:50.782Z)

​
id
string

A string UUIDv4 that uniquely identifies the event. Ensure the id looks something like this 62de9447-5d6b-496a-9164-d26f77fc8547. The id does not need to include the dashes. If not set, we will generate an id on the server side. This id is treated as a traceId so subsequent spans or logs with this id will be correlated with this tracked action.

​
type
string

Not required. The category of the action, for example this could be Click or Navigate.

​
attributes
object

A key, value pairing of arbitrary event metadata that is useful to tag to your event.

Response

204

Success, no content is expected in response