Skip to content

Upsert dynamic content optimizations

PUT
/dynamic-content-optimizations
curl --request PUT \
--url https://portal.staging.arago-tech.com/dynamic-content-optimizations \
--header 'Authorization: <Authorization>' \
--header 'Content-Type: application/json' \
--data '{ "dynamic_content_optimizations": [ { "id": "63e2d42a27ad5f2b345ca123", "destination_url": "https://example.com/landing", "data": { "CTAText": "50% off", "Headline": "Summer Sales!" } } ] }'

Creates or updates multiple dynamic content optimizations

Request to bulk upsert dynamic content optimizations.

Media typeapplication/json
UpsertDynamicContentOptimizationsRequest

Request to bulk upsert dynamic content optimizations.

object
dynamic_content_optimizations
required
Dynamic Content Optimizations

List of dynamic content optimizations to upsert

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

Dynamic content optimization details for upsert

object
id
ID

The unique identifier of the dynamic content optimization. If not provided, a new dynamic content optimization will be created.

string
Example
63e2d42a27ad5f2b345ca123
destination_url
required
Destination URL

The destination URL for the dynamic content.

string
Example
https://example.com/landing
data

Arbitrary case-sensitive key-value pairs for dynamic content substitution at ad rendering time.

  • Maximum 100 entries.
  • Keys must be <= 32 characters.
  • Values must be <= 4096 characters.
object
<= 100 properties
key
additional properties
string
Example
{
"CTAText": "50% off",
"Headline": "Summer Sales!"
}

A successful response.

Media typeapplication/json
object
dynamic_content_optimizations
Array<object>
DynamicContentOptimization

Dynamic content optimization details

object
id

Unique identifier for the dynamic content optimization.

string
destination_url

The destination URL for the dynamic content.

string
data

Arbitrary case-sensitive key-value pairs for dynamic content substitution at ad rendering time.

  • Maximum 100 entries.
  • Keys must be <= 32 characters.
  • Values must be <= 4096 characters.
object
<= 100 properties
key
additional properties
string
created_at
created at

The UTC created date of the dynamic content optimization

string format: date-time
updated_at
Updated At

The UTC last updated date of the dynamic content optimization

string format: date-time
Example
{
"dynamic_content_optimizations": [
{
"id": "63e2d42a27ad5f2b345ca124",
"destination_url": "https://example.com/landing",
"data": {
"CTAText": "50% off",
"Headline": "Summer Sales!"
},
"created_at": "2023-01-01T00:00:00Z",
"updated_at": "2023-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"
}
]
}