События (ивенты) нужны для отслеживания важных пользовательских действий, таких как добавление товара в корзину, добавление в список желаемого, аутентификации в личном кабинете и многие другие. Отслеживание таких событий необходимо для понимания поведения пользователя и таргетинга на его основе, а также корректной работы рекомендательных стратегий. Для отправки данных в SL необходимо внедрить небольшой кусочек кода для каждого необходимого события. В событии вы можете передавать тот набор параметров, которые в дальнейшем планируете использовать для работы. Ряд событий, таких как покупка или вход в личный кабинет требуют внедрения по определенной схеме, вместе с тем, для других целевых действий вы можете создавать и собственные события. Важно: при e-commerce внедрении события Purchase и Add to Cart являются обязательными, но мы также рекомендуем внедрить максимальное количество событий из списка преднастроенных, которые релевантны для вашего сайта. Это поможет реализовать больше use-кейсов и расширить профиль пользователя. Окончательный список требуемых событий согласовывается с вашим менеджером по персонализации в зависимости от планируемых use-кейсов.

Преднастроенные события

Добавление в корзину (обязательно для e-commerce)

Параметры:

1. name: человеко-читаемое название события, не используемое в качестве идентификатора типа события
2. properties: контейнер, содержащий свойства события по спецификации, указанной ниже

Пример JavaScript

SL.API("event", {
  name: "Add to Cart",
  properties: {
    eventType: "add-to-cart-v1",
    value: 118.26,
    currency: "any supported currency code",
    productId: "item-34454",
    quantity: 2,
    size: "XL",
    cart: [{
        productId: "sku-4324-bg",
        quantity: 2,
        itemPrice: 12.34
      },
      {
        productId: "item-34454",
        quantity: 2,
        itemPrice: 59.13
      }
    ]
  }
});

<aside> 📌 Частые ошибки:

1. В событии Add to cart часто некорректно передается параметр quantity . Данный параметр должен отражать фактически добавленное число единиц товара, а не сумму всех единиц после действия. Пример: в корзине было 2 единицы товара и мы добавили еще 1. В событии мы ожидаем увидеть quantity=1, а видим quantity=3 — это неправильно.

</aside>

Покупка (обязательно для e-commerce)

Параметры:

1. name: человеко-читаемое название события, не используемое в качестве идентификатора типа события
2. properties: контейнер, содержащий свойства события по спецификации, указанной ниже

Пример JavaScript

SL.API("event", {
  name: "Purchase",
  properties: {
    uniqueTransactionId: "123456",
    eventType: "purchase-v1",
    value: 90.55,
    currency: "any supported currency code",
    cart: [
      {
        productId: "item-34454",
        quantity: 1,
        itemPrice: 65.87,
        size: "XL"
      }, {
        productId: "sku-4324-bg",
        quantity: 2,
        itemPrice: 12.34,
        size: "M"
      }
    ]
  }
});

Удаление товара из корзины

Параметры: