Обновлено:

1 октября 2025

Инструкция для разработчиков: как настроить передачу данных с сайта

Модуль Продажи предназначен для отправки коммуникаций (email, пуши, смс и т.д.), сопровождающих процессы выбора и покупки товаров и услуг — например, в интернет-магазинах, но не ограничиваясь ими.

В качестве исходных данных для настройки сценариев коммуникаций используется информация о параметрах продаваемых товаров и услуг и данные о действиях покупателя на сайте клиента (события).

Модуль работает на основе поступающих в Sendsay событий о действиях пользователя и генерации собственных событий на базе полученных данных.

Отправка событий на базе еcоmmеrсe-событий Google Analytics и Яндекс Метрики

Настройка модуля

Список клиентских ssec-событий

ID	Константа события	Событие	Область в stat.uni
0	VIEW_PRODUCT	Просмотр карточки товара	ssec_product_view
1	ORDER	Заказ	ssec_order
2	VIEW_CATEGORY	Просмотр категории товара	ssec_category_view
3	BASKET_ADD	Добавление товаров в корзину	ssec_basket
4	BASKET_CLEAR	Очистка корзины	ssec_basket_clear
5	SEARCH_PRODUCT	Поиск товара	ssec_product_search
6	SUBSCRIBE_PRODUCT_PRICE	Подписка на изменение стоимости товара	ssec_subscribe_product_price
7	SUBSCRIBE_PRODUCT_ISA	Подписка на пинг о появлении товара в продаже	ssec_subscribe_product_isa
8	FAVORITE	Добавление товара в избранное	ssec_product_favorite
12	PREORDER	Предварительный заказ	ssec_product_preorder
13	PRODUCT_ISA	Товар появился	ssec_product_isa
15	PRODUCT_PRICE_CHANGED	Стоимость товара изменилась	ssec_product_price_changed
28	REGISTRATION	Регистрация на сайте	ssec_registration
29	AUTHORIZATION	Авторизация на сайте	ssec_authorization

Набор доступных полей

Имя поля при внесении (JS & API)	Имя поля в stat.uni	Тип значения	Доступность	Комментарий
id	product.id	String	Товар
name	product.name	String	Товар
picture	product.picture	Array(String)	Товар	Массив, абсолютные ссылки
url	product.url	String	Товар	Абсолютная ссылка
available	product.available	UInt8	Товар
category_paths	product.category_paths	Array(String)	Товар
category_id	product.category_id	Int64	Товар
category	category	String	Товар
description	product.description	String	Товар
vendor	product.vendor	String	Товар
model	product.model	String	Товар
type	product.type	String	Товар
price	product.price	Decimal64(2)	Товар
old_price	product.old_price	Decimal64(2)	Товар
transaction_id	transaction.id	String	Заказ, корзина
transaction_dt	transaction.dt	DateTime	Заказ, корзина	Значение в формате YYYY-MM-DD hh:mm:ss
transaction_status	transaction.status	Int64 (1-12)	Заказ, корзина
transaction_discount	transaction.discount	Decimal64(2)	Заказ, корзина
transaction_sum	transaction.sum	Decimal64(2)	Заказ, корзина
delivery_dt	delivery.dt	DateTime	Заказ	Значение в формате YYYY-MM-DD hh:mm:ss
delivery_price	delivery.price	Decimal64(2)	Заказ
payment_dt	payment.dt	DateTime	Заказ	Значение в формате YYYY-MM-DD hh:mm:ss
cp1…cp12	cp1…cp12	String	Заказ, корзина, товар	Дополнительные параметры в формате «строка»
cd1…cd5	cd1…cd5	DateTime	Заказ, корзина, товар	Дополнительные параметры в формате «дата и время» (YYYY-MM-DD hh:mm:ss)
ci1…ci5	ci1…ci5	Int64	Заказ, корзина, товар	Дополнительные параметры в формате «число»

Статусы заказа

