Skip to content

Upsert trackings

PUT
/trackings
curl --request PUT \
--url https://portal.staging.arago-tech.com/trackings \
--header 'Authorization: <Authorization>' \
--header 'Content-Type: application/json' \
--data '{ "trackings": [ { "id": "63e2d42a27ad5f2b345ca123", "double_trackings": [ { "source_url": "example", "url": "example", "type": "DOUBLE_TRACKING_TYPE_UNSPECIFIED", "vendor_id": 1 } ] } ] }'

Creates or updates multiple trackings

Request to upsert trackings

Media typeapplication/json
UpsertTrackingsRequest

Request to upsert trackings

object
trackings
required
Trackings

List of trackings to upsert

Array<object>
>= 1 items <= 3000 items
Tracking

Tracking details for upsert

object
id
Tracking ID

The tracking unique identifier. If not provided, a new tracking will be created.

string
Example
63e2d42a27ad5f2b345ca123
double_trackings
required
Double trackings

The third party trackers fired alongside the ad. The url and vendor_id of each entry are generated from the source URL and ignored on input

Array<object>
>= 1 items <= 10 items
object
source_url
string
url

Url is server generated, ignored on input.

string
type

DoubleTrackingType represents the type of double tracking mechanism.

string
default: DOUBLE_TRACKING_TYPE_UNSPECIFIED
Allowed values: DOUBLE_TRACKING_TYPE_UNSPECIFIED DOUBLE_TRACKING_TYPE_IMG DOUBLE_TRACKING_TYPE_SCRIPT
vendor_id

Vendor_id is server generated, ignored on input.

integer format: int64

A successful response.

Media typeapplication/json
UpsertTrackingsResponse

Response containing the upserted trackings

object
trackings
Trackings

List of trackings

Array<object>
Tracking

The tracking information referenced by line items

object
id
Tracking ID

The tracking unique identifier in hexadecimal format

string
double_trackings
Double trackings

The third party trackers fired alongside the ad. The url and vendor_id of each entry are generated from the source URL and ignored on input

Array<object>
>= 1 items <= 10 items
Messages for Double Tracking
object
source_url
string
url

Url is server generated, ignored on input.

string
type

DoubleTrackingType represents the type of double tracking mechanism.

string
default: DOUBLE_TRACKING_TYPE_UNSPECIFIED
Allowed values: DOUBLE_TRACKING_TYPE_UNSPECIFIED DOUBLE_TRACKING_TYPE_IMG DOUBLE_TRACKING_TYPE_SCRIPT
vendor_id

Vendor_id is server generated, ignored on input.

integer format: int64
provider_id

Provider_id is server generated, ignored on input.

string
created_at
Created At

The creation date and time of the tracking

string format: date-time
updated_at
Updated At

The last update date and time of the tracking

string format: date-time
Example
{
"trackings": [
{
"id": "63e2d42a27ad5f2b345ca123",
"double_trackings": [
{
"type": "DOUBLE_TRACKING_TYPE_UNSPECIFIED"
}
],
"created_at": "2021-01-01T00:00:00Z",
"updated_at": "2021-01-01T00:00:00Z"
}
]
}

Bad request

Media typeapplication/json
object
Example
{
"error": {
"code": "BAD_REQUEST",
"details": [
{
"code": "MAX_ITEMS",
"field": "line_items",
"message": "value must contain no more than 3000 item(s)",
"params": {
"max": "3000"
}
}
],
"message": "Bad request"
}
}

Unauthorized

Media typeapplication/json
object
Example
{
"error": {
"code": "UNAUTHORIZED",
"message": "Unauthorized"
}
}

Internal server error

Media typeapplication/json
object
Example
{
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error"
}
}

An unexpected error response.

Media typeapplication/json
object
code
integer format: int32
message
string
details
Array<object>
object
@type
string
key
additional properties
any
Examplegenerated
{
"code": 1,
"message": "example",
"details": [
{
"@type": "example"
}
]
}