Ads.txt Targeting¶

This article describes resources that enable you to read and define ads.txt declarations.

Overview¶

You can target your ads.txt declaration preferences so that impressions deliver only to the appropriate inventory.

Endpoint¶

/traffic/lines/{id}/targeting

A GET request enables you to view ads.txt preferences by the specified line.
A POST request enables you to target ads.txt preferences 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 SELLER_RELATIONSHIPS target type.

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

Parameter	Parameter Type	Description	Data Type	Required
`id`	path	Specifies the line ID.	`integer`	Y
`sellerRelationships`	body	Specifies the settings targeted: `UNKNOWN` - Impressions on domains that have no ads.txt file published. `DIRECT` - Impressions on domains that have an ads.txt declaration of Direct for the given publishers and supply partners. `RESELLER` - Impressions on domains that have an ads.txt declaration of Reseller for the given publishers and supply partners. `ALL`	`array`	Y
`types`	body	Specifies an array of targeting types to update, enable, or disable. `SELLER_RELATIONSHIPS` 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.

integer

sellerRelationships

body

Specifies the settings targeted:

UNKNOWN - Impressions on domains that have no ads.txt file published.
DIRECT - Impressions on domains that have an ads.txt declaration of Direct for the given publishers and supply partners.
RESELLER - Impressions on domains that have an ads.txt declaration of Reseller for the given publishers and supply partners.
ALL

array

types

body

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

SELLER_RELATIONSHIPS 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 Ads.txt Targeting¶

Add or update Ads.txt 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¶

{
  "sellerRelationships": [
    "DIRECT"
  ],
  "types": [
    {
      "name": "SELLER_RELATIONSHIPS",
      "isTargeted": true
    }
  ]
}

Example Response¶

{
  "response": {
    "types": [
      {
        "name": "SELLER_RELATIONSHIPS",
        "isTargeted": true
      }
    ],
    "sellerRelationships": [
      "DIRECT"
    ],
    "errors": null,
    "timeStamp": "2018-01-12T01:57:40Z"
  }
}