Inventory Auction Type Targeting

Use Inventory Auction Type targeting to configure whether a line participates in First Price or Second Price auctions. Explicitly target either auction type or set the option to ALL, which represents no specific targeting applied.

Endpoint

/traffic/lines/{id}/targeting

Use the following HTTP methods:

• Use the GET method to view line targeting.

• Use the POST method to edit line targeting.

Parameters

Add/Update Inventory Auction Type

Add or update Inventory Auction Type for the specified line.

POST  traffic/lines/{id}/targeting/

Sample Request URL

POST https://dspapi.admanagerplus.yahoo.com/traffic/lines/{id}/targeting

Sample Request Body

{
  "auctionType": "FIRST_PRICE",
  "types": [
    {
      "name": "AUCTION_TYPE",
      "isTargeted": true
    }
  ]
}

Sample Response

{
     ...
    "auctionType": "FIRST_PRICE",
    "types": [
      {
        "name": "AUCTION_TYPE",
        "isTargeted": true
     }
        ],
      ...
    },
    "errors": null,
    "timeStamp": "2025-11-14T17:47:09.077Z"
}

Note

• When isTargeted is set to false, the auction type configuration is not applied regardless of the auctionType value passed in the request.

• When "auctionType": "ALL", the DSP treats this as no specific auction targeting and the line returns "isTargeted": false.

• This feature applies only at the line level within the Traffic API.

Read Inventory Auction Type

Retrieve the current inventory auction Type for a specified line.

GET /traffic/lines/{id}/targeting/

Parameters

Sample Request URL (Line-Level)

GET https://dspapi.admanagerplus.yahoo.com/traffic/lines/{id}/targeting/

Sample Response (Line-Level)

{
     ...
    "auctionType": "FIRST_PRICE",
    "types": [
      {
        "name": "AUCTION_TYPE",
        "isTargeted": true
     }
        ],
      ...
    },
    "errors": null,
    "timeStamp": "2025-11-14T17:47:09.077Z"
}

Sample Response (Line-Level)

{
  "isTargeted": false,
  "name": "AUCTION_TYPE"
}