Supply Path Optimization Targeting

  • 5 minute(s) read
Prev Next

Supply path optimization (SPO) ensures that advertisers buy the right inventory, at the right price, from the right sources — leading to better outcomes across the board through the process of identifying and grouping specific inventory based on various factors like audience segments, publisher quality and ad formats.

Target SPO data in the DSP API from top trusted leaders in supply curation, such as Jounce, by using the CURATION targeting type in order to curate across scaled inventory and optimize supply objectives.

Endpoint

traffic/lines/{lineId}/targeting

Use the following HTTP methods:

  • Use the GET method to view line targeting.

  • Use the POST method to update line targeting.

Required and Supported Parameters

Jounce Contextual Object

The Jounce contextual object contains the following fields.

Field

Description

Data Type

Create

Update

id

The ID of the Jounce SPO contextual.

Integer

N/A Read Only

N/A Read Only

name

The name of the Jounce SPO contextual.

  • Premium Publisher-Controlled - Direct premium supply controlled by publishers.

  • Premium Intermediary-Controlled - Direct premium supply controlled by intermediaries that may have exclusive rights for premium ad placements.

  • Multi-Hop Reselling - Supply chains that do not provide direct supply access.

  • Cheap Reach - Partial or out of visibility placements in the supply chain that drive lower cost reach.

  • Made For Advertising - Publishers whose business model is ad arbitrage, pairing high volumes of paid traffic with high ad loads.

String

N/A Read Only

N/A Read Only

level

Taxonomy level ID.

Integer

N/A Read Only

N/A Read Only

Read Jounce SPO Targeting Taxonomy

Use this endpoint to retrieve the Jounce contextual Id to target on a line.

Sample Request URL

GET /traffic/contextuals/jounce

Sample Response

{
   "response": [
       {
           "id": "60368",
           "name": "Premium Publisher-Controlled",
           "level": "69"
       },
       {
           "id": "60369",
           "name": "Premium Intermediary-Controlled",
           "level": "69"
       },
       {
           "id": "60371",
           "name": "Multi-Hop Reselling",
           "level": "69"
       },
       {
           "id": "60372",
           "name": "Cheap Reach",
           "level": "69"
       },
       {
           "id": "60885",
           "name": "Made for Advertising",
           "level": "69"
       }
   ],
   "errors": null,
   "timeStamp": "2025-11-10T21:43:40.010Z"
}

Add/Update Jounce Supply Path Optimization Targeting

After retrieving a Jounce contextual Id using the GET endpoint, add it to the line to target it by using the following POST endpoint.

POST /traffic/lines/{lineId}/targeting

Parameters

The line ID is specified in the path of the URL. All other parameters are specified in the body of the application/json payload.

Parameters

Description

Data Type

Required/Optional

curationContextuals

Object that contains SPO targeting.

object

Required

addedJounceContextual

Array of Jounce contextual ids to be added.

array

Optional

removed

Array of Jounce contextual Ids to be removed.

array

Optional

clearAll

Indicates if all existing targeted Jounce contextuals should be removed. By default, the value is false.

  • If true, remove all targeted Jounce Contextuals. This will disable CURATION targeting.

  • If false, do not remove any targeted curationContextuals.

boolean

Optional

types

Specifies an array of targeting types. CURATION must be included to apply changes.

string

Required

Sample Request URL

POST traffic/lines/{lineId}/targeting

Sample Request (Line-Level)

{
   "curationContextuals": {
       "addedJounceContextual": [
           60368,
           60369
       ],
       "removed": [],
       "clearAll": false
   },
   "types": [
       {
           "isTargeted": true,
           "name": "CURATION"
       }
   ]
}

Sample Response (Line-Level)

"response": {
     …
       "curationContextuals": [
           {
               "id": 60368,
               "accountId": 123,
               "name": "Premium Publisher-Controlled",
               "updatedAt": "2025-06-18T08:11:56Z",
               "categories": [
                   {
                       "id": 458493,
                       "categoryId": 55006767
                   }
               ],
               "taxonomyType": "JOUNCE_SPO_CURATION"
           },
           {
               "id": 60369,
               "accountId": 123,
               "name": "Premium Intermediary-Controlled",
               "updatedAt": "2025-06-18T08:11:56Z",
               "categories": [
                   {
                       "id": 458494,
                       "categoryId": 55006768
                   }
               ],
               "taxonomyType": "JOUNCE_SPO_CURATION"
           }
       ]
   },
   "errors": null,
   "timeStamp": "2025-11-06T21:43:12.934Z"
}

Read Jounce Supply Path Optimization Targeting

Retrieve the current Jounce targeting for a specified line.

GET /traffic/lines/{lineId}/targeting

Parameters

The line ID is specified in the path of the URL. All other parameters are specified in the body of the application/json payload.

Sample Request URL

GET traffic/lines/{lineIid}/targeting

Sample Response

{
   "response": {
     …
       "curationContextuals": [
           {
               "id": 60368,
               "accountId": 123,
               "name": "Premium Publisher-Controlled",
               "updatedAt": "2025-06-18T08:11:56Z",
               "categories": [
                   {
                       "id": 458493,
                       "categoryId": 55006767
                   }
               ],
               "taxonomyType": "JOUNCE_SPO_CURATION"
           },
           {
               "id": 60369,
               "accountId": 123,
               "name": "Premium Intermediary-Controlled",
               "updatedAt": "2025-06-18T08:11:56Z",
               "categories": [
                   {
                       "id": 458494,
                       "categoryId": 55006768
                   }
               ],
               "taxonomyType": "JOUNCE_SPO_CURATION"
           }
       ]
   },
   "errors": null,
   "timeStamp": "2025-11-06T21:43:12.934Z"
}

Related articles