fix(sendsay-docs): edit how-to-configure-data-transfer.md (#210)

sendsay-ru · Oct 31, 2023 · e04fee1 · e04fee1
1 parent 19bb35e
commit e04fee1
Showing 1 changed file with 49 additions and 0 deletions.
diff --git a/docs/ecom/how-to-configure-data-transfer.md b/docs/ecom/how-to-configure-data-transfer.md
@@ -125,6 +125,55 @@ Ssec-события всегда передаются в Sendsay как масс
 ]
 ```
 
+### Персонализация первичного ключа товара для корзины и заказа
+
+Если вам нужно передавать в корзину (заказ) разные товары с одним и тем же product.id (например, что-то с разным размером или объемом), то вам нужно передать дополнительный параметр для создания нового первичного ключа, отличного от product.id.
+
+В принимаемых данных о товаре мы ожидаем поле `uniq`, в значении которого должно передаваться имя поля с дополнением для нового первичного ключа.
+
+Поле `uniq`- необязательно, при его отсутствии в качестве первичного ключа используется значение product.id.
+
+<!-- prettier-ignore -->
+```js
+(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-функции.