--- metadata: - name: generator content: Diplodoc Platform v5.66.1 alternate: - https://yandex.com/support/market-distr/ru/api/reference/post-creatives.md - href: https://yandex.com/support/market-distr/ru/api/reference/post-creatives.md type: text/markdown title: Markdown version - href: https://yandex.com/support/market-distr/ru/llms.txt?revision=r22075821 rel: describedby keywords: POST /marking --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/market-distr/ru/llms.txt?revision=r22075821 # Создание и редактирование креативов ## Описание {#description} ```no-highlight POST /marking ``` Создаёт новый или редактирует существующий креатив. URL ресурса: ```no-highlight https://api.content.market.yandex.ru/v3/affiliate/marking/ ``` * Не передавайте параметры **is_social** и **is_native** * Используйте параметры со значениями: * **service** — market; * **type** — cpa; * **urls** — список всех ссылок, которые вы используете в креативе; * **okveds** — 62.01. Общая структура ответа приведена ниже. Порядок следования элементов не гарантируется. В структуре могут присутствовать служебные параметры, которые не описаны в таблице. ## Входные данные {#input} #| || **Параметр** | **Тип** | **Значение** || || **Обязательные** | > | > || || `clid` | Int64 | CLID, для которого будет зарегистрирован креатив. || || `form` | String | Форма распространения рекламы. Допустимые значения: - `banner` — баннер; - `text-block` — текстовый блок; - `text-graphic-block` — текстово-графический блок; - `video` — видеоролик; - `audio-rec` — аудиозапись; - `live-video` — видеотрансляция в прямом эфире; - `live-audio` — аудиотрансляция в прямом эфире. || || `text_data` | String | Текст креатива. || || `media_data` | Array | Список медиа в рекламном блоке. Из `text_data` и `media_data` достаточно заполнить только одно из полей, если формат креатива не подразумевает наличие обоих. || || `media_url` | String | Ссылка на медиа. || || `media_url_file_type` | String | Тип медиа. Возможные значения: - `image` — изображение; - `video` — видео. || || `description` | String | Описание креатива. || || **Необязательные** | > | > || || `service` | String | Сервис, для которого регистрируется креатив. Используется только если не удалось определить креатив из CLID. Например, для Яндекс Маркета должно быть значение `market`. || || `type` | String | Тип рекламной кампании: `cpa`, `cpc`, `cpm`, `other`. || || `token` | String | Токен креатива. Передайте параметр, чтобы изменить креатив. || || `urls` | Array | Список целевых ссылок. || || `okveds` | Array | Список кодов ОКВЭД для объекта рекламирования. || || `fias_region_list` | Array | Уникальные идентификаторы ФИАС регионов показа. Если массив пустой, то регионом показа считается вся Россия. || || `is_social` | Boolean | Признак социальной рекламы. || || `is_native` | Boolean | Признак нативной рекламы. || |# ## Выходные данные {#output} ```json { "data": { "clid": {integer}, "service": {string}, "type": {string}, "token": {string}, "form": {string}, "urls": [ {string} ], "okveds": [ {string} ], "text_data": [ {string} ], "media_data": [ { "media_url": {string}, "description": {string} } ], "description": {string}, "is_social": {boolean}, "is_native": {boolean} }, "result": {string} } ``` Описание параметров: #| || **Параметр** | **Тип** | **Значение** || || `clid` | Int64 | CLID, для которого будет зарегистрирован креатив. || || `service` | String | Сервис, для которого регистрируется креатив. Используется только если не удалось определить креатив из CLID. Например, для Яндекс Маркета должно быть значение `market`. || || `type` | String | Тип рекламной кампании: `cpa`, `cpc`, `cpm`, `other`. || || `urls` | Array | Список целевых ссылок. || || `okveds` | Array | Список кодов ОКВЭД для объекта рекламирования. || || `fias_region_list` | Array | Уникальные идентификаторы ФИАС регионов показа. Если массив пустой, то регионом показа считается вся Россия. || || `is_social` | Boolean | Признак социальной рекламы. || || `is_native` | Boolean | Признак нативной рекламы. || |# ## Примеры {#examples} Запрос: ```bash { "clid": 123456, "form": "banner", "text_data": [ "Test content" ], "media_data": [ { "media_url": "https://ya.cc/123123", "description": "Test media data" } ], "description": "Test description" } ``` Ответ: ```json { "data": { "clid": 123456, "service": "market", "type": "other", "token": "4CQwVszL78Gt5cHA6pP", "form": "banner", "urls": [ "https://market.yandex.ru/" ], "okveds": [ "62.01" ], "text_data": [ "Test content" ], "media_data": [ { "media_url": "https://ya.cc/123123", "description": "Test media data" } ], "description": "Test description", "is_social": false, "is_native": false }, "result": "ok" } ``` [*status]: Статус заказа: - `NEW` — в обработке: покупатель оформил заказ, но пока не получил его. - `ON_HOLD` — ждет подтверждения: покупатель получил заказ, но со дня получения не прошло 14 дней. - `APPROVED` — подтвержден: прошло две недели со дня получения заказа. - `CANCELLED` — вознаграждение за заказ не выплачивается. Информация о причинах отмены указана в параметре `additionalInfo`. [*enum]: Код причины, по которой вознаграждение за заказ не выплачивается: - `ABUSE` — нарушение связано с поведением покупателя: - Превысил количество покупок конкретного товара или группы товаров из одной категории в 2,5 раза. Рассчитывается относительно средних показателей сервиса за день, неделю или месяц. - Использовал купоны, которые принадлежат одному покупателю, с разных аккаунтов. - Оформил заказ с шести и более разных аккаунтов, которые принадлежат одному покупателю. - `ALL_ITEMS_RETURNED` — покупатель создал заявку на возврат в течение 14 дней после получения заказа, даже если потом не вернул по ней товары. Если он возвращает только часть товаров из заказа, за остальные вознаграждение будет начислено. - `BANNED_REGIONS` — покупатель оформил заказ на Маркете с доставкой в регион, которого нет в списке. {% cut "Список регионов" %} - Москва и Московская область - Санкт-Петербург и Ленинградская область - Воронежская область - Краснодарский край - Красноярский край - Нижегородская область - Новосибирская область - Пермский край - Республика Башкортостан - Республика Татарстан - Ростовская область - Самарская область - Свердловская область - Челябинская область {% endcut %} - `BANNED_SOURCE` — покупатель перешел с [запрещенного источника трафика](https://yandex.ru/support/market-distr/ru/rules#not-paid) и оформил заказ на Маркете. - `BUYER_CANCEL` — покупатель отменил заказ. - `FULL_CART_COUPON` — покупатель сначала добавил товары в корзину на Маркете и затем перешел на агрегатор купонов или промокодов, чтобы получить скидку на свой заказ. - `MARKET_CANCEL` — Маркет отменил заказ из-за технической ошибки. - `ORDER_CREATION_EXPIRED` — покупатель не оплатил заказ. - `ORDER_NOT_REPURCHASED` — покупатель не забрал заказ. - `PARTNER_PROMO_CODE` — покупатель применил промокод другого партнера. - `REFERRAL_PROMOCODE` — покупатель применил реферальный промокод. - `SELLER_CANCEL` — магазин отменил заказ. - `VIOLATION_TERMS_OF_USE` — покупатель нарушил [правила использования сервиса](https://yandex.ru/legal/market_termsofuse/). Подробнее см. в разделе [Вознаграждение за заказы на Маркете](https://yandex.ru/support/market-distr/ru/terms) Справки реферальной программы. Возвращается, только если параметр `status` имеет значение `CANCELLED`. Параметр возвращается только для формата XML. Для формата JSON возвращается код в виде строки. [*cart]: Общая стоимость всех единиц товара в заказе. Возвращается, только если входной параметр `total` не указан или в нем указано значение `false`. [*cart-orders]: Сумма заказа в рублях. [*result]: Ответ. Параметр возвращается только для формата XML. [*orders]: Список заказов. [*order]: Информация о заказе. Параметр возвращается только для формата XML. [*clid]: Ваш идентификатор в реферальной программе. [*vid]: Дополнительный идентификатор инструмента монетизации, с которым покупатель взаимодействовал перед оформлением заказа на Маркете. [*order-id]: Номер заказа. [*date-created]: Дата и время создания заказа. Формат даты и времени: [ISO 8601](https://ru.wikipedia.org/wiki/ISO_8601). Например, `2017-11-21T00:00:00`. Часовой пояс — UTC+03:00 (Москва). [*date-updated]: Дата и время последнего изменения статуса заказа. Формат даты и времени: [ISO 8601](https://ru.wikipedia.org/wiki/ISO_8601). Например, `2017-11-21T00:00:00`. Часовой пояс — UTC+03:00 (Москва). [*additional-info]: Список причин, по которым вознаграждение за заказ не выплачивается. Возвращается, только если параметр `status` имеет значение `CANCELLED`. [*payment]: Сумма вознаграждения за заказ в рублях. [*payment-orders]: Общее вознаграждение за все единицы товара в заказе. Возвращается, только если входной параметр `total` не указан или в нем указано значение `false`. [*tariff]: Поле больше не поддерживается. [*items-orders]: Список товаров в заказе. Возвращается, только если входной параметр `total` не указан или в нем указано значение `false`. [*item-orders]: Информация о товаре. Возвращается, только если входной параметр `total` не указан или в нем указано значение `false`. Параметр возвращается только для формата XML. [*item-id-orders]: Номер товара в заказе. Нумерация начинается с `0`. Возвращается, только если входной параметр `total` не указан или в нем указано значение `false`. [*item-count-orders]: Количество единиц товара в заказе, за которые должно быть выплачено вознаграждение. За товары, которые покупатель начал возвращать в течение двух недель со дня получения, вознаграждение не выплачивается. Возвращается, только если входной параметр `total` не указан или в нем указано значение `false`. [*tariff-name]: Поле больше не поддерживается. [*tariff-rate]: Доля от общей стоимости всех единиц товара в заказе, выплачиваемая как вознаграждение. Возвращается, только если входной параметр `total` не указан или в нем указано значение `false`. [*promo-order]: Реферальный промокод, который покупатель указал в заказе.