---
title: "Ad Position"
slug: "ad-position"
updated: 2024-02-29T15:57:50Z
published: 2024-02-29T15:57:50Z
canonical: "help.yahooinc.com/ad-position"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.yahooinc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ad Position Targeting

*This article describes resources that enable you to read and define ad position targeting.*

# Overview

The Yahoo DSP supports `AD_POSITION` targeting for lines serving display ads.

## Endpoint

```plaintext
/traffic/lines/{id}/targeting
```

- A `GET` request enables you to view ad positions targeted by the specified line.
- A `POST` request enables you to target ad positions with the specified line.

## Resources

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

The `targeting` resource is defined by the following AD_POSITION targeting type-specific fields:

| **Parameter** | **Parameter Type** | **Definition** | **Data Type** | **Required** |
| --- | --- | --- | --- | --- |
| `id` | path | Specifies the line ID. | `integer` | Y |
| `positions` | body | For display ads, specifies location on the page where the ad appears: - `ABOVE_FOLD` - The ad serves on the top 50% of the page. - `PARTIAL_VIEW` - The ad serves when at least 25% of the ad is visible. - `BELOW_FOLD` - The ad serves on the bottom 50% of the page. - `UNKNOWN` - The ad serves in an unknown position. - `ALL` | `array` | Y |
| `types` | body | Specifies an array of targeting types to update, enable, or disable. `AD_POSITION` targeting type must be specified to apply the changes. To learn more, refer to [Targeting Types](/dsp-api/docs/about-targeting). | `array` | Y |

> [!NOTE]
> Note
> 
> For a complete list of targeting resource fields, refer to [Targeting Object](/dsp-api/docs/about-targeting).

# Add/Update Ad Position Targeting

Add or update ad position targets for the specified line.

```plaintext
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.

## Example Request URL

```plaintext
POST https://dspapi.admanagerplus.yahoo.com/traffic/lines/365277/targeting/
```

## Example Request Body

```plaintext
{
  "id": 365277,
  "positions": [
    "ABOVE_FOLD"
  ],
  "types": [
    {
      "name": "AD_POSITION",
      "isTargeted": true
    }
  ]
}
```

## Example Response

```plaintext
{
  "response": {
    "types": [
      {
        "name": "AD_POSITION",
        "isTargeted": true
      }
    ],
    "positions": [
      "ABOVE_FOLD"
    ],
    "errors": null,
    "timeStamp": "2018-01-12T01:57:40Z"
  }
}
```

### Additional Resources

[About Targeting](/dsp-api/docs/about-targeting)