Completion Rate Targeting

The Yahoo DSP supports the COMPLETION_RATE targeting parameter for video line items. Use completion rate threshold targeting to define what percentage of impressions to be 100 % completed.

For example, if completionRateThreshold is set to 60, this will target impressions with a 60% probability or higher to be completed.

Endpoint

he Yahoo DSP supports the COMPLETION_RATE targeting parameter for video line items.

/traffic/lines/{id}/targeting

Use the following HTTP methods.

Use the GET method to retrieve the completion rate thresholds configured for the specified line.
Use the POST method to apply the completion rate threshold targeting to a specified line.

Required and Supported Parameters

The targeting resource is the standard Yahoo DSP resource for targeting consumers based on their profiles, behaviors and ad content.

This resource comprises multiple fields that enable you to specify line targeting across many types of targets, including the COMPLETION_RATE target type.

The targeting resource is defined by the following COMPLETION_RATE targeting type-specific fields.

Parameter	Parameter Type	Description	Data Type	Required
`id`	path	The line ID.	`integer`	Y
`completionRateThreshold`	body	The completion rate threshold, expressed as a value between 1-100. Defines what percentage of impressions to be 100 % completed.	`number`	Required if adding or updating a completion rate target
`completionRateVendorld`	body	The vendor associated with the threshold. The default vendor is “0” for Yahoo+ Targeting.	`integer`	Y
`types`	body	Specifies an array of targeting types to update, enable or disable. The `COMPLETION_RATE` targeting type must be specified to apply the changes.	`array`	Y

Note
The Targeting Object section on the About Targeting article provides a complete list of targeting resource fields.

Add/Update Completion Rate Targeting

Add or update completion rate targeting for the specified line.

POST traffic/lines/{id}/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

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

Sample Request Body

{
"completionRateVendorId": 0,
"completionRateThreshoId": 56.00,
  "types": [
    {
      "name": "COMPLETION_RATE",
      "isTargeted": true
    }
  ]
}

Sample Response

{
  "response": {
    "types": [
      {
        "isTargeted": true,
        "name": "COMPLETION_RATE"
      }
    ],
    "completionRateThreshold": 56,
    "completionRateVendorId": 0
  },
  "errors": null,
  "timeStamp": "2025-09-19T17:25:15.533Z"
}