Поделиться через

Ресурсы промоушенов

  • Статья

Применимо к:

  • Центр партнеров

Соответствующие роли

  • Агент по администрированию

Примечание.

Новые возможности коммерческой торговли для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщик облачных решений (ПОСТАВЩИКОВ УСЛУГ). Дополнительные сведения см . в обзоре новых коммерческих возможностей.

Описывает ресурсы для рекламных акций, применяемых к транзакциям для новых коммерческих подписок.

Стимулирование продаж

Скидка применяется при покупке номера SKU продукта, если соблюдены критерии соответствия.

Свойство Type Описание
id строка Идентификатор промоушена.
name строка Понятное имя промоушена.
описание строка Описание продвижения.
startDate строка Дата начала, когда применимо повышение.
endDate строка Дата окончания, в течение срока действия промоушенной акции.
requiredProducts список обязательных продуктов Сведения о продукте, номере SKU и политиках ценообразования, которые применяются для продвижения.
свойства список свойств Свойства для промоушении, включая возможность автоматического применения промоушений.

RequiredProducts

Сведения о продукте, номере SKU и политиках ценообразования, которые применяются для продвижения.

Свойство Type Описание
productId строка Идентификатор продукта, для который будет доступна акция.
skuId строка Идентификатор номера SKU, для который доступно повышение.
term Термин Срок, включая длительность срока и период выставления счетов повышение доступности.
pricingPolicies Список цен наPolicies Список политик, определяющих типы и значения скидок на повышение.

Термин

Представляет термин, для которого можно приобрести повышение.

Свойство Type Описание
duration строка Представление срока действия термина ISO 8601. Текущие поддерживаемые значения: P1M (один месяц), P1Y (один год) и P3Y (три года).
billingCycle строка Описывает, как часто повышение будет применяться к выставлению счетов. Значения могут включать ежемесячные, ежегодные, onetime или неизвестные.

ЦенообразованиеPolicies

Описать типы и значения скидок на повышение.

Свойство Type Описание
type строка Опишите, основана ли скидка на процентные или плоские скидки.
значение строка Определяет сумму примененной скидки.

Свойства

Свойства для продвижения.

Свойство Type Описание
isAutoApplicable bool Указывает, применяется ли продвижение автоматически или необходимо ли передать партнером.

ПродвижениеEligibilitiesRequestItem

Свойства, представляющие транзакцию и право на продвижение.

Свойство Type Описание
id INT Идентификатор элемента для повышения прав.
catalogItemId строка Идентификатор элемента каталога, к который будет применено повышение. Включает идентификатор продукта, идентификатор SKU и идентификатор доступности.
quantity INT Количество лицензий или экземпляров.
termDuration строка Представление срока действия термина ISO 8601. Текущие поддерживаемые значения: P1M (один месяц), P1Y (один год) и P3Y (три года).
billingCycle строка Описывает, как часто повышение будет применяться к выставлению счетов. Значения могут включать ежемесячные, ежегодные, onetime или неизвестные.
промоушен строка Идентификатор промоушена.

ПродвижениеEligibilities

Список продуктов, номеров SKU и их прав на продвижение.

Свойство Type Описание
id INT Идентификатор элемента для повышения прав.
catalogItemId строка Идентификатор элемента каталога, к который будет применено повышение. Включает идентификатор продукта, идентификатор SKU и идентификатор доступности.
quantity INT Количество лицензий или экземпляров.
termDuration строка Представление срока действия термина ISO 8601. Текущие поддерживаемые значения: P1M (один месяц), P1Y (один год) и P3Y (три года).
billingCycle строка Описывает, как часто повышение будет применяться к выставлению счетов. Значения могут включать ежемесячные, ежегодные, onetime или неизвестные.
права на доступ Список рекламных акцийEligibilities Представляет список результатов предоставления прав на повышение уровня.

Повышение уровня доступности

Список продуктов, номеров SKU и их прав на продвижение.

Свойство Type Описание
promotionId строка Идентификатор промоушена.
isEligible bool Описывает, имеет ли повышение право на получение указанного элемента запроса на получение прав.
ошибки Список промоушенийEligibilityErrors Ошибки, описывающие, почему элемент запроса на повышение прав на повышение прав не имеет права.

PromotionEligibilityError

Объясняет, почему элемент запроса на получение прав на повышение прав не имеет права.

Свойство Type Описание
type строка Типы ошибок, которые могут включать InvalidCatalogItemId, InvalidPromotion, PrerequisiteProductOwnership, RedemptionLimit, SeatCount, OfferPurchasedPreviously или Term.
описание строка Описывает, имеет ли повышение право на получение указанного элемента запроса на получение прав.

RedemptionLimitPromotionEligibilityError

Содержит сведения о том, почему превышен предел активации.

Свойство Type Описание
maxPromotionRedemptionCount INT Максимальное количество раз, когда можно получить повышение.
оставшаяся частьPromotionRedemptionCount INT Оставшееся количество раз, когда можно получить повышение.

SeatCountPromotionEligibilityError

Включает сведения о том, почему превышено ограничение количества мест. Все значения имеют значение NULL.

Свойство Type Описание
minimumRequiredSeats INT Минимальные лицензии, которые будут поддерживаться.
maximumRequiredSeats INT Максимальное количество лицензий, которые будут поддерживаться.
availableSeats INT Оставшееся количество лицензий, которые партнер может получить для данной акции.

TermPromotionEligibilityError

Содержит сведения о том, почему срок продвижения не был принят.

Свойство Type Описание
доступныеterms Промоутерм Подходящие условия, которые будут поддерживаться.

Промоутерм

Включает сведения о том, почему превышено ограничение количества мест.

Свойство Type Описание
billingCycle строка Описывает, как часто повышение будет применяться к выставлению счетов. Значения могут включать ежемесячные, ежегодные, onetime или неизвестные.
duration строка Длительность приобретаемого срока.