ID	Статус
1	Заказ Оформлен (создан,принят)
2	Заказ Оплачен
3	Заказ Принят в работу (сборка, комплектация)
4	Доставка
5	Доставка: присвоен трек-номер
6	Доставка: передан в доставку
7	Доставка: отправлен
8	Доставка: поступил в пункт-выдачи / передан курьеру
9	Доставка: получен
10	Заказ Отменен: отмена заказа
11	Заказ Отменен: возврат заказа
12	Заказ Изменен: обновление заказа

Структура ssec-события

Ssec-события всегда передаются в Sendsay как массив объектов. Если вам надо передать одно событие, то это будет массив с одним объектом.

[
  {
    "id": "product1",  //обязательно
    "description": "description",
    "available": 1 | 0,
    "model": "model",
    "name": "name",
    "old_price": 5.99,
    "picture": [""],
    "price":  7.88,
    "url": "url",
    "vendor": "vendor",
    "event_type": 1
    ...
  }
]

Так как в заказе или корзине может быть более одного товара, то структура передачи к нам таких событий отличается от стандартной. Это все так же массив объектов, но все сведения о товарах содержатся в массиве items:

[
  {
    "transaction_id": "x1", //обязательно
    "transaction_dt": "2022-07-25 23:25:13", //обязательно для заказа
    "transaction_sum": 100.9, //желательно
    "payment_dt": "2022-07-25 23:25:13", //необязательно
    "delivery_dt": "2022-07-25 23:25:13", //необязательно
    "update": 1 | 0, //необязательно
    "items": [  //обязательно при update != 1
      {
        "id": "product1", //обязательно
        "qnt": 2, //обязательно
        "price": 5.88 //обязательно
      }
    ]
  }
]

Персонализация первичного ключа товара для корзины и заказа

Если вам нужно передавать в корзину (заказ) разные товары с одним и тем же product.id (например, что-то с разным размером или объемом), то вам нужно передать дополнительный параметр для создания нового первичного ключа, отличного от product.id.

В принимаемых данных о товаре мы ожидаем поле uniq, в значении которого должно передаваться имя поля с дополнением для нового первичного ключа. Например, если у товара различается название, но id одинаковый, дополнительно можно передать "uniq": "name". Если у товара есть несколько размеров, но id одинаковый, то передавайте размер в дополнительном параметре cp1 и указывайте "uniq": "cp1".

Поле uniq- необязательно, при его отсутствии в качестве первичного ключа используется значение product.id.

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent(
    'BASKET_ADD',
    [
      {
        "transaction_sum": 100.9, //желательно
        "items": [ //обязательно
          {
            "id": "3457", //обязательно
            "qnt": 2, //обязательно
            "price": 5.88, //обязательно
            "name": "iPhone",
            "uniq": "name"
          },
           {
            "id": "3457", //обязательно
            "qnt": 2, //обязательно
            "price": 5.88, //обязательно
            "name": "Pixel",
            "uniq": "name"
          },
           {
            "id": "3456", //обязательно
            "qnt": 2, //обязательно
            "price": 5.88, //обязательно
            "name": "iPhone"
          }
        ]
      }
    ],
    { email: 'АДРЕС КЛИЕНТА' } //необязательно, при отсутствии email будет распознаваться нашим скриптом
  );
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Для для двух товаров с "id" == 3457 & "uniq" == "name" значение первичных ключей будет "3457/iPhone" & "3457/Pixel". Для товара с "id" == 3456 и без поля uniq значение певичного ключа будет "3456"

Добавление событий через JS-cкрипт

Все события могут быть переданы в Sendsay с вашего сайта через вызов соответствующей JS-функции.

Идентификатор пользователя, которому должно добавиться событие, вы можете передать самостоятельно в опциональном параметре, либо довериться нашему скрипту.

В случае если пользователя определяет наш скрипт, то вместе с идентификатором (email, web-push, umid) придет информация о выпуске, из которого пользователь перешел на сайт.

JavaScript-синтаксис

Размещение кода напрямую в HTML-странице:

<script type="text/javascript">
  (window["sndsyApiOnReady"] = window["sndsyApiOnReady"] || []).push(function() {
    sndsyApi.ssecEvent(<event_type>, <[ items_array ]>, { email: 'name@domain.ru' });
  });typeof sndsyApi != 'undefined' && sndsyApi.runQueue();
