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

> ## 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 Initiation Targeting

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

# Overview

The Yahoo DSP supports `AD_INITIATION` targeting for lines serving video and native ads.

# Endpoint

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

- A `GET` request enables you to view ad initiations targeted by the specified line.
- A `POST` request enables you to target ad initiations 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_INITIATION` targeting type-specific fields:

| **Parameter** | **Parameter Type** | **Definition** | **Data Type** | **Required** |
| --- | --- | --- | --- | --- |
| `id` | path | Specifies the line ID. | `integer` | Y |
| `adInitiations` | body | For video ads, specifies how the targeted ad is initiated: - `AUTOINITIATED` - The video starts without any user action. - `USERINITIATED` - The video starts only if the user clicks Play. - `UNKNOWN` - `ALL` | `array` | Y |
| `types` | body | Specifies an array of targeting types to update, enable, or disable. `AD_INITIATION` 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 Initiation Targeting

Specifies video and native ads to target based on how they were initiated.

```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/
```

## Sample Request Body

```plaintext
{
  "adInitiations": [
    "USERINITIATED"
  ],
  "types": [
    {
      "name": "AD_INITIATION",
      "isTargeted": true
    }
  ]
}
```

## Sample Response

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

### Additional Resources

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