About Targeting

20 Minutes to read

About Targeting

20 Minutes to read

Article summary

Did you find this summary helpful?

Thank you for your feedback!

Yahoo DSP enables you to target exchanges, deals, locations, demographics, ad positions, frequency, audiences, devices, and more.

Endpoint

traffic/lines/{lineId}/targeting

Use the following HTTP methods:

Use the GET method to view existing line targeting.
Use the POST method to create new line targeting.
Use the PUT method to update existing line targeting.

Resources

Targeting Types

Your ability to target consumers is constrained by the creatives served by the line.

The Yahoo DSP supports the following targeting types:

Targeting Type	Description	Display	Video	3P Native	Yahoo Native
`AB_TESTING`	If you have created user groups for A/B testing, you can target those user groups to display the results of your testing.	Y	Y	Y	N
`AD_INITIATION`	For video ads, you can set the type of ad initiation you want to target (Auto Initiated, User Initiated, Unknown, or All).	N	Y	N	N
`AD_POSITION`	Target the location on a page that you want your display ads to appear.	Y	N	Y	N
`BOT`	Note: Only available via special role. Ensure your ads are properly represented and delivered to real people, rather than to bot traffic.	Y	Y	Y	N
`CONNECTION`	You can target users based on how they are connected to the internet (wi-fi, cellular, or both). You can also target Internet Service Providers (ISPs) and Mobile Carriers, as follows: If you target wi-fi customers, you can also target users connected through particular ISPs. If you target cellular users, you can also target users connected through particular mobile carriers. If you target All connection types, you can target both ISPs and mobile carriers. Important: If you target both ISPs and mobile carriers, the targeting uses `OR` logic and targets a user who is connected through either an ISP or a mobile carrier you choose.	Y	Y	Y	N
`CONTEXTUALS`	If you have created contextuals for an advertiser, you can set up targeting to serve or exclude ads based on the contextual.	Y	Y	Y	Y
`DEMOGRAPHIC`	Reach your desired audience with age and gender targeting.	Y	Y	Y	Y
`ENHANCED_DAY_PARTING`	Choose the days and hours your display or video ads should serve.	Y	Y	Y	Y
`EXCHANGES`	A line can target or block one or more exchanges or target available private marketplace deals.	Y	Y	Y	N
`FREQUENCY_CAPPING`	Set a limit on how frequently an ad is shown to a user within a specified time frame.	Y	Y	Y	Y
`GEOGRAPHY`	Location targeting enables you to target specific geographical areas. You can target a country, state, city, metro area, sub region, region, Nielsen Designated Marketing Area (DMA), ZIP or postal code, postcode prefix, geofencing location, or a Points Of Interest (POI) category (USA only). Native lines can only target by Country/State/City/DMA. You can set up geofencing to target users within a specified radius of a given address.	Y	Y	Y	Y
`INVENTORY_TYPE`	You can explicitly target web vs. in-app supply.	Y	Y	Y	N
`LANGUAGES`	Target lines based on the language users most frequently view in their browsers. Advertisers can target or exclude specific languages.	Y	Y	Y	N
`MOBILE_PLACEMENT`	Enable targeting of consumers with interstitial and rewarded ads.	Y	Y	Y	N
`NATIVE_LIST`	If you have set up “native lists” (lists of apps and sites for Yahoo native lines), you can exclude those lists.	N	N	N	Y
`PLAYER_SIZE`	Enable targeting based on the player size.	N	Y	N	N
`SEGMENT`	If you have created audiences, you can perform line item targeting using include and exclude conditions.	Y	Y	Y	Y
`SITE_LISTS`	If you have set app lists and/or site lists to include and/or exclude apps and URLs, you can target those app lists and/or site lists.	Y	Y	N	N
`TECHNOLOGY`	Target users based on the technologies in their computing environment such as device type, operating system (desktop and mobile) and browser.	Y	Y	Y	Y
`VIDEO_CONTENT_LENGTH`	Enable targeting based on the video content length.	N	Y	N	N
`WEATHER`	Weather targeting enables you to target consumers based on the weather condition and UV.	Y	Y	Y	N
`DOOH_SCREEN_OWNERS`	Note: Only available For DOOH Lines. DOOH screen owners targeting enables you to target DOOH Screens based on screen owners (Media Owners).	Y	Y	N	N
`DOOH_VENUE_TYPES`	Note: Only available For DOOH Lines. DOOH Venue Types targeting enables you to target DOOH screens based on venue types.	Y	Y	N	N
`DOOH_SCREEN_LISTS`	Note: Only available For DOOH Lines. DOOH Screen Lists targeting enables you to target DOOH screens based on screen lists.	Y	Y	N	N
`DOOH_SCREEN_LISTS`	Note: Only available For DOOH Lines. DOOH Screen Lists targeting enables you to target DOOH screens based on screen lists.	Y	Y	N
`VIDEO_AD_PLACEMENTS`	Enable targeting of lines under Video Ad Placements.	Y	Y	N	N