</script>

Также вы можете вызывать функцию sndsyApi.ssecEvent() в нужный вам момент из любого места вашего JS-кода.

Изменение анкетных данных контакта через JS-функции добавления событий

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

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent(
    'REGISTRATION',
    {
      email: 'АДРЕС КЛИЕНТА',
      extra: { // любые данные которые будут включены в корень запроса
        dk: [["base.name","set","Andrey"]] // анкетные данные
      }
    }
  );
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Формат параметра dk:

[
  [ "base.name", "set", "Vladimir"],
  [ "client_data.pets", "push", [{"pet_type":"dog","age":1}]],
  [ "client_data", "merge", {"type":"GOLD","orders_count":55,"prefered_item":"shopping bag"}]
]

Полное описание возможностей работы с данными и режимов можно найти в документации АПИ.

Добавление данных через Sendsay API

Все события можно добавлять, используя Sendsay API. Это будет полезно для добавления или обновления данных о совершенных заказах, а также при добавлении событий, которые не относятся к действиям ваших клиентов, например «появление товара в продаже» или «изменение стоимости товара».

Для отправки событий модуля "Продажи" используется отдельный эндпоинт:

https://ssec.sendsay.ru/general/ssec/v100/json/ACCOUNT_ID

ACCOUNT_ID надо заменить идентификатор (логин) вашего аккаунта Sendsay (не email).

Пример API-запроса для события изменения заказа:

curl --location --request POST 'https://ssec.sendsay.ru/general/ssec/v100/json/ACCOUNT_ID' \
--header 'Content-Type: application/json' \
--header 'Authorization: sendsay apikey=API_KEY' \
--data-raw '[
        {
          "email": "АДРЕС_ПОДПИСЧИКА",
          "addr_type": "email",
          "transaction_id": "x1", //обязательно, формат String
          "transaction_status": 1, //обязательно, формат UInt8
          "transaction_dt": "2022-07-25 23:25:13", //обязательно, формат даты YYYY-MM-DD hh:mm:ss
          "transaction_sum": 100.9, //обязательно, формат Decimal64(2)
          "payment_dt": "2022-07-25 23:25:13", //необязательно
          "delivery_dt": "2022-07-25 23:25:13", //необязательно
          "update": 1 | 0, //необязательно, формат UInt8
          "items": [
            {
              "id": "product1", //обязательно, формат String
              "name": "name", //рекомендуется, формат String
              "price": 7.88, //рекомендуется, формат Decimal64(2)
              "qnt": 2, //формат UInt8
              "model": "model", //формат String
              "vendor": "vendor", //формат String
              "category_id": 777, //рекомендуется для товарных подборок и сегментации, формат Int64
              "category": "category name" //рекомендуется для сегментации, формат String
            },
            {
              "id": "product2", //обязательно, формат String
              "name": "name", //рекомендуется, формат String
              "price": 7.88, //рекомендуется, формат Decimal64(2)
              "qnt": 1, //формат UInt8
              "model": "model", //формат String
              "vendor": "vendor", //формат String
              "category_id": 777, //рекомендуется для товарных подборок и сегментации, формат Int64
              "category": "category name" //рекомендуется для сегментации, формат String
            }
          ],
          "event_type": 1,
          "update": 1
        }
      ]'

Добавление обезличенных событий

ID	Константа события	Событие
13	PRODUCT_ISA	Товар появился
15	PRODUCT_PRICE_CHANGED	Стоимость товара изменилась

При отправке обезличенных данных не нужно указывать email & addr_type

Пример API-запроса:

curl --location --request GET 'https://ssec.sendsay.ru/general/ssec/v100/json/ACCOUNT_ID' \
--header 'Content-Type: application/json' \
--header 'Authorization: sendsay apikey=API_KEY' \
--data-raw '[{
      "id": "product1", //обязательно, формат String
      "name": "name", //рекомендуется, формат String
      "price": 7.88, //обязательно, формат Decimal64(2)
      "old_price": 5.99,//обязательно для события PRODUCT_PRICE_CHANGED, формат Decimal64(2)
      "description": "description", //формат String
      "picture": [], //абсолютные ссылки в массиве
      "url": "url", //формат String, абсолютная ссылка
      "model": "model", //формат String
      "vendor": "vendor", //формат String
      "category_id": 777, //формат Int64
      "category": "category name" //формат String
}]'

