Изменить размещение

Изменяет указанное размещение.

Request

PUT

https://api.media.metrika.yandex.net/v1/management/advertiser/{advertiserId}/campaign/{campaignId}/placement/{placementId}

Path parameters

Name	Description
advertiserId*	Type: integer<int32> Идентификатор рекламодателя.
campaignId*	Type: integer<int32> Идентификатор кампании.
placementId*	Type: integer<int32> Идентификатор размещения.

Query parameters

Name

Description

override

Type: boolean

Переопределить значения, заданные ранее.

Default: false

Body

application/json

{
    "placement": {
        "name": "string",
        "placement_type": "banner",
        "pricing_model": "cpm",
        "volume": 0,
        "cost": 0,
        "creatives": [
            {
                "creative_id": 0,
                "comment": "string"
            }
        ],
        "site_id": 0,
        "landing_id": 0
    }
}

Name

Description

placement

Type: PlacementIn

Информация о размещениях.

PlacementIn

Информация о размещениях.

Name	Description
landing_id*	Type: integer<int32> Идентификатор посадочной страницы.
site_id*	Type: integer<int32> Идентификатор места размещения.
cost	Type: number<double> Стоимость за единицу, ₽.
creatives	Type: Creative[] Креативы.
name	Type: string Название размещения. Min length: `1` Max length: `256`
placement_type	Type: string Тип размещения. Enum: `banner`, `video`, `search`
pricing_model	Type: string Модель закупки. Enum: `cpm`, `cpc`, `days`
volume	Type: integer<int32> Объем закупки, тыс. ед.. Max value: `1000000000`

Creative

Креативы.

Name

Description

comment*

Type: string

Название креатива.

creative_id

Type: integer<int32>

Идентификатор креатива.

Responses

200 OK

Body

application/json

{
    "placement": {
        "name": "string",
        "placement_type": "banner",
        "pricing_model": "cpm",
        "volume": 0,
        "cost": 0,
        "creatives": [
            {
                "creative_id": 0,
                "comment": "string"
            }
        ],
        "placement_id": 0,
        "site": {
            "site_id": 0,
            "name": "string",
            "url": "string",
            "site_type": "adv_network"
        },
        "landing": {
            "landing_id": 0,
            "name": "string",
            "url": "string"
        }
    }
}

Name

Description

placement

Type: PlacementOut

Размещения.

PlacementOut

Размещения.

Name	Description
cost	Type: number<double> Стоимость за единицу, ₽.
creatives	Type: Creative[] Креативы.
landing	Type: Landing Информация о посадочной странице.
name	Type: string Название размещения. Min length: `1` Max length: `256`
placement_id	Type: integer<int32> Идентификатор размещения.
placement_type	Type: string Тип размещения. Enum: `banner`, `video`, `search`
pricing_model	Type: string Модель закупки. Enum: `cpm`, `cpc`, `days`
site	Type: Site Место размещения.
volume	Type: integer<int32> Объем закупки, тыс. ед.. Max value: `1000000000`

Landing

Информация о посадочной странице.

Name	Description
landing_id	Type: integer<int32> Идентификатор посадочной страницы.
name	Type: string Название посадочной страницы. Min length: `1` Max length: `256`
url	Type: string URL посадочной страницы. Min length: `1` Max length: `1024`

Site

Место размещения.

Name	Description
name	Type: string Название места размещения. Min length: `1` Max length: `300`
site_id	Type: integer<int32> Идентификатор места размещения. Список доступных мест размещений см. в ручке `GET /v1/management/sites`
site_type	Type: string Тип места размещения: `adv_network` — в рекламных системах Яндекса `site` — другое место размещения Enum: `adv_network`, `site`
url	Type: string URL места размещения. Min length: `1` Max length: `300`

Была ли статья полезна?

Получить информацию о размещении

Удалить размещение