Targeting Object

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 SEGMENT, EXCHANGES, and CONNECTION target types.

Note
Read-only fields are returned by Read Line Targeting requests.

Field	Description	Data Type	Target Type
`genders`	Specifies the genders targeted. `MALE` `FEMALE` `UNKNOWN` `ALL`	`array`	`DEMOGRAPHIC`
`ages`	Specifies the age ranges targeted. `18-20` `21-24` `25-34` `35-44` `45-49` `50-54` `55-64` `65-999` `UNKNOWN` `ALL`	`array`	`DEMOGRAPHIC`
`frequencyCapPeriod`	Specifies the frequency cap interval. `MINUTES` `HOURLY` `DAILY` `WEEKLY` `UNLIMITED` - No limit to the number of times the ad can be displayed.	`string`	`FREQUENCY_CAPPING`
`frequencyCapValue`	Specifies the number of impressions all for the selected `frequencyCapPeriod`. If `frequencyCapPeriod` selected is: `UNLIMITED` - Do not provide `frequencyCapPeriod` in the payload. `MINUTES` - The maximum time limit allowed for a minute is `5`. `HOURLY` - The maximum time limit allowed for an hour is `10`. `DAILY` - The maximum time limit allowed for a day is `20`. `WEEKLY` - The maximum time limit allowed for a week is `140`. `MONTHLY` - The maximum time limit allowed for a month is `600`.	`string`	`FREQUENCY_CAPPING`
`hhFrequencyCapEnabled`	A value of false means the limit will be set by People/Device. A value of true means the limit will be set by Household. Limit the frequency capping by Household is only for CTV lines.	boolean	`FREQUENCY_CAPPING`
`lineFrequencyCap`	Specifies multi-layer frequency cap for the line. With multi-layer frequency capping, you can set up to 3 layers of frequency capping. To learn more, refer to Line Multi-Layer Frequency Capping Targeting.	`object`	`FREQUENCY_CAPPING`
`serveUnknownUser`	Specifies whether the ad is served to known or unknown users: If `true`, serve to unknown users. If `false`, serve to known users only.	`boolean`	`FREQUENCY_CAPPING`
`dayParting`	Specifies the days of the week and hours of the day targeted. To learn more, refer to Day Parting Targeting.	`object`	`ENHANCED_DAY_PARTING`
`languages`	Specifies the languages targeted: `UNKNOWN` `ENGLISH` `CHINESE` `SPANISH` `JAPANESE` `PORTUGUESE` `GERMAN` `ARABIC` `FRENCH` `RUSSIAN` `DUTCH` `SWEDISH` `ITALIAN` `INDONESIAN` `ALL`	`array`	`LANGUAGES`
`inventoryTypes`	Specifies the inventory types targeted: `WEB` `APP` `ALL`	`array`	`INVENTORY_TYPE`
`bots`	Specifies the bot fraud prevention partner: `DOUBLE_VERIFY` `IAS`	`array`	`BOT`
`userGroupEntry`	Specifies the user group entry. For `POST`, you need to supply the `id` field, not the entire object.	`object`	`AB_TESTING`
`deviceTypes`	Specifies the device types targeted: `DESKTOP` `PHONE` `TABLET` `UNKNOWN` `ALL`	`array`	`TECHNOLOGY`
`os`	Specifies the operating system types targeted: `MAC` `WINDOWS` `LINUX` `OTHER` `ALL`	`array`	`TECHNOLOGY`
`browsers`	Specifies the browser types targeted. Note: `deviceTypes` must be set to `DESKTOP` to target `browsers`.	`array`	`TECHNOLOGY`
`mobileOs`	Specifies the mobile OS types targeted. Note: `deviceTypes` must be set to `PHONE` or `TABLET` to target `mobileOs`.	`array`	`TECHNOLOGY`
`adInitiations`	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`	`AD_INITIATION`
`positions`	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`	`AD_POSITION`
`playerSizes`	For video ads, the platform determines the player size based on height and width (in pixels) specified in the bid request. The platform extracts the larger of the two and assigns a player size: `SMALL` - Less than 350 pixels. `MEDIUM` - Between 350 and 500 pixels. `LARGE` - Greater than 500 pixels. `UNKNOWN` `ALL` - All player sizes. To learn more, refer to Player Size Targeting.	`array`	`PLAYER_SIZE`
`videoContentLength`	Video content length is the duration of the video a user is about to watch, not the duration of the ad. Valid values include: `UP_TO_TWO_MINUTES` - Any video that is less than 2 minutes long. `TWO_TO_FIVE_MINUTES` - Any video between 2:00 - 4:59 minutes in length. `FIVE_TO_THIRTY_MINUTES` - Any video between 5:00 - 29:59 minutes in length. `MORE_THAN_THIRTY_MINUTES` - Any video 30 minutes or longer. `UNKNOWN` - Any available video length. `ALL` To learn more, refer to Video Content Length Targeting.	`array`	`VIDEO_CONTENT_LENGTH`
`mobileCarriers`	Specifies the mobile carriers and ISPs targeted. Note: To target a mobile carrier, you need only specify the `id` field.	`array`	`CONNECTION`
`publishers`	Specifies the IDs of publishers/exchanges targeted. To learn more, refer to Exchange Targeting.	`array`	`EXCHANGES`
`deals`	Specifies private marketplace deals to target. To create or update targeted deals, refer to Deals Payload Object. To read deals that can be targeted, refer to Read Target Deals.	`array`	`EXCHANGES`
`priorityBuckets`	An array that contains 2 or 3 priority buckets. Each bucket contains targeted deals and exchanges and has an assigned priority. For details, refer to Priority Bucket Post Object and Priority Bucket Get Object.	`array`	`EXCHANGES`
`contextuals`	Specifies contextuals to target or exclude from targeting. To create or update targeted contextuals, refer to Contextuals Payload Object. To read contextuals that can be targeted, refer to Read Contextual.	`array`	`CONTEXTUALS`
`siteLists`	Specifies site lists and app lists to target or exclude from targeting. To create or update targeted site lists, refer to Add/Update Site Lists Targeting. To read site lists that can be targeted, refer to Read Site List Targets.	`array`	`SITE_LISTS`
`geos`	Specifies geographic locations to target or exclude from targeting. To create or update targeted geographic locations, refer to Geo. To read geographic locations that can be targeted, refer to Read Geos to Target. Note: You cannot target both geographic locations and geofencing locations at the same time.	`array`	`GEOGRAPHY`
`geoFencings`	Specifies geo fencing locations to target or exclude from targeting. To create or update targeted geo fencing locations, refer to Geo Fencing. Note: You cannot target both geographic locations and geofencing locations at the same time.	`array`	`GEOGRAPHY`
`pois`	Specifies points of interest resources to target within the set geographic locations. To retrieve the supported locations or types, refer to Read POI Locations. To create or update targeted points of interest resources, refer to Points of Interest (POI). Note: POI is only supported in United States. You cannot target both points of interest resources and geofencing locations at the same time.	`array`	`GEOGRAPHY`
`segments`	Specifies segments to target or exclude from targeting. To create or update targeted segments, refer to Segments Object. To read segments that can be targeted, refer to Read Segments.	`array`	`SEGMENT`
`mobilePlacements`	Specifies the mobile placement types: `INTERSTITIAL` - Interstitial ads are mobile placements that cover all or most of the user’s screen on an app. `REWARDED` - Rewarded ads allow users to opt-in to watching, or otherwise consuming, ads in exchange for some kind of benefit (i.e. points, lives, virtual goods, or premium content). `ALL` - Target all mobile placement types. To learn more, refer to Mobile Placements Targeting.	`array`	`MOBILE_PLACEMENT`
`weatherConditions`	Weather targeting is powered by the Yahoo Weather API. You can use weather targeting to target audiences based on the real-time or forecasted weather conditions of the user’s location. Valid values include: `SNOWY` `RAINY` `WINDY` `CLOUDY` `SUNNY` `STORMY` `ALL`	`array`	`WEATHER`
`weatherTemperatures`	The Yahoo Weather API powers the line’s weather targeting. You can use weather targeting to target audiences based on the real-time or forecasted weather temperature for the user’s location. Valid values are between -40 and 136 (Fahrenheit) or -40 and 58 (Celsius). For details, refer to Weather Condition Targeting.	`array`	`WEATHER`
`weatherHumidities`	The Yahoo Weather API powers the line’s weather targeting. You can use weather targeting to target audiences based on the real-time or forecasted weather humidity for the user’s location. Valid values are between 0% and 100%.	`array`	`WEATHER`
`weatherUV`	The Yahoo Weather API powers the line’s weather targeting. You can use weather targeting to target audiences based on the real-time or forecasted weather UV for the user’s location. Valid values include: `LOW` `MODERATE` `HIGH` `VERY HIGH` `EXTREME` `ALL` For details, refer to Weather UV Targeting.	`array`	`WEATHER`
`publishersIncluded`	A read-only array that specifies the publishers/exchanges included in targeting. To learn more, refer to Exchange Targeting.	`array`	`EXCHANGES`
`publishersExcluded`	A read-only array that specifies the publishers/exchanges excluded from targeting. To learn more, refer to Exchange Targeting.	`array`	`EXCHANGES`
`dealsIncluded`	A read-only array that specifies the deals included in targeting. To learn more, refer to Exchange Targeting.	`array`	`EXCHANGES`
`contextualsIncluded`	A read-only array that specifies the contextuals included in targeting. To learn more, refer to Contextuals Targeting.	`array`	`CONTEXTUALS`
`contextualsExcluded`	A read-only array that specifies the contextuals excluded from targeting. To learn more, refer to Contextuals Targeting.	`array`	`CONTEXTUALS`
`funnelAttributes`	A read-only array that shows the attributes of engagement events used during any funnel targeting efforts to retarget users with specific product sets. To learn more, refer to Funnel Targeting.	`array`	`TARGET_PRODUCT_FUNNEL`
`siteListsIncluded`	A read-only array of site lists and app lists that are included in targeting. To learn more, refer to Site List Targeting.	`array`	`SITE_LISTS`
`siteListsExcluded`	A read-only array of site lists and app lists that are excluded from targeting. To learn more, refer to Site List Targeting.	`array`	`SITE_LISTS`
`geosIncluded`	A read-only array of geo locations included in targeting. To learn more, refer to Geos Included Object.	`array`	`GEOGRAPHY`
`geosExcluded`	A read-only array of geofencing locations excluded from targeting by the line. To learn more, refer to Geos Excluded Object.	`array`	`GEOGRAPHY`
`geoFencingsIncluded`	A read-only array of geofencing locations included in targeting by the line. To learn more, refer to Geo Fencing.	`array`	`GEOGRAPHY`
`poisIncluded`	A read-only array of points of interest locations included in targeting by the line. To learn more, refer to Points of Interest (POI).	`array`	`GEOGRAPHY`
`segmentsIncluded`	A read-only array that shows the segments included in targeting. To learn more, refer to Segments Included Object.	`array`	`SEGMENT`
`segmentsExcluded`	A read-only array that shows the segments excluded from targeting. To learn more, refer to Segments Included Object.	`array`	`SEGMENT`
`doohScreenOwners`	Specifies DOOH Screen Owners IDs to target. To create or update targeted DOOH Screen Owners, refer to Add/Update DOOH Screen Owners Targeting. To read targeted DOOH Screen Owners, refer to Read DOOH Screen Owners Targeting.	`array`	`DOOH_SCREEN_OWNERS`
`doohVenueTypes`	Specifies DOOH Venue Types IDs to target. To create or update targeted DOOH venue types, refer to Add/Update DOOH Venue Types Targeting. To read targeted DOOH venue types, refer to Read DOOH Venue Types Targeting.	`array`	`DOOH_VENUE_TYPES`
`doohScreenLists`	Specifies DOOH Screen Lists IDs to target. To create or update targeted DOOH screen lists, refer to Add/Update DOOH Screen Lists Targeting. To read targeted DOOH screen lists, refer to Read DOOH Screen Lists Targeting.	`array`	`DOOH_SCREEN_LISTS`
`types`	Specifies the targeting types enabled and disabled for the line. To learn more, refer to Targeting Types.	`array`	N/A
`videoAdPlacements`	Specifies the video ad placement types: `INSTREAM` - Integrated directly into video content that users choose to watch, including pre-roll, mid-roll and post-roll formats. `OUTSTREAM` - displayed outside of a video player, such as within article content or social media feeds, and plays automatically when in view, usually with sound muted. `UNKNOWN` - video ad placement cannot be determined or is not specified. `ALL` To learn more, refer to Video Ad Placement Targeting.	`array`	N/A