Доступ к событиям через Sendsay API

Использование данных из YML-файла

Мы предлагаем вам передавать все сведения о товаре в параметрах события, это в будущем гарантирует более удобное использование этих данных и при персонализации писем и при сегментации.

Ситуации, при которых вам могут понадобиться данные из YML-файла:

вы передаете в событиях не полный набор параметров товара, например только ID;
использование сценария «Брошенный просмотр категории»
использование функций ProScript, в результате работы которых, вы получаете только ID товара, например, блоки рекомендаций типа «самое просматриваемое» или «самое покупаемое».

Важно

Выводить в письме данные из YML-файла возможно только в том случае, если ID товара в YML-файле будет совпадать с ID товара, передаваемого в событии.

Подключение YML-файла к аккаунту осуществляется через личный кабинет при подключении сайта. Подключить данные из YML-файла к письму можно следующей командой ProScript:

[% external_extra("https://mysite.ru/example.yml","method","get","ignore_error","1","format","yml") %]

Отправка событий на базе еcоmmеrсe-событий Google Analytics и Яндекс Метрики

Если вы уже настроили отправку еcоmmеrсe-событий в Google Analytics 4 или Яндекс Метрику, модуль «Sendsay Продажи» может собирать данные без дополнительных настроек. Просто установите на всех страницах сайта наш скрипт.

Важно

В случае если отправка событий в Яндекс Метрику настроена через Google Analytics 4, необходимо использовать схему данных событий Google Analytics 4 и указать код схемы в параметре dataLayerScheme (dataLayerScheme: 'ga4').

Настройка событий через Google Analytics 4

Установите на сайт код:

<script type="text/javascript">(function(d,w,t,u,o,s,v) {w[o] = w[o] || function() {(w[o].q = w[o].q || []).push(arguments)};s = d.createElement("script");s.async = 1;s.src = u;v = d.getElementsByTagName(t)[0]; v.parentNode.insertBefore(s, v);})(document,window,"script","//image.sendsay.ru/js/target/tracking_v2.min.js","sndsy");sndsy("init", { fid: "ID АККАУНТА", v: "1.0", dataLayerWatch: true, dataLayerScheme: 'ga4' });sndsy("send", {});</script>

Соответствие событий из Google Analytics 4 событиям модуля:

Событие в Google Analytics 4	Событие модуля «Sendsay Продажи»
view_item	VIEW_PRODUCT
view_item_list	VIEW_CATEGORY
add_to_cart	BASKET_ADD
remove_from_cart	BASKET_ADD
purchase	ORDER
add_to_wishlist	FAVORITE

Настройка событий через Яндекс Метрику

Установите на сайт код:

<script type="text/javascript">(function(d,w,t,u,o,s,v) {w[o] = w[o] || function() {(w[o].q = w[o].q || []).push(arguments)};s = d.createElement("script");s.async = 1;s.src = u;v = d.getElementsByTagName(t)[0]; v.parentNode.insertBefore(s, v);})(document,window,"script","//image.sendsay.ru/js/target/tracking_v2.min.js","sndsy");sndsy("init", { fid: "ID АККАУНТА", v: "1.0", dataLayerWatch: true, dataLayerScheme: 'ym' });sndsy("send", {});</script>

Соответствие событий из Яндекс Метрики событиям модуля:

Событие в Яндекс Метрике	Событие модуля «Sendsay Продажи»
impressions	VIEW_CATEGORY
detail	VIEW_PRODUCT
add	BASKET_ADD
remove	BASKET_ADD
purchase	ORDER

Документация по Яндекс Метрике

Чтобы игорировать передачу нежелательных событий из Яндекс Метрики в Sendsay, добавьте в скрипт параметр dataLayerIgnoreEvents: ['тип события'].

