Loading
Сведения об управлении предложениями в реальном времени
API подходящих рекламных акций

Вы находитесь здесь:

  1. Справка Salesforce
  2. Документы
  3. Управление предложениями в реальном времени

API подходящих рекламных акций

Используйте API подходящих рекламных акций для предоставления клиентам списка рекламных акций, подходящих для корзин клиентов. API может получить список подходящих рекламных акций для контактов, организаций и участников программы лояльности.

Требуемые версии

Доступно в версиях: Lightning Experience
Доступно в версиях: Версии Enterprise Edition, Unlimited Edition и Developer Edition с управлением предложениями в реальном времени

Предоставьте клиентам список рекламных акций, соответствующих их корзине. API берет сведения о корзине клиента в качестве запроса и предоставляет сведения о соответствующих активных рекламных акциях для корзины в качестве ответа. При поиске подходящих рекламных акций для элемента API сканирует 5 уровней иерархии категорий продукта.

Если корзина содержит продукт, не существующий в каталоге Salesforce, API игнорирует несинхронизированные продукты во время оценки рекламных акций на уровне строки и межстрочных рекламных акций и отображает соответствующие рекламные акции для корзины.

Если в организации есть несколько библиотек правил типа «Глобальное управление рекламной акцией», системные интеграторы должны указать, какую библиотеку правил выполняет API. Они также должны подтвердить, что запрос API содержит значения, необходимые контексту библиотеки правил для оценки корзин.

Важно!
Важно! Если API не находит значение для настраиваемого атрибута или атрибута продукта в запросе, значение считается отсутствующим в корзине.

Ответ API предоставляет следующие сведения о рекламной акции.

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

Чтобы предоставить клиентам соответствующие рекламные акции в режиме реального времени, интегрируйте API подходящих рекламных акций с внешними системами, управляющими корзинами клиентов. См. раздел Допустимые рекламные акции.

Совет
Совет Интегрируя API с внешними системами, например, торговыми сайтами, системами точек продаж (POS-системы) и глобальными системами распространения (GDS), вы используете код записи или имена для определения ключевых атрибутов корзины. Например, чтобы определить клиента, которому принадлежит корзина, укажите код записи контакта клиента или фамилию и электронную почту контакта. Чтобы определить участников программы лояльности, которым принадлежит корзина, укажите код записи участника программы лояльности или номер его участия. Чтобы определить продукты или категории, из которых продукты добавляются в корзину клиента, укажите код продукта или имя продукта, либо код или имя категории.

Если использование рекламной акции соответствует ограничению рекламной акции для отдельной корзины, API подходящих рекламных акций не предоставляет награду в выводе API для любого клиента. После того как использование клиентом награды соответствует ограничению уровня клиента рекламной акции, API подходящих рекламных акций больше не предлагает награду клиенту.

Пример
Пример Администратор и менеджер по маркетингу в Cloud Kicks совместно создали настраиваемое определение контекста для рекламной акции, ориентированной на сегмент Sneakerheads, которые приобретают премиальные щиты кроссовок со стоимостью корзины 75 долларов США.

Вот как выглядит запрос API соответствующей рекламной акции при выполнении API из сайта онлайн-покупок Cloud Kicks.

{
   "cart":{
      "Accessory":[
         {
            "activityStartDate":"2023-06-14T12:45:19Z",
            "contactId":"003xx000004WjzAAAS",
            "transactionAmount":85,
            "currencyISOCode":"INR",
            "cartLineDetails":[
               {
                  "CartLineProductCategory":"Sneaker Shields",
                  "cartLineProductCatalogId:"0ZSSB0000002d8X4AQ"",
                  "AttributeKey:"Premium"
               }
            ]
         }
      ]
   }
}

API подходящих рекламных акций для рекламных акций с купонами

Когда купоны добавляются в рекламную акцию, API подходящих рекламных акций берет сведения о корзине клиента в качестве запроса и отвечает сведениями об активных купонах для рекламных акций, подходящих в корзину клиента. Клиент может использовать купон рекламной акции, который он хочет применить к своей корзине.

Для соответствующих рекламных акций, содержащих купон, ответ API содержит данные сведения о купоне.

  • Код купона
  • Даты начала и окончания
  • Статус

API возвращает только рекламные акции, содержащие как минимум один активный и действительный купон на дату действия клиента. Хотя рекламная акция может состоять из нескольких купонов, API не отображает код купона в этих сценариях.

  • При наличии нескольких активных купонов, соответствующих дате действия
  • Если купон не активен на дату действия
  • Если соответствующий активный купон достиг ограничения по использованию
 
Загрузка
Salesforce Help | Article