Demographic Targeting

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

Overview

Reach your desired audience with age and gender targeting.

The Oath Ad Platforms DSP supports DEMOGRAPHIC targeting for lines serving display, video, and native ads.

Endpoint

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

Resources

The targeting resource is the standard Oath Ad Platforms 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 DEMOGRAPHIC target types.

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

Field Description Data Type
id Specifies the line ID. integer
genders

Specifies the genders targeted.

  • MALE
  • FEMALE
  • UNKNOWN
  • ALL
array
ages

Specifies the age ranges targeted.

  • 18-20
  • 21-24
  • 25-34
  • 35-44
  • 45-49
  • 50-54
  • 55-64
  • 65+
  • UNKNOWN
  • ALL
array

Note

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

Read Demographic Targets

Returns a list of targets for the specified line.

GET /traffic/lines/{id}/targeting

The resource returns information about all of the target types enabled and all of the targets specified for the line including genders and ages.

To learn more, see Read Line Targeting.

Add/Update Demographic Targets

Adds age and gender demographic targeting controls to the 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.

Parameter Parameter Type Description Data Type Required?
id path Specifies the line ID. integer Y
genders body

Specifies the genders targeted.

  • MALE
  • FEMALE
  • UNKNOWN
  • ALL
array Y
ages body

Specifies the age ranges targeted.

  • 18-20
  • 21-24
  • 25-34
  • 35-44
  • 45-49
  • 50-54
  • 55-64
  • 65+
  • UNKNOWN
  • ALL
array Y
types body

Specifies an array of targeting types to target. To target consumers by age or gender, DEMOGRAPHIC targeting type must be specified.

To learn more, see Targeting Types.

array Y

Example Request

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

POST traffic/lines/365277/targeting/

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

{
  "id": 365277,
  "genders": [
    "ALL"
  ],
  "ages": [
    "21-24",
    "65+",
    "UNKNOWN"
  ],
  "threshold": "60",
  "types": [
    {
      "name": "DEMOGRAPHIC",
      "isTargeted": true
    }
  ]
}

See also

About Targeting