Adding a mobile ad unit

Info

Console

Request

POST

https://partner.yandex.ru/api/mobile/adunit

Partner API

Body

application/json

{}

Name	Description
...rest	oneOf AddAppOpenMobileAdUnit
...rest	oneOf AddRewardedMobileAdUnit
...rest	oneOf AddInterstitialMobileAdUnit
...rest	oneOf AddBannerMobileAdUnit
...rest	oneOf AddNativeMobileAdUnit

AddAppOpenMobileAdUnit

Name	Description
applicationId*	Type: number App ID
type*	Type: string Type of ad unit or unit action
caption	Type: string Description Min length: `1` Max length: `255`
strategy	Type: MaxRevenueStrategy or MinCpmVStrategy or MinECpmStrategy Ad traffic management strategy, CPM floors Default: `{ "type" : "MaxRevenueStrategy" }`

AddRewardedMobileAdUnit

Name	Description
applicationId*	Type: number App ID
currencyType*	Type: string In-app currency name Min length: `1` Max length: `64`
currencyValue*	Type: number Reward amount for viewing the ad in the in-app currency Min value: `0` Max value: `100000000`
type*	Type: string Type of ad unit or unit action
caption	Type: string Description Min length: `1` Max length: `255`
strategy	Type: MaxRevenueStrategy or MinCpmVStrategy or MinECpmStrategy Ad traffic management strategy, CPM floors Default: `{ "type" : "MaxRevenueStrategy" }`

AddInterstitialMobileAdUnit

Name	Description
applicationId*	Type: number App ID
type*	Type: string Type of ad unit or unit action
caption	Type: string Description Min length: `1` Max length: `255`
strategy	Type: MaxRevenueStrategy or MinCpmVStrategy or MinECpmStrategy Ad traffic management strategy, CPM floors Default: `{ "type" : "MaxRevenueStrategy" }`

AddBannerMobileAdUnit

Name	Description
applicationId*	Type: number App ID
type*	Type: string Type of ad unit or unit action
caption	Type: string Description Min length: `1` Max length: `255`
strategy	Type: MaxRevenueStrategy or MinCpmVStrategy or MinECpmStrategy Ad traffic management strategy, CPM floors Default: `{ "type" : "MaxRevenueStrategy" }`

AddNativeMobileAdUnit

Name	Description
applicationId*	Type: number App ID
type*	Type: string Type of ad unit or unit action
caption	Type: string Description Min length: `1` Max length: `255`
strategy	Type: MaxRevenueStrategy or MinCpmVStrategy or MinECpmStrategy Ad traffic management strategy, CPM floors Default: `{ "type" : "MaxRevenueStrategy" }`

MaxRevenueStrategy

Doesn't limit the impression cost

Name

Description

type*

Type: string

Strategy type

MinCpmVStrategy

The threshold (floor) sets the cost per one thousand viewable impressions

Name

Description

mincpm*

Type: number

Floor value

type*

Type: string

Strategy type

MinECpmStrategy

The threshold (floor) sets the cost per one thousand impressions

Name

Description

mincpm*

Type: number

Floor value

type*

Type: string

Strategy type

Strategy

Ad traffic management strategy

Name

Description

type*

Type: string

Strategy type

Responses

200 OK

Body

application/json

{
    "data": {
        "applicationId": 0,
        "caption": "string",
        "createDate": "2022-12-29T18:02:01Z",
        "editable": false,
        "id": "string",
        "status": "UNKNOWN",
        "strategy": {
            "type": "string"
        },
        "type": "string"
    },
    "warnings": [
        "string"
    ]
}

Name

Description

data

Type: AppOpenMobileAdUnit or RewardedMobileAdUnit or BannerMobileAdUnit or NativeMobileAdUnit or InterstitialMobileAdUnit

warnings

Type: string[]

List of warnings that occurred when performing an action

AppOpenMobileAdUnit

Name	Description
applicationId*	Type: number App ID
id*	Type: string Unit ID Min length: `7` Pattern: `R-M-\d{1,10}-\d{1,7}`
type*	Type: string Type of ad unit or unit action
caption	Type: string Description Min length: `1` Max length: `255`
createDate	Type: string<date-time> Unit creation date
editable	Type: boolean Editability
status	Type: AdUnitStatus Enum: `UNKNOWN`, `ENABLED`, `ARCHIVED`
strategy	Type: MaxRevenueStrategy or MinCpmVStrategy or MinECpmStrategy Ad traffic management strategy, CPM floors

RewardedMobileAdUnit

Name	Description
applicationId*	Type: number App ID
currencyType*	Type: string In-app currency name Min length: `1` Max length: `64`
currencyValue*	Type: number Reward amount for viewing the ad in the in-app currency Min value: `0` Max value: `100000000`
id*	Type: string Unit ID Min length: `7` Pattern: `R-M-\d{1,10}-\d{1,7}`
type*	Type: string Type of ad unit or unit action
caption	Type: string Description Min length: `1` Max length: `255`
createDate	Type: string<date-time> Unit creation date
editable	Type: boolean Editability
status	Type: AdUnitStatus Enum: `UNKNOWN`, `ENABLED`, `ARCHIVED`
strategy	Type: MaxRevenueStrategy or MinCpmVStrategy or MinECpmStrategy Ad traffic management strategy, CPM floors

BannerMobileAdUnit

Name	Description
applicationId*	Type: number App ID
id*	Type: string Unit ID Min length: `7` Pattern: `R-M-\d{1,10}-\d{1,7}`
type*	Type: string Type of ad unit or unit action
caption	Type: string Description Min length: `1` Max length: `255`
createDate	Type: string<date-time> Unit creation date
editable	Type: boolean Editability
status	Type: AdUnitStatus Enum: `UNKNOWN`, `ENABLED`, `ARCHIVED`
strategy	Type: MaxRevenueStrategy or MinCpmVStrategy or MinECpmStrategy Ad traffic management strategy, CPM floors

NativeMobileAdUnit

Name	Description
applicationId*	Type: number App ID
id*	Type: string Unit ID Min length: `7` Pattern: `R-M-\d{1,10}-\d{1,7}`
type*	Type: string Type of ad unit or unit action
caption	Type: string Description Min length: `1` Max length: `255`
createDate	Type: string<date-time> Unit creation date
editable	Type: boolean Editability
status	Type: AdUnitStatus Enum: `UNKNOWN`, `ENABLED`, `ARCHIVED`
strategy	Type: MaxRevenueStrategy or MinCpmVStrategy or MinECpmStrategy Ad traffic management strategy, CPM floors

InterstitialMobileAdUnit

Name	Description
applicationId*	Type: number App ID
id*	Type: string Unit ID Min length: `7` Pattern: `R-M-\d{1,10}-\d{1,7}`
type*	Type: string Type of ad unit or unit action
caption	Type: string Description Min length: `1` Max length: `255`
createDate	Type: string<date-time> Unit creation date
editable	Type: boolean Editability
status	Type: AdUnitStatus Enum: `UNKNOWN`, `ENABLED`, `ARCHIVED`
strategy	Type: MaxRevenueStrategy or MinCpmVStrategy or MinECpmStrategy Ad traffic management strategy, CPM floors

AdUnitStatus

Type	Description
AdUnitStatus	Enum: `UNKNOWN`, `ENABLED`, `ARCHIVED`

Was the article helpful?

Getting a list of mobile ad units

Getting a mobile ad unit by ID