Target Types Object

When reading (GET) existing line targeting, the types payload object shows all the targeting types which are enabled for the line.

When creating or updating (POST) line targeting, the types payload object contains all the targeting types which are to be enabled or modified.

Name	Description	Data Type
`name`	Specifies the name of the target type. For a complete list of target types, refer to Targeting Types.	`string`
`isTargeted`	Specifies whether the target type is enabled or disabled for the line. If `true`, the target type is enabled. If `false`, the target type is disabled.	`boolean`

Name

Description

Data Type

name

Specifies the name of the target type.

For a complete list of target types, refer to Targeting Types.

string

isTargeted

Specifies whether the target type is enabled or disabled for the line.

If true, the target type is enabled.
If false, the target type is disabled.

boolean

Sample Payload (Partial)

{
  "types": [
    {
      "isTargeted": true,
      "name": "SITE_LISTS"
    },
    {
      "isTargeted": true,
      "name": "AD_POSITION"
    }
  ]
}

Read Line Targeting

Returns targeting data for the specific line.

GET /traffic/lines/{id}/targeting

Parameters

Name	Parameter Type	Description	Data Type	Required
`id`	path	Specifies the line ID.	`integer`	Y

Example Request

GET https://dspapi.admanagerplus.yahoo.com/traffic/lines/365277/targeting

