Tag Creative API

1 Creating a Tag Creative
- 1.1 SDK
- 1.2 REST API
2 Get a Tag Creative
- 2.1 SDK
- 2.2 REST API
3 Edit a Tag Creative
- 3.1 SDK
- 3.2 REST API

Creating a Tag Creative

SDK

import springserve as ss

creative = ss.tag_creatives.new({
    "demand_partner_id": <demand_partner_id>, #int
    "name": <creative_name>, #str
    "vast_endpoint_url": <vast_tag_url>, #str
  })
if creative.ok:
    print("Tag creative successfully created")
else:
    print(tag.error)

REST API

Method: POST

Endpoint: /api/v0/tag_creatives

Headers:

Content-Type application/json
Authorization "yourAuthToken"

Request Body (example):

{
  "demand_partner_id": <demand_partner_id>,
  "name": <creative_name>,
  "vast_endpoint_url": <creative_url>
}

Get a Tag Creative

SDK

import springserve as ss

creative = ss.tag_creatives.get(123)
print(creative.id, creative.name)

REST API

Method: GET

Endpoint: /api/v0/tag_creatives/<id>

Headers:

Content-Type application/json
Authorization "yourAuthToken"

Response Body - Status Code 200 (example):

{
  "id": 2141,
  "account_id": 1,
  "demand_partner_id": 1475,
  "name": "TEST CREATIVE",
  ...
  "budgets": [],
  "frequency_caps": [],
  "tag_pixels": [],
  "targeting_keys": [],
  "targeted_macros": []
}

Edit a Tag Creative

SDK

import springserve as ss

creative = ss.tag_creatives.get(123)
creative.name = "New Creative"
creative.vast_endpoint_url = "https://tv.springserve.com/1?w=1920&h=1080"
creative.save()

REST API

PUT /api/v0/tag_creatives/<id>

Headers

Content-Type application/json
Authorization "yourAuthToken"

Request Body (example):

{
  "name": "TEST CREATIVE - Changed Name"
}

Response Body - Status Code 200 (example):

{
  "id": 2141,
  "account_id": 1,
  "demand_partner_id": 1475,
  "name": "TEST CREATIVE - Changed Name",
  ...
  "budgets": [],
  "frequency_caps": [],
  "tag_pixels": [],
  "targeting_keys": [],
  "targeted_macros": []
}