Пример с исключением событий просмотра категории и заказа:

..sndsy("init", { fid: "ID АККАУНТА", v: "1.0", dataLayerWatch: true, dataLayerScheme: 'ym', dataLayerIgnoreEvents: ['impressions', 'purchase']});..

Внимание!

Если события в Яндекс Матрику или Google Analytics 4 передаются в момент перехода посетителя на другую страницу сайта, то следующая страница может загрузиться раньше, чем код счётчика передаст данные в Метрику. В результате информация о событии будет потеряна и модуль не сможет её получить.

Клиентские события

Регистрация

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent(
    'REGISTRATION',
    { email: 'АДРЕС КЛИЕНТА' } //обязательно
  );
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Авторизация

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent(
    'AUTHORIZATION',
    { email: 'АДРЕС КЛИЕНТА' } //обязательно
  );
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Просмотр карточки товара

Событие «Просмотр карточки товара» может возникать при посещении пользователем страницы с описанием товара (услуги) или при открытии окошка «быстрый просмотр товара».

Информация о данном событии используется в сценарии «Брошенный просмотр», в рекомендационной системе, а также при сегментации пользователей на основе их интересов.

Передача события в Sendsay

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent('VIEW_PRODUCT', [
    {
        "id": "product1", //обязательно, формат String
        "available": 1 | 0, //формат UInt8
        "name": "name", //рекомендуется, формат String
        "price": 7.88, //рекомендуется, формат Decimal64(2)
        "old_price": 5.99,//формат Decimal64(2)
        "description": "description", //формат String
        "picture": [], //абсолютные ссылки в массиве
        "url": "url", //формат String, абсолютная ссылка
        "model": "model", //формат String
        "vendor": "vendor", //формат String
        "category_id": 777, //рекомендуется для товарных подборок и сегментации, формат Int64
        "category": "category name" //рекомендуется для сегментации, формат String
    }
  ],
    { email: 'АДРЕС КЛИЕНТА' } //необязательно, при отсутствии email будет распознаваться нашим скриптом
  );
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Просмотр категории

Событие «Просмотр категории» может возникать при посещении страниц со списком товаров в каталоге на сайте.

Информация о данном событии используется в сценарии «Брошенный просмотр категории», в рекомендационной системе, а также при сегментации пользователей на основе их интересов.

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent(
    'VIEW_CATEGORY',
    [
      {
        "category": "", //Cтрока - наименование категории, формат String
        "category_id": INT //формат Int64, идентификатор из YML
      }
    ],
    { email: 'АДРЕС КЛИЕНТА' } //необязательно, при отсутствии email будет распознаваться нашим скриптом
  );
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Действия с корзиной

Для запуска сценария «Брошенная корзина» вы можете передавать Sendsay состояние корзины пользователя.

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

Чек-лист для проверки настройки корзины:

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

При тестировании корзины рекомендуем проверять, совпадают ли товары в режиме предпросмотра шаблона сценария «Брошенная корзина» с адресом, для которого вы изменяете корзину на своем сайте (см. Тестирование модуля).

Важно

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

Обновление корзины

В данных должно прийти полное состояние корзины на момент вызова запроса.

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent(
    'BASKET_ADD',
    [
      {
        "transaction_id": "x1", //необязательно, формат String
        "transaction_dt": "2022-07-25 23:25:13", //необязательно, формат даты YYYY-MM-DD hh:mm:ss
        "transaction_sum": 100.9, //рекомендуется
        "update_per_item": 1|0, //необязательно (по умолчанию 0)
        "items": [ //обязательно
          {
            "id": "product1", //обязательно, формат String
            "available": 1 | 0, //формат UInt8
            "name": "name", //рекомендуется, формат String
            "qnt": 1, //обязательно, формат Int64
            "price": 7.88, //рекомендуется, формат Decimal64(2)
            "old_price": 5.99,//формат Decimal64(2)
            "picture": [], //абсолютные ссылки в массиве
            "url": "url", //формат String, абсолютная ссылка
            "model": "model", //формат String
            "vendor": "vendor", //формат String
            "category_id": 777, //рекомендуется для товарных подборок и сегментации, формат Int64
            "category": "category name" //рекомендуется для сегментации, формат String
            //вы можете использовать любые доступные поля описания товара
          }
        ]
      }
    ],
    { email: 'АДРЕС КЛИЕНТА' } //необязательно, при отсутствии email будет распознаваться нашим скриптом
  );
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Обновление корзины по одному элементу

