Ресурсы промоакций
Применимо к
- Центр партнеров
Соответствующие роли
- Агент по администрированию
Примечание.
Новый опыт взаимодействия с коммерческими услугами для лицензируемых служб включает множество новых функций и доступен для всех поставщиков облачных решений. Для получения дополнительной информации смотрите обзор новых коммерческих возможностей.
Описывает ресурсы для рекламных акций, применяемых к транзакциям для новых коммерческих подписок.
Продвижение
Скидка применяется при покупке номера SKU продукта, если соблюдены критерии соответствия.
| Свойство | Тип | Описание |
|---|---|---|
| id | строка | Идентификатор акции. |
| имя | строка | Дружественное имя акции. |
| описание | строка | Описание акции. |
| дата начала | строка | Дата начала, когда применимо повышение. |
| Дата окончания | строка | Дата окончания, до которой действует промоакция. |
| требуемыеПродукты | список обязательных продуктов | Сведения о продукте, номере SKU и политиках ценообразования, которые применяются для продвижения. |
| свойства | список свойств | Свойства для акций, включая то, является ли акция автоматически применяемой. |
НеобходимыеПродукты
Сведения о продукте, номере SKU и политиках ценообразования, которые применяются для продвижения.
| Свойство | Тип | Описание |
|---|---|---|
| productId | строка | Идентификатор продукта, для который будет доступна акция. |
| skuId | строка | Идентификатор SKU, для которого доступна акция. |
| термин | Термин | Срок, в который входит длительность и период выставления счетов, на который доступна акция. |
| ценовая политика | Список ценовых политик | Список политик, определяющих типы и значения скидок на акции. |
Термин
Представляет условие, для которого можно приобрести промоакцию.
| Свойство | Тип | Описание |
|---|---|---|
| продолжительность | строка | Представление продолжительности термина в формате ISO 8601. Текущие поддерживаемые значения: P1M (один месяц), P1Y (один год) и P3Y (три года). |
| billingCycle | строка | Содержит информацию о том, как часто акция будет применяться к выставлению счетов. Значения могут включать Ежемесячные, Ежегодные, Однократные или Неизвестные. |
Политики ценообразования
Опишите виды и значения скидок в рамках акций.
| Имущество | тип | Описание |
|---|---|---|
| тип | строка | Опишите, основана ли скидка на процентные или фиксированные скидки. |
| значение | строка | Определяет сумму примененной скидки. |
Свойства
Свойства для продвижения.
| Свойство | Тип | Описание |
|---|---|---|
| isAutoApplicable | bool | Указывает, применяется ли акция автоматически или её должен применить партнёр. |
Элементы запроса на право продвижения
Свойства, представляющие транзакцию и соответствие требованиям для продвижения.
| Свойство | Тип | Описание |
|---|---|---|
| id | INT | Идентификатор элемента, связанного с правом на акции. |
| идентификаторЭлементаКаталога | строка | Идентификатор элемента каталога, к которому будет применена акция. Включает идентификатор продукта, идентификатор SKU и идентификатор доступности. |
| количество | INT | Количество лицензий или экземпляров. |
| длительность срока | строка | Представление продолжительности термина в формате ISO 8601. Текущие поддерживаемые значения: P1M (один месяц), P1Y (один год) и P3Y (три года). |
| billingCycle | строка | Описывает, как часто акция будет применяться к выставлению счетов. Значения могут включать Ежемесячные, Ежегодные, Единовременные или Неизвестные. |
| код продвижения | строка | Идентификатор акции. |
Право на повышение
Список продуктов, номеров SKU и их прав на продвижение.
| Свойство / Недвижимость / Имущество | Тип | Описание |
|---|---|---|
| id | INT | Идентификатор элемента для повышения прав. |
| идентификатор элемента каталога | строка | Идентификатор элемента каталога, к которому будет применено повышение. Включает идентификатор продукта, идентификатор SKU и идентификатор доступности. |
| количество | INT | Количество лицензий или экземпляров. |
| срок действия | строка | Представление продолжительности срока термина в формате ISO 8601. Текущие поддерживаемые значения: P1M (один месяц), P1Y (один год) и P3Y (три года). |
| billingCycle | строка | Описывает, как часто акция будет применяться к выставлению счетов. Значения могут включать ежемесячные, ежегодные, одноразовые или Неизвестные. |
| права на доступ | Список критериев участия в акциях | Представляет список результатов предоставления прав на повышение уровня. |
Право на повышение
Список продуктов, номеров SKU и их прав на продвижение.
| Свойство | Тип | Описание |
|---|---|---|
| promotionId | строка | Идентификатор акции. |
| является подходящим | bool | Описывает, соответствует ли акция требованиям указанного пункта запроса на соответствие. |
| ошибки | Список ошибок соответствия для акций | Ошибки, описывающие, почему элемент запроса на соответствие условиям повышения не был признан соответствующим. |
ОшибкаДопустимостиКПродвижению
Объясняет, почему элемент запроса на право на продвижение оказался неподходящем для продвижения.
| Свойство | Тип | Описание |
|---|---|---|
| тип | строка | Типы ошибок, которые могут включать InvalidCatalogItemId, InvalidPromotion, PrerequisiteProductOwnership, RedemptionLimit, SeatCount, OfferPurchasedPreviously или Term. |
| описание | строка | Описывает, соответствует ли акция требованиям для указанного элемента запроса на право участия. |
Ошибка правомочности на участие в акции по ограничению выкупа
Содержит сведения о том, почему превышен предел активации.
| Свойство | Тип | Описание |
|---|---|---|
| максимальноеКоличествоИспользованийАкции | инт | Максимальное количество раз, когда можно получить повышение. |
| оставшееся количество активированных акций | INT | Оставшееся количество раз, когда можно получить повышение. |
Ошибка права на участие в акции по количеству мест
Включает сведения о том, почему превышено ограничение количества мест. Все значения имеют значение NULL.
| Свойство | Тип | Описание |
|---|---|---|
| минимальноТребуемыеМеста | INT | Минимальное количество лицензий, которые промоция будет поддерживать. |
| максимально требуемые места | INT | Максимальное количество лицензий, которые поддерживает акция. |
| Доступные места | INT | Оставшееся количество лицензий, которые партнер может получить для данной акции. |
ОшибкаПравопригодностиУсловияАкции
Содержит сведения о том, почему срок продвижения не был принят.
| Свойство | Тип | Описание |
|---|---|---|
| подходящие условия | Условия акции | Подходящие термины, которые поддерживает акция. |
Условия акции
Включает сведения о том, почему превышено ограничение количества мест.
| Свойство | Тип | Описание |
|---|---|---|
| billingCycle | строка | Описывает, как часто акция будет применяться к выставлению счетов. Значения могут включать ежемесячные, ежегодные, однократные или неизвестные. |
| продолжительность | строка | Длительность приобретаемого срока. |