Technology Targeting

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

Overview

Technology targeting enables you to target consumers based on the technologies in their computing environment. Consumers may be targeted by device type, operating system, mobile operating system, browser, and mobile device make or model.

The Yahoo DSP supports TECHNOLOGY targeting for lines serving display, video, and native ads.

Endpoint

/traffic/lines/{id}/targeting

• A GET request enables you to view technology targeted by the specified line.

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

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

Targeting Object

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

Mobile Make Object

The Read Mobile Makes API returns an array of Mobile Make objects.

Mobile Model Object

The Read Mobile Models API returns an array of Mobile Model objects.

Read Technology 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 deviceTypes, os, browsers, and mobileOS.

To learn more, refer to Read Line Targeting.

Example Request URL

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

Example Response

{
  "response": {
    "types": [
      {
        "name": "TECHNOLOGY",
        "isTargeted": true
      }
    ],
    "mobileMakes": [
      "LG"
    ],
    "mobileModels": [
      "iPhone 6S",
      "Apple iPhone SE"
    ],
    "deviceTypes": [
      "PHONE",
      "DESKTOP"
    ],
    "os": [
      "ALL"
    ],
    "browsers": [
      "ALL"
    ],
    "mobileBrowsers": [
      "ALL"
    ],
    "mobileOS": [
      "ANDROID",
      "IOS"
    ]
  },
  "errors": null,
  "timestamp": "2018-02-22T00:24:22Z"
}

Add/Update Technology Targeting

Add or update the technology targeting for the specific 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.

Depending on the parameters specified, you can target consumers based on device types, operating systems, browsers, mobile operating systems, mobile device makes or mobile device models.

Device type, mobile OS, mobile make, and mobile model targeting are interdependent.

• The mobileOS parameter constrains the mobileMakes parameter.

• The deviceType parameter constrains the mobileModels parameter.

• The mobileMakes parameter constrains the mobileModels parameter.

To learn more, refer to Status and Error Codes.

Example Request URL

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

Example Request Body

{
  "mobileMakes": [
    1
  ],
  "mobileModels": [
    9
  ],
  "deviceTypes": [
    "DESKTOP",
    "PHONE"
  ],
  "os": [],
  "browsers": [],
  "mobileBrowsers": [],
  "mobileOS": [
    "IOS"
  ],
  "iosVersionRange": [
    "11.0"
  ],
  "androidVersionRange": [
    "7.1"
  ],
  "types": [
    {
      "name": "TECHNOLOGY",
      "isTargeted": true
    }
  ]
}

Example Response

{
  "response": {
    "types": [
      {
        "name": "TECHNOLOGY",
        "isTargeted": true
      }
    ],
    "deviceTypes": [
      "DESKTOP",
      "PHONE"
    ],
    "os": [],
    "browsers": [],
    "mobileBrowsers": [],
    "mobileOS": [
      "ALL"
    ],
    "IOSVersions": [
      "11.0",
      "LATEST"
    ],
    "AndriodVersions": [
      "7.1",
      "LATEST"
    ],
    "mobileMakes": [
      "Apple"
    ],
    "mobileModels": [
      "Google Nexus 6"
    ]
  },
  "errors": null,
  "timeStamp": "2018-04-19T21:47:05Z"
}

Status and Error Codes

Read Mobile Makes

Returns a list of mobile makes.

GET /traffic/targeting/mobilemakes

If no query parameters are specified, mobile makes are returned for all operating systems.

The resource returns an array of Mobile Make objects that include the mobileOS, mobileMake, id. Use the mobile make ID to target consumers based on their mobile make. To learn more, refer to Add/Update Technology Targeting.

Parameters

All parameters are specified as a query appended to the end of the endpoint URL.

Example Request URL

GET traffic/targeting/mobilemakes?mobileOSes=IOS,ANDROID

Example Response

{
  "response": [
    {
      "id": 1,
      "mobileMake": "Apple",
      "mobileOS": "IOS"
    },
    {
      "id": 2,
      "mobileMake": "Google",
      "mobileOS": "ANDROID"
    }
  ],
  "errors": null,
  "timeStamp": "2018-01-12T01:07:13Z"
}

Read Mobile Models

Returns a list of mobile models.

GET /traffic/targeting/mobilemodels

If no query parameters are specified, mobile models are returned for all operating systems and device types.

The resource returns an array of Mobile Model objects that include the modelName, mobileMake, id. Use the mobile model ID to target consumers based on their mobile model. To learn more, refer to Add/Update Technology Targeting.

Parameters

All parameters are specified as a query appended to the end of the endpoint URL.

Example Request URL

GET traffic/targeting/mobilemodels?mobileOSes=IOS,ANDROID&deviceTypes=PHONE&limit=5000&page=1

Example Response

{
  "response": [
    {
      "id": 1,
      "modelName": "Sony Xperia Z3",
      "deviceType": "Phone",
      "mobileOS": "ANDROID",
      "mobileMake": "Sony"
    },
    {
      "id": 2,
      "modelName": "HTC One M7",
      "deviceType": "Phone",
      "mobileOS": "ANDROID",
      "mobileMake": "HTC"
    }
  ],
  "errors": null,
  "timeStamp": "2018-01-12T01:07:13Z"
}

Read Mobile OS Versions

Returns a list of iOS or Android mobile operating system versions.

GET /traffic/targeting/mobileosversions

Parameters

All parameters are specified as a query appended to the end of the endpoint URL.

Example Request URL

GET traffic/targeting/mobileosversions?mobileOSes=IOS,ANDROID

Example Response

{
  "response": {
    "IOSVersions": [
      "latest",
      "1.0",
      "1.1",
      "2.0",
      "2.1",
      "2.2",
      "3.0",
      "3.1",
      "3.2",
      "4.0",
      "4.1",
      "4.2",
      "4.3",
      "5.0",
      "5.1",
      "6.0",
      "6.1",
      "7.0",
      "7.1",
      "8.0",
      "9.0",
      "10.0",
      "8.1",
      "8.2",
      "8.3",
      "8.4",
      "9.1",
      "9.2",
      "9.3",
      "10.1",
      "10.2",
      "10.3",
      "11.0",
      "11.1",
      "12.0",
      "12.1",
      "13.0",
      "14.0",
      "14.1",
      "14.2",
      "14.3",
      "14.4",
      "14.5",
      "14.6",
      "14.7",
      "14.8",
      "15.0",
      "15.1",
      "15.2",
      "15.3",
      "15.4"
    ],
    "AndroidVersions": [
      "latest",
      "0.5",
      "1",
      "1.1",
      "1.5",
      "1.6",
      "2",
      "2.1",
      "2.2",
      "2.3",
      "2.4",
      "3",
      "3.1",
      "3.2",
      "4",
      "4.1",
      "4.2",
      "4.3",
      "4.4",
      "5",
      "6",
      "7",
      "5.1",
      "7.1",
      "8",
      "8.1",
      "9",
      "10",
      "11",
      "12"
    ]
  },
  "errors": null,
  "timeStamp": "2021-03-10T19:14:13.814Z"
}

Additional Resources

About Targeting