position

Add a position. You can use positions to create multiple placements in one site section with the same banner type. Usually, the position indicates the placement position in the site layout, for example: top, middle, or bottom of the page.

Request format

https://adfox.yandex.com/api/v1
  ? object=account
  & action=add
  & actionObject=position
  & name=<string>

name*

Object name. An entry can contain Russian and Latin letters, numbers, and any special characters.

* Required

Response format

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

Response parameters

code

Request processing status. If the value is 0, the request was completed successfully. For the key, see Error handling.

ID

Object ID.

Sample request and response

Request:

https://adfox.yandex.com/api/v1?object=account&action=add&actionObject=position&name=topline

Response:

<response>
<status>
  <code>0</code>
  <ID>5</ID>
</status>
</response>

Other actions with the object

See more actions with the position object:

Required

Object name. An entry can contain Russian and Latin letters, numbers, and any special characters.

Previous
place
Next
superCampaign