Для обновления содержимого корзины по одному элементу необходимо указать в запросе параметр "update_per_item":1

Значение парамера qnt передается как строка. Правила указания значения qnt:

"+X" - добавляем к имеющемуся числу в qnt X
"-X" - уменьшаем имеющееся число qnt на X
"0" - удаляем строчку с товаром
"X" - меняем qnt на X

Если переданной в запросе позиции (product.id) нет в текущей корзине, то создаем новую запись с указанными значениеми, стартовое значение qnt считаем как 0.
Позиции корзины, для которых в запросе не заданы изменения, остаются в корзине без изменений.
Если в результате уменьшения qnt продукта, qnt становится меньше 0, то устанавливается минусовое значение.
Если в результате уменьшения qnt продукта, qnt становится равно 0, то позиция удаляется.

Очистка корзины

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent('BASKET_CLEAR', { email: 'some@domain.com' });
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Корзина также очищается в случае поступления запроса с пустым массивом items.

В случае поступления информации о заказе при наличии неочищенной корзины, корзина очищается автоматически.

Действия с заказом

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  //Call methods with params
  sndsyApi.ssecEvent(
    'ORDER',
    [
      {
        "transaction_id": "x1", //обязательно, формат String
        "transaction_status": 1, //обязательно, формат UInt8
        "transaction_dt": "2022-07-25 23:25:13", //обязательно, формат даты YYYY-MM-DD hh:mm:ss
        "transaction_sum": 100.9, //обязательно, формат Decimal64(2)
        "payment_dt": "2022-07-25 23:25:13", //необязательно
        "delivery_dt": "2022-07-25 23:25:13", //необязательно
        "update": 1 | 0, //необязательно, формат UInt8
        "items": [  //обязательно при update != 1
          {
            "id": "product1", //обязательно, формат String
            "available": 1 | 0, //формат UInt8
            "name": "name", //рекомендуется, формат String
            "price": 7.88, //рекомендуется, формат Decimal64(2)
            "old_price": 5.99,//формат Decimal64(2)
            "qnt": 1, //обязательно, формат Int64
            "description": "description", //формат String
            "picture": [], //абсолютные ссылки в массиве
            "url": "url", //формат String, абсолютная ссылка
            "model": "model", //формат String
            "vendor": "vendor", //формат String
            "category_id": 777, //рекомендуется для товарных подборок и сегментации, формат Int64
            "category": "category name" //рекомендуется для сегментации, формат String
            //вы можете использовать любые доступные поля описания товара
          }
        ]
      }
    ],
    { email: 'АДРЕС КЛИЕНТА' } //необязательно, при отсутствии email будет распознаваться нашим скриптом
  );
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

При создании заказа указание значения параметра "transaction_status":1 обязательно. В случае отсуствия или передачи других значений не будет создано триггерное событие "новый заказ".

Ключ "update": 1 действует только для существующего заказа с номером transaction_id. Если такого заказа нет, запрос вернёт сообщение об ошибке.

Если с update == 1 не передан массив items, то данные о товарах заказа берутся из последней записи о заказе c указанным в запросе transaction_id.

