Language Targeting

This article describes resources that enable you to read and define language targeting.

Overview

Target lines based on the language users most frequently view in their browsers. Advertisers can target or exclude specific languages.

The Yahoo DSP supports LANGUAGES targeting for lines serving display and video ads.

Endpoint

/traffic/lines/{id}/targeting
  • A GET request enables you to view languages targeted by the specified line.

  • A POST request enables you to target languages 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.

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

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

Parameter

Parameter Type

Description

Data Type

Required

id

path

Specifies the line ID.

integer

Y

languages

body

Specifies the languages targeted:

  • UNKNOWN

  • ENGLISH

  • CHINESE

  • SPANISH

  • JAPANESE

  • PORTUGUESE

  • GERMAN

  • ARABIC

  • FRENCH

  • RUSSIAN

  • DUTCH

  • SWEDISH

  • ITALIAN

  • INDONESIAN

  • ALL

array

Y

types

body

Specifies an array of targeting types to update, enable, or disable.

LANGUAGES targeting type must be specified to apply the changes.

To learn more, refer to Targeting Types.

array

Y

Note

For a complete list of targeting resource fields, refer to Targeting Object.

Add/Update Language Targeting

Add or update language 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.

Example Request URL

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

Example Request Body

{
  "languages": [
    "ENGLISH",
    "FRENCH"
  ],
  "types": [
    {
      "name": "LANGUAGES",
      "isTargeted": true
    }
  ]
}

Example Response

{
  "response": {
    "types": [
      {
        "name": "LANGUAGES",
        "isTargeted": true
      }
    ],
    "languages": [
      "ENGLISH",
      "FRENCH"
    ],
    "errors": null,
    "timeStamp": "2018-01-12T01:57:40Z"
  }
}

Additional Resources

About Targeting