Example Response

The response returns information about target types targeted by the line.

{
  "response": {
    "types": [
      {
        "name": "GEOGRAPHY",
        "isTargeted": true
      },
      {
        "name": "PLAYER_SIZE",
        "isTargeted": true
      },
      {
        "name": "VIDEO_CONTENT_LENGTH",
        "isTargeted": true
      },
      {
        "name": "AD_INITIATION",
        "isTargeted": true
      },
      {
        "name": "VIDEO_INVENTORY",
        "isTargeted": true
      },
      {
        "name": "DEMOGRAPHIC",
        "isTargeted": true
      },
      {
        "name": "FREQUENCY_CAPPING",
        "isTargeted": true
      },
      {
        "name": "AB_TESTING",
        "isTargeted": true
      },
      {
        "name": "SEGMENT",
        "isTargeted": true
      },
      {
        "name": "TECHNOLOGY",
        "id": 7,
        "isTargeted": true
      },
      {
        "name": "ENHANCED_DAY_PARTING",
        "isTargeted": false
      },
      {
        "name": "SITE_LISTS",
        "isTargeted": true
      },
      {
        "name": "CONTEXTUALS",
        "isTargeted": true
      },
      {
        "name": "EXCHANGES",
        "isTargeted": true
      },
      {
        "name": "MOBILE",
        "isTargeted": true
      },
      {
        "name": "LANGUAGES",
        "isTargeted": true
      },
      {
        "name": "SEAT_LEVEL_SITE_LISTS",
        "isTargeted": true
      },
      {
        "name": "BOT",
        "isTargeted": true
      },
      {
        "name": "INVENTORY_TYPE",
        "isTargeted": true
      }
    ],
    "mobileCarriers": [
      "Verizon"
    ],
    "isps": [
      "Colt Technology Services"
    ],
    "genders": [
      "MALE",
      "FEMALE"
    ],
    "ages": [
      "55-64",
      "65-999",
      "18-20",
      "21-24",
      "45-49",
      "50-54"
    ],
    "days": [
      "ALL"
    ],
    "deviceTypes": [
      "UNKNOWN",
      "TABLET"
    ],
    "os": [
      "ALL"
    ],
    "browsers": [
      "ALL"
    ],
    "mobileOs": [
      "ANDROID",
      "IOS"
    ],
    "languages": [
      "ENGLISH",
      "GERMAN"
    ],
    "inventoryTypes": [
      "APP"
    ],
    "playerSizes": [
      "MEDIUM",
      "LARGE"
    ],
    "videoContentLength": [
      "UP_TO_TWO_MINUTES",
      "UNKNOWN"
    ],
    "weatherConditions": [
      "STORMY",
      "SUNNY"
    ],
    "weatherHumidities": {
      "minHumidity": 10,
      "maxHumidity": 50,
      "allHumidities": false
    },
    "weatherUVs": [
      "LOW",
      "MODERATE"
    ],
    "weatherTemperatures": {
      "minTemp": 10,
      "maxTemp": 50,
      "isFahrenheit": true
    },
    "adInitiations": [
      "USERINITIATED"
    ],
    "bots": [
      "DOUBLE_VERIFY"
    ],
    "positions": [
      "ALL"
    ],
    "userGroupEntry": {
      "id": 32659,
      "name": "sg2",
      "userGroupId": 14962,
      "trafficPercent": 56,
      "lowerBound": 0,
      "upperBound": 55
    },
    "contextualsIncluded": [
      {
        "taxonomyType": "IAB",
        "id": 43505,
        "accountId": 7987,
        "name": "iabtest5566",
        "updatedAt": "2017-08-01T22:08:52Z",
        "categories": [
          {
            "id": 132269,
            "categoryId": 107
          },
          {
            "id": 132270,
            "categoryId": 102
          }
        ]
      }
    ],
    "contextualsExcluded": [
      {
        "taxonomyType": "DOUBLE_VERIFY",
        "id": 43236,
        "accountId": 7987,
        "name": "contextual_update_test",
        "updatedAt": "2017-07-17T23:58:28Z",
        "categories": [
          {
            "id": 131535,
            "categoryId": 6
          },
          {
            "id": 131536,
            "categoryId": 9
          }
        ]
      }
    ],
    "siteListsIncluded": [
      {
        "id": 47539,
        "name": "TestSiteList_1459797912042",
        "accountName": "test-advertiser",
        "createdAt": "2018-11-13T00:50:23Z",
        "updatedAt": "2018-11-13T00:52:11Z",
        "totalSites": 3,
        "type": "SITE_LIST"
      }
    ],
    "siteListsExcluded": [
      {
        "id": 56919,
        "name": "Test Mobile 11/28",
        "accountName": "test-advertiser",
        "createdAt": "2017-04-10T23:21:39Z",
        "updatedAt": "2019-08-21T20:29:58Z",
        "totalSites": 1,
        "type": "APP_LIST"
      }
    ],
    "publishers": [
      {
        "id": 3,
        "name": "BRXD"
      },
      {
        "id": 4,
        "name": "Rubicon"
      },
      {
        "id": 67,
        "name": "AdForm(BSW)"
      },
      {
        "id": 74,
        "name": "A9"
      }
    ],
    "geosIncluded": [
      {
        "id": "#######ab#can",
        "name": "Alberta, Canada",
        "description": "alberta",
        "level": "State",
        "key": "ab, can",
        "excluded": false
      },
      {
        "id": "########can",
        "name": "Canada",
        "description": "canada",
        "level": "Country",
        "key": "can",
        "excluded": false
      },
      {
        "id": "#######15#nor",
        "name": "More Og Romsdal, Norway",
        "description": "more og romsdal",
        "level": "State",
        "key": "15, nor",
        "excluded": false
      }
    ],
    "geosExcluded": [
      {
        "id": "###callahan####fl#usa",
        "name": "Callahan, Florida",
        "description": "callahan, fl",
        "level": "City",
        "key": "callahan, florida",
        "excluded": true
      }
    ],
    "segmentsIncluded": [
      {
        "id": "20604896",
        "name": "Penny Dreadful S3 BrightRoll Test",
        "recency": 30,
        "createdAt": "2015-12-08",
        "audienceType": "3rd Party",
        "segmentType": "COMPOSITE",
        "reachCount": 449491095
      }
    ],
    "segmentsExcluded": [
      {
        "id": "50348744",
        "name": "FlyWheel Studio Test",
        "recency": 90,
        "createdAt": "2017-10-13",
        "audienceType": "3rd Party",
        "segmentType": "COMPOSITE",
        "reachCount": 617452399
      },
      {
        "id": "20703845",
        "name": "MB Test - HHI 75k+",
        "recency": 30,
        "createdAt": "2016-05-04",
        "audienceType": "3rd Party",
        "segmentType": "COMPOSITE",
        "reachCount": 135984850
      }
    ],
    "threshold": 40,
    "frequencyCapValue": 2,
    "frequencyCapPeriod": "HOURLY",
    "serveUnknownUser": true,
    "enableViewabilityFreqCap": false,
  },
  "errors": null,
  "timeStamp": "2018-01-12T01:57:40Z"
}

