updateDefaultBanner
Add a back up ad at the placement level.
The default banner is the banner code that's served if no banner from commercial ad campaigns can be served now.
You can set backup ads at the placement and/or banner type level.
If the backup ad isn't set for the placement, the backup ad set for the banner type is served. If a backup ad isn't set for the banner type, either, the server returns a placeholder that doesn't affect placement display on the site.
Request format
https://adfox.yandex.com/api/v1
? object=place
& action=updateDefaultBanner
& objectID=<integer>
& mode=<integer>
& [defaultImageURL=<string>]
& [defaultHitURL=<string>]
& [defaultWidth=<integer>]
& [defaultHeight=<integer>]
& [defaultCode=<string>]
& [defaultCodeType=<integer>]
|
|
ID of the object the action applies to. |
|
|
The mode for using the default banner. Acceptable values:
Default value: |
|
|
Backup ad image URL. Only for If |
|
|
This is the destination URL for the backup banner. Only for |
|
|
Image width in pixels. Only for |
|
|
Image height in pixels. Only for |
|
|
Backup ad. Only for |
|
|
Only for Ad tag type. Acceptable values:
Default value: |
Response format
<response>
<status>
<code>{integer}</code>
</status>
</response>
Response parameters
|
|
Request processing status. A value of |
Sample request and response
Request:
https://adfox.yandex.com/api/v1?object=place&action=updateDefaultBanner&objectID=234&mode=0Response:
<response> <status> <code>0</code> </status> </response>
Other actions with the object
Read about other actions with the place object:
- Add a placement.
- Delete a placement.
- Get a list of placements.
- Get a list of active banners on the placement.
- Edit placement parameters.
- Get an ad tag from the placement level.
- Create a Yandex Advertising Network ad unit and link it to a placement.
- Link an existing Yandex Advertising Network ad unit to a placement.
- Manage the ad unit status on a placement.
- Remove an ad unit from its placement and archive it in Yandex Advertising Network.
- Get a list of placements along with their details and data on Yandex Advertising Network ad units.
ID of the object the action applies to.
The mode for using the default banner.
Acceptable values:
0: File (only for standard and nondimensional banner types).1: Code.
Default value: 0.
Backup ad image URL.
Only for mode=0 and the Standard and Nondimensional banner types.
If defaultImageURL is specified, the defaultHitURL parameter becomes required.
This is the destination URL for the backup banner.
Only for mode=0 and the Standard and Nondimensional banner types.
Image width in pixels.
Only for mode=0 and the Nondimensional banner type.
Image height in pixels.
Only for mode=0 and the Nondimensional banner type.
Backup ad.
Only for mode=1 and the Nondimensional banner type.
Only for mode=1.
Ad tag type.
Acceptable values:
0: HTML.1: JavaScript.
Default value: 0.
e
Required parameter.