placement

Get information about campaign banner placement.

Request format

Note

https://adfox.yandex.com/api/v1
  ? object=campaign
  & action=info
  & actionObject=placement
  & objectID=<integer>

objectID*

Campaign ID.

Response format

<response>
<status>
  <code>{integer}</code>
</status>
<result>
<data>
  <row0>
    <bannerID>{integer}</bannerID>
    <bannerName>{string}</bannerName>
    <siteID>{integer}</siteID>
    <siteName>{string}</siteName>
    <zoneID>{integer}</zoneID>
    <zoneName>{string}</zoneName>
    <placeID>{integer}</placeID>
    <placeName>{string}</placeName>
  </row0>
</data>
</result>
</response>

Response parameters

`code`	Request processing status. For the key, see Error handling.
`rows`	Number of items in the response tree.
`rowN`	The item number in the response tree, where N is a number from 0 to rows-1 (where `rows` is the total number of items in the response).
`bannerID`	Banner ID.
`bannerName`	Banner name.
`siteID`	ID of the website in management.
`siteName`	Name of the website in management.
`zoneID`	Site section ID.
`zoneName`	Site section name.
`placeID`	Placement ID.
`placeName`	Placement name.

Sample request and response

Request:

https://adfox.yandex.com/api/v1?object=campaign&action=info&actionObject=placement&objectID=474205

Response:

<response>
<status>
  <code>0</code>
</status>
<result>
<data>
  <row0>
    <bannerID>1318267</bannerID>
    <bannerName>Banner 1</bannerName>
    <siteID>36161</siteID>
    <siteName>Site 1</siteName>
    <zoneID>75883</zoneID>
    <zoneName>Section Main</zoneName>
    <placeID>784270</placeID>
    <placeName>Placement 240х400</placeName>
  </row0>
</data>
</result>
</response>

Other actions with the object

See more actions with the campaign object:

Add a campaign.
Get a list of campaigns.
Delete a campaign.
Edit a campaign.
Get a list of campaign banners.
Place a campaign on a site, a site section, or a placement.

Was the article helpful?

campaign

placement2