Track device playback

GET

/v1alpha2/track

Fire the URL exactly as stamped by the server, appending only ets (occurrence time in RFC3339). Every query parameter is server-provided — relay the URL verbatim, never parse or modify it. An <Error> URL is the one exception: fill in its [ERRORCODE] macro and skip ets.

Parameters

Query Parameters

asid

string

Asid is the per-serving id (the ad-serving id; the decision-store key) stamped on the tracking URLs by Exchange.Ads.

ae

string

Ad_event carries an ad-level event marker (e.g. “impression”). Proto field name is the GET query param (?ae=…)

ce

string

Creative_event carries a creative-level event marker (e.g. “start”). Proto field name is the GET query param (?ce=…)

sts

string

Sts is the Verve server timestamp stamped at decision time (RFC3339).

ets

string

Ets is the player-side event occurrence timestamp (RFC3339). Optional with ce=error.

dvactid

string

Dvactid is the opaque Advertima activation id.

flight_id

string

The following are offline-fire enrichment params: present only on offline self-resolving fires, absent on online fires (which resolve via asid lookup). The handler branches on their presence (dual-shape decode). flight_id is the booked flight behind the decision.

campaign_id

string

Campaign_id is the campaign behind the decision.

request_id

string

Request_id groups the ads served by one /ads response.

source

string

Source is the supply kind behind the decision (a Source* kind).

creative_id

string

Creative_id is the served creative/asset id.

location_id

string

Location_id is the place the device is located in (offline attribution).

device_id

string

Device_id is the player/screen that rendered the ad (offline attribution).

flight_revision

string

Flight_revision is the flight resource revision id at decision time.

error_code

string

Error_code is the VAST error code the player puts in place of the [ERRORCODE] macro. Sent with ce=error only.

Responses

200

A successful response.

Media typeapplication/json

Empty body (200 = accepted for processing).

object

Example^generated

{}