Перейти к основному содержимому

Атрибуты покупок и атрибуты позиций

В некоторых случаях (чаще всего — для аналитики) требуется сохранять для покупок дополнительную информацию, например:

  • менеджер / кассир, совершивший продажу;
  • рекламный источник (флаер, листовка и т. п.);
  • тип магазина;
  • любые другие бизнес-характеристики.

Для передачи такой информации в Sailplay используются атрибуты покупок и атрибуты позиций, которые можно передавать:

  • при создании покупки;
  • при расчёте акций.

Основные сценарии использования​

Аналитика​

Атрибуты покупок и товаров поддерживаются в аналитических фильтрах платформы.
Это позволяет строить отчёты и сегменты по дополнительным характеристикам заказов и позиций.

Использование в акциях​

В условиях акций типа «Совершить покупку» можно:

  • включить флаг «Указать характеристики»;
  • выбрать атрибуты покупок и их значения, которые будут учитываться при проверке выполнения условия.

По аналогичному принципу атрибуты можно использовать:

  • в условиях, связанных с товарами;
  • в вознаграждениях (например, «Скидка на товар»).

Примеры атрибутов акции:

  • тип оплаты (например, атрибут payment_type со значениями card или cash)
  • тип получения заказа (например, delivery_type со значениями "Самовывоз" или "Доставка")
  • источник заказа (например, source со значениями: "МП", "сайт", "Агрегатор" и т.д.)

Поддерживаемые типы данных​

Для атрибутов покупок и позиций поддерживаются следующие типы значений:

  • числом (decimal)
  • строкой (string)
  • датой (date)
  • текстом (text)

Атрибуты покупок​

Создание атрибута покупки​

При создании атрибута покупки необходимо передать его техническое наименование и тип данных.
В ответе возвращаются:

  • id — уникальный идентификатор атрибута;
  • alias — техническое имя атрибута.

Получение списка атрибутов покупок​

Для получения списка всех созданных атрибутов покупок используется отдельный метод API.

Работа со значениями атрибутов покупок​

Для добавления, удаления и получения значений атрибутов необходимо указывать id или alias целевого атрибута.

Добавление и удаление атрибутов у существующих покупок​

Sailplay API позволяет добавлять и удалять атрибуты и их значения у покупок, которые были загружены ранее.

Это особенно полезно для аналитики и ретроспективного обогащения данных.

Атрибуты позиций​

Атрибуты позиций передаются непосредственно внутри каждой позиции корзины и на них можно настраивать акционные механики (тип условия Купить товар или вознаграждение Скидка на товар и опция "Товар с определенным значением атрибута по диапазону", условия выбора которой зависят от типа атрибута позиции)

Атрибуты позиций могут быть:

  • числом (decimal)
  • строкой (string)
  • датой (date)
  • текстом (text)

Пример структуры корзины с атрибутом позиции:

cart={
  "1":{
    "sku":"0000",
    "price":100,
    "quantity":1,
    "position_attribute":"value"
  }
}

Атрибуты позиций могут использоваться в аналитике и в условиях акций, связанных с товарами.

Примеры использования атрибутов позиций:

  • тип товара

Допустим, вы продаете билеты, который имеют две характеристики: детский и взрослый. Т.к. в контексте sku это один и тот же товар, то признак, который является динамическим и зависит от определенных условий, передается как атрибут позиции, например "ticket_type":"Взрослый" или "ticket_type":"Детский"

  • динамическая характеристика

Допустим, у вас есть акция, дающая скидка на последний размер на складе. С точки зрения товарооборота первая или последняя пара определенного размера это один и тот же sku, но если на кассе, например, пробивается последняя пара, то можно передавать динамический параметр, атрибут позиции, "last_size":"true", на который можно настроить акцию