Add/Update Line Targeting

Adds or updates the specified targets for the specified line.

POST traffic/lines/{id}/targeting/

Parameters

All requests to add or update targets to a line require id and types fields.

Name	Parameter Type	Description	Data Type
`id`	path	Specifies the line ID.	`integer`
`types`	body	Specifies an array of Targeting Type objects that identify the targeting type and whether it is targeted by the line. If `true`, the line targets the specified targeting type. If `false`, the line does not target the specified targeting type. To learn more, refer to Targeting Types.	`array`
`genders`	body	Specifies the genders targeted. To learn more, refer to Demographic Targeting.	`array`
`ages`	body	Specifies the age ranges targeted. To learn more, refer to Demographic Targeting.	`array`
`frequencyCapPeriod`	body	Specifies the frequency cap interval. To learn more, refer to Frequency Capping Targeting.	`string`
`frequencyCapValue`	body	Specifies the number of impressions all for the selected `frequencyCapPeriod`. To learn more, refer to Frequency Capping Targeting.	`string`
`serveUnknownUser`	body	Specifies whether the ad is served to known or unknown users. To learn more, refer to Frequency Capping Targeting.	`boolean`
`dayParting`	body	Specifies the days of the week and hours of the day targeted. To learn more, refer to Day Parting Targeting.	`object`
`languages`	body	Specifies the languages targeted. To learn more, refer to Language Targeting.	`array`
`inventoryTypes`	body	Specifies the inventory types targeted.	`array`
`bots`	body	Specifies the bot fraud prevention partner. To learn more, refer to Fraud Avoidance.	`array`
`userGroupEntry`	body	Specifies the ID of the user group to target. To learn more, refer to A/B Testing Targeting.	`object`
`deviceTypes`	body	Specifies the device types targeted. To learn more, refer to Technology Targeting.	`array`
`os`	body	Specifies the operating system types targeted. To learn more, refer to Technology Targeting.	`array`
`browsers`	body	Specifies the browser types targeted. To learn more, refer to Technology Targeting. Note: `deviceTypes` must be set to `DESKTOP` to target `browsers`.	`array`
`mobileOs`	body	Specifies the mobile OS types targeted. To learn more, refer to Technology Targeting. Note: `deviceTypes` must be set to `PHONE` or `TABLET` to target `mobileOs`.	`array`
`adInitiations`	body	For video ads, specifies how the targeted ad is initiated. To learn more, refer to Ad Initiation Targeting.	`array`
`positions`	body	For display ads, specifies the location on the page where the ad appears. To learn more, refer to Ad Position Targeting.	`array`
`playerSizes`	body	For video ads, the platform determines the player size based on height and width (in pixels) specified in the bid request. The platform extracts the larger of the two and assigns a player size. To learn more, refer to Player Size Targeting.	`array`
`videoContentLength`	body	Video content length is the duration of the video a user is about to watch, not the duration of the ad. To learn more, refer to Video Content Length Targeting.	`array`
`mobileCarriers`	body	Specifies the mobile carriers and ISPs targeted. To learn more, refer to Connection Targeting.	`array`
`publishers`	body	Specifies the IDs of publishers/exchanges targeted. To learn more, refer to Exchange Targeting.	`array`
`deals`	body	Specifies the IDs of private marketplace deals to target. To learn more, refer to Exchange Targeting.	`array`
`contextuals`	body	Specifies contextuals to include or exclude from targeting. To learn more, refer to Contextuals Targeting.	`array`
`siteLists`	body	Specifies site lists and app lists to include or exclude from targeting. To learn more, refer to Site List Targeting.	`array`
`geos`	body	Specifies geographic locations to include or exclude from targeting. To learn more, refer to Geography Targeting. Note: You cannot target both geographic locations and geofencing locations at the same time.	`array`
`geoFencings`	body	Specifies geofencing locations to include or exclude from targeting. To learn more, refer to Geography Targeting. Note: You cannot target both geographic locations and geofencing locations at the same time.	`array`
`segments`	body	Specifies audience segments to include or exclude from targeting. To learn more, refer to Segment Targeting.	`array`
`mobilePlacements`	body	Specifies the mobile placement types targeted. To learn more, refer to Mobile Placements Targeting.	`array`
`weatherConditions`	body	Specifies the weather conditions targeted. To learn more, refer to Weather Condition Targeting.	`array`
`weatherHumidities`	body	Specifies the weather humidity targeted. To learn more, refer to Weather Humidity Targeting.	`array`
`weatherUVs`	body	Specifies the weather UVs targeted. To learn more, refer to Weather UV Targeting.	`array`
`weatherTemperatures`	body	Specifies the weather temperature targeted. To learn more, refer to Weather Temperature Targeting.	`array`
`videoAdPlacements`	body	Specifies the video ad types targeted. To learn more, refer to Video Ad Placements Targeting.	`array`

For each targeting type the line targets, you must specify the payload for that target.

Example Request

The line ID is specified in the path of the resource endpoint:

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

All other parameters are specified in the body of the application/json payload.

{
  "id": 412063,
  "deviceTypes": [
    "DESKTOP",
    "PHONE"
  ],
  "os": [
    "MAC"
  ],
  "browsers": [
    "FIREFOX"
  ],
  "mobileOs": [
    "IOS",
    "ANDROID"
  ],
  "iosVersionRange":[
    "10.1", "12.1"
  ],
  "androidVersionRange":[
    "8", "latest"
  ],
  "mobileMakes": [
    4,
    5,
    6
  ],
  "mobileModels": [
    12,
    20
  ],
  "types": [
    {
      "name": "TECHNOLOGY",
      "id": 7,
      "isTargeted": true
    }
  ]
}

Was this article helpful?

What's Next

A/B Testing Targeting

Contents

Targeting Types
Targeting Object
Parameters
Example Request
Example Response