Использование поиска по сайту

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent(
    'SEARCH_PRODUCT',
    [
      {
        "description": "поисковая строка" //формат String
      }
    ],
    { email: 'АДРЕС КЛИЕНТА' } //необязательно, при отсутствии email будет распознаваться нашим скриптом
  );
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Подписка на изменение стоимости

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  var productData = [
      {
        "id": "product1", //обязательно, формат String
        "available": 1 | 0, //формат UInt8
        "name": "name", //рекомендуется, формат String
        "price": 7.88, //рекомендуется, формат Decimal64(2)
        "picture": [], //абсолютные ссылки в массиве
        "url": "url", //формат String, абсолютная ссылка
        "model": "model", //формат String
        "vendor": "vendor", //формат String
        "category_id": 777, //формат Int64
        "category": "category name" //формат String
      }
    ],
    extraData = {
      email: 'АДРЕС КЛИЕНТА'
    }; //необязательно, при отсутствии email будет распознаваться нашим скриптом

  sndsyApi.ssecEvent(
    'SUBSCRIBE_PRODUCT_PRICE',
    {
      add: productData,
    },
    extraData
  );
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Удаление подписок на изменение стоимости товара:

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent('SUBSCRIBE_PRODUCT_PRICE', {
    delete: '41', // или ['41','54','71']
  });
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Очистка всех подписок на изменение стоимости товара:

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent('SUBSCRIBE_PRODUCT_PRICE', {
    clear: 1,
  });
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Подписка на информирование о появлении товара в продаже

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  var productData = [
      {
            "id": "product1", //обязательно, формат String
            "available": 1 | 0, //формат UInt8
            "name": "name", //рекомендуется, формат String
            "price": 7.88, //рекомендуется, формат Decimal64(2)
            "picture": [], //абсолютные ссылки в массиве
            "url": "url", //формат String, абсолютная ссылка
            "model": "model", //формат String
            "vendor": "vendor", //формат String
            "category_id": 777, //формат Int64
            "category": "category name" //формат String
      }
    ],
    extraData = {
      email: 'АДРЕС КЛИЕНТА'
    }; //необязательно, при отсутствии email будет распознаваться нашим скриптом

  sndsyApi.ssecEvent(
    'SUBSCRIBE_PRODUCT_ISA',
    {
      add: productData,
    },
    extraData
  );
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Удаление подписок о появлении товара в продаже:

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent('SUBSCRIBE_PRODUCT_ISA', {
    delete: '41', // или ['41','54','71']
  });
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Очистка всех подписок о появлении товара в продаже:

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent('SUBSCRIBE_PRODUCT_ISA', {
    clear: 1,
  });
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Управление избранным

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  var productData = [
      {
        "id": "product1", //обязательно, формат String
        "available": 1 | 0, //формат UInt8
        "name": "name", //рекомендуется, формат String
        "price": 7.88, //рекомендуется, формат Decimal64(2)
        "picture": [], //абсолютные ссылки в массиве
        "url": "url", //формат String, абсолютная ссылка
        "model": "model", //формат String
        "vendor": "vendor", //формат String
        "category_id": 777, //формат Int64
        "category": "category name" //формат String
      }
    ],
    extraData = {
      email: 'АДРЕС КЛИЕНТА'
    }; //необязательно, при отсутствии email будет распознаваться нашим скриптом

  sndsyApi.ssecEvent(
    'FAVORITE',
    {
      add: productData,
    },
    extraData
  );
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Удаление «Избранного»:

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent('FAVORITE', {
    delete: '41', // или ['41','54','71']
  });
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Очистка всего содержимого в «Избранном»:

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent('FAVORITE', {
    clear: 1,
  });
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Оформление предварительного заказа

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  var productData = [
      {
        "id": "product1", //обязательно, формат String
        "available": 1 | 0, //формат UInt8
        "name": "name", //рекомендуется, формат String
        "price": 7.88, //рекомендуется, формат Decimal64(2)
        "picture": [], //абсолютные ссылки в массиве
        "url": "url", //формат String, абсолютная ссылка
        "model": "model", //формат String
        "vendor": "vendor", //формат String
        "category_id": 777, //формат Int64
        "category": "category name" //формат String
      }
    ],
    extraData = {
      email: 'АДРЕС КЛИЕНТА'
    }; //необязательно, при отсутствии email будет распознаваться нашим скриптом

  sndsyApi.ssecEvent(
    'PREORDER',
    {
      add: productData,
    },
    extraData
  );
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Удаление предзаказа:

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent('PREORDER', {
    delete: '41', // или ['41','54','71']
  });
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Очистка всех предзаказов:

(window['sndsyApiOnReady'] = window['sndsyApiOnReady'] || []).push(function () {
  sndsyApi.ssecEvent('PREORDER', {
    clear: 1,
  });
});
typeof sndsyApi != 'undefined' && sndsyApi.runQueue();

Тестирование модуля

Чтобы проверить, правильно ли настроена передача данных в Sendsay, рекомендуем выполнить следующие действия:

Перейдите на сайт из любой рассылки, отправленной на свой адрес из аккаунта Sendsay (тестовая копия в данном случае не подойдет). Это необходимо, чтобы установились cookie для вашего адреса, иначе события будут записываться за анонимным контактом.
Перейдите на страницу товара, если у вас настроена передача события Просмотр товара.
Откройте любую категорию, если у вас настроена передача события Просмотр категории.
Проверьте поступление событий в разделе Просмотр событий. Если вы не видите событий, отфильтруйте таблицу по Анонимным контактам и выполните п.1.

В этой же таблице Просмотр событий проверьте, все ли нужные вам данные передаются в Sendsay — например, ссылки на товары. Для этого настройте нужные поля в таблице и посмотрите, все ли данные отображаются.
Добавьте товар в корзину из галереи и из карточки товара, измените количество, удалите товар из корзины (см. Действие с корзиной).
Проверьте совпадение товаров в корзине на сайте с теми, которые выводятся в карточке подписчика в разделе Продажи/Корзина или в предпросмотре шаблона сценария «Брошенная корзина» для вашего адреса:
Удалите все товары из корзины на сайте и убедитесь, что корзина очищена и в Sendsay — в карточке подписчика в корзине должно быть пусто.
При оформлении заказа также проверьте, очищается ли корзина. Если вы передаете данные о заказах с сайта, корзина будет очищаться при поступлении заказа автоматически. В остальных случаях необходимо передавать событие Очистка корзины.
Для тестирования других событий выполните действия на сайте и проверьте отображение событий в разделе События сайта.

Настройка модуля​

Список клиентских ssec-событий​

Набор доступных полей​

Статусы заказа​

Структура ssec-события​

Персонализация первичного ключа товара для корзины и заказа​

Добавление событий через JS-cкрипт​

JavaScript-синтаксис​

Изменение анкетных данных контакта через JS-функции добавления событий​

Добавление данных через Sendsay API​

Добавление обезличенных событий​

Доступ к событиям через Sendsay API​

Использование данных из YML-файла​

Отправка событий на базе еcоmmеrсe-событий Google Analytics и Яндекс Метрики​

Настройка событий через Google Analytics 4​

Настройка событий через Яндекс Метрику​

Клиентские события​

Регистрация​

Авторизация​

Просмотр карточки товара​

Передача события в Sendsay​

Просмотр категории​

Действия с корзиной​

Обновление корзины​

Обновление корзины по одному элементу​

Очистка корзины​

Действия с заказом​

Использование поиска по сайту​

Подписка на изменение стоимости​

Подписка на информирование о появлении товара в продаже​

Управление избранным​

Оформление предварительного заказа​

Тестирование модуля​

Настройка модуля

Список клиентских ssec-событий

Набор доступных полей

Статусы заказа

Структура ssec-события

Персонализация первичного ключа товара для корзины и заказа

Добавление событий через JS-cкрипт

JavaScript-синтаксис

Изменение анкетных данных контакта через JS-функции добавления событий

Добавление данных через Sendsay API

Добавление обезличенных событий

Доступ к событиям через Sendsay API

Использование данных из YML-файла

Отправка событий на базе еcоmmеrсe-событий Google Analytics и Яндекс Метрики

Настройка событий через Google Analytics 4

Настройка событий через Яндекс Метрику

Клиентские события

Регистрация

Авторизация

Просмотр карточки товара

Передача события в Sendsay

Просмотр категории

Действия с корзиной

Обновление корзины

Обновление корзины по одному элементу

Очистка корзины

Действия с заказом

Использование поиска по сайту

Подписка на изменение стоимости

Подписка на информирование о появлении товара в продаже

Управление избранным

Оформление предварительного заказа

Тестирование модуля