A/B Testing Targeting¶

This article describes resources that enable you to read and define A/B testing targeting.

Overview¶

The Verizon Media DSP supports AB_TESTING targeting for lines serving display and video ads.

If you have created user groups for A/B testing, you can target those user groups to see the results of your testing.

To learn more, see User Groups.

Endpoint¶

/traffic/lines/{id}/targeting

A GET request enables you to view user groups and other target types targeted by the specified line.
A POST request enables you to target user groups and other target types with the specified line.

Resource¶

The targeting resource is the standard Verizon Media DSP resource for targeting consumers based on their profiles, behaviors, and ad content.

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

Parameter	Parameter Type	Description	Data Type	Required
`id`	path	Specifies the line ID.	`number`	Y
`userGroupEntry`	body	Specifies the user group ID. For `POST`, you need to supply the `id` of the user group you want to target, not the entire object. To learn more, see User Group.	`object`	Y
`types`	body	Specifies an array of targeting types to update, enable, or disable. `AB_TESTING` targeting type must be specified to apply the changes. To learn more, see Targeting Types.	`array`	Y

Parameter

Parameter Type

Description

Data Type

Required

id

path

Specifies the line ID.

number

userGroupEntry

body

Specifies the user group ID.

For POST, you need to supply the id of the user group you want to target, not the entire object. To learn more, see User Group.

object

types

body

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

AB_TESTING targeting type must be specified to apply the changes.

To learn more, see Targeting Types.

array

Note

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

Add/Update User Group Targeting¶

Add or update user group targets for the specified line. Consumers may be targeted based on user group membership.

POST /traffic/lines/{id}/targeting

The AB_TESTING targeting type must be enabled in the body of the application/json payload.

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¶

{
  "userGroupEntry": {
    "id": 32658
  },
  "types": [
    {
      "name": "AB_TESTING",
      "isTargeted": true
    }
  ]
}

Example Response¶

{
  "response": {
    "types": [
      {
        "name": "AB_TESTING",
        "isTargeted": true
      }
    ],
    "userGroupEntry": {
      "id": 36519,
      "name": "zz57",
      "userGroupId": 16890,
      "trafficPercent": 60,
      "lowerBound": 0,
      "upperBound": 59
    }
  },
  "errors": null,
  "timeStamp": "2019-10-09T03:48:29Z"
}