targetingURL

Target a banner by URL.

This type of targeting is convenient if you need to show ads on a specific list of website pages or prohibit impressions on individual pages.

Request format

https://adfox.yandex.com/api/v1
  ? object=banner
  & action=target
  & actionObject=targetingURL
  & objectID=<integer>
  & isRedefined=<integer>
  & [templateType=<integer>]
  & [targetingUrlOn[]=<string>]
  & [targetingUrlOff[]=<string>]

objectID*

ID of the object that the action is performed on.

isRedefined*

Redefine targeting.

Acceptable values:

  • 0: Inherit targeting settings from a higher level. Level hierarchy from top to bottom:

    • Campaign.
    • Campaign on the site.
    • Campaign in the site section.
    • Campaign on the placement.
    • Banner.

  • 1: Cancel targeting settings at higher levels and use the settings of the current level.

templateType

Template type for targeting by URL.

Acceptable values:

  • 0: Standard. In the URL template, use the * symbol for a sequence of any characters of any length.
  • 1: POSIX. In the URL template, use regular expressions according to the POSIX standard.

Default value: 0.

targetingUrlOn[]

URL of the page where ad serving is allowed.

If there are multiple URLs, every URL must be passed in a separate parameter. The maximum number of parameters with a URL is 5.

Sample entry:

targetingUrlOn[]=url1&targetingUrlOn[]=url2...

targetingUrlOff[]

URL of the page where ad serving is prohibited.

If there are multiple URLs, every URL must be passed in a separate parameter. The maximum number of parameters with a URL is 5.

Sample entry:

targetingUrlOff[]=url1&targetingUrlOff[]=url2...

* Required

Response format

<response>
<status>
  <code>{integer}</code>
</status>
</response>

Response parameters

code

Request processing status. For the key, see Error handling.

Sample request and response

Request:

https://adfox.yandex.com/api/v1?object=banner&action=target&actionObject=targetingURL&objectID=474205&isRedefined=1&templateType=0&targetingUrlOn[]=*site.com/&targetingUrlOn[]=*site.com/*&targetingUrlOff[]=https://www.demo.site.com/*

Response:

<response>
<status>
  <code>0</code>
</status>
</response>

Other actions with the object

See more actions with the banner object:

URL of the page where ad serving is prohibited.

If there are multiple URLs, every URL must be passed in a separate parameter. The maximum number of parameters with a URL is 5.

Sample entry:

    
targetingUrlOff[]=url1&targetingUrlOff[]=url2...

Required

ID of the object that the action is performed on.

Redefine targeting.

Acceptable values:

  • 0: Inherit targeting settings from a higher level. Level hierarchy from top to bottom:

    • Campaign.
    • Campaign on the site.
    • Campaign in the site section.
    • Campaign on the placement.
    • Banner.

  • 1: Cancel targeting settings at higher levels and use the settings of the current level.

Template type for targeting by URL.

Acceptable values:

  • 0: Standard. In the URL template, use the * symbol for a sequence of any characters of any length.

  • 1: POSIX. In the URL template, use regular expressions according to the POSIX standard.

Default value: 0.

URL of the page where ad serving is allowed.

If there are multiple URLs, every URL must be passed in a separate parameter. The maximum number of parameters with a URL is 5.

Sample entry:

    
targetingUrlOn[]=url1&targetingUrlOn[]=url2...
Previous
targetingTime
Next
targetingUser