Product Guides

Метод создания карточки покупателя

Suggest Edits

📘

Поддержка региональности

Если интеграция подразумевает использование регионов (стоков), то в трекинг-код дополнительно надо передавать ID региона, в котором находится пользователь.

Все примеры кодов ниже приведены на двух вкладках - с поддержкой регионов и без.

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

🚧

Описание параметров

<customerId> - строка, уникальный идентификатор клиента, обязательный параметр;

<softLinks> - словарь, абстрактный указатель на посетителя - пара, состоящая из произвольных строки-ключа и строки-значения (например, ключ — "карта лояльности", значение — "номер_карты"), опциональный параметр;

<email> - строка, email-адрес пользователя, опциональный параметр;

<phone> - строка, номер телефона пользователя в формате E.164, опциональный параметр;
Примеры номеров телефонов в подходящем формате:

71112223344
81112223344
+71112223344
+7(111)2223344
+7(111)222-33-44
+7 (111) 222-33-44
+7 (111) 222 33 44
+7 111 222 33 44
+7-111-222-33-44
8-111-222-33-44
5577999617074
31687224865
56948840030
123456789012345

<defaultStockId> - строка, идентификатор региона, строка, до 50 символов. Должен соответствовать идентификатору региона, переданному в товарной базе, опциональный параметр;

<customData> - дополнительные параметры пользователя, словарь со строкой-ключом и строкой-значением, опциональный параметр;

<isAgreedToReceiveMarketingMail> - согласие на подписку, булево значение, опциональный параметр; значение по умолчанию true

<mobilePushSubscription> - опциональный объект, содержит информацию о подписке на мобильные push-уведомления, если таковые используются. Содержит внутри другой объект, в зависимости от типа подписки, их примеры приведены ниже на странице

<script type="text/javascript">
    (window["rrApiOnReady"] = window["rrApiOnReady"] || []).push(function() {
      try {
        rrApi.setCustomer({
          "customerId": "customerId",
          "email": "email",
          "phone": "phone",
          "customData": {
            customDataName1: "customDataValue1",
            customDataName2: "customDataValue2",
          },
          "softLinks": [{
              name: "testLinkName1",
              value: "testValue1"
            },
            {
              name: "testLinkName2",
              value: "testValue2"
            }
          ],
          "mobilePushSubscription" : {
            "fcmSubscription" : {
              "creationTimestamp" : "2025-03-31T11:03:02.3564674+03:00",
              "applicationId" : "applictionId",
      	      "fcmProjectId" : "my-awesome-fcm-project",
      	      "token" : "fcm-push-token"
            }
          },
          "isAgreedToReceiveMarketingMail": true
        });
      } catch (e) {}
  })
</script>


<script type="text/javascript">
    (window["rrApiOnReady"] = window["rrApiOnReady"] || []).push(function() {
      try {
        rrApi.setCustomer({
          "customerId": "customerId",
          "email": "email",
          "phone": "phone",
          "customData": {
            customDataName1: "customDataValue1",
            customDataName2: "customDataValue2",
          },
          "defaultStockId": "defaultStockId",
          "softLinks": [{
              Name: "testLinkName1",
              Value: "testValue1"
            },
            {
              Name: "testLinkName2",
              Value: "testValue2"
            }
          ],
          "mobilePushSubscription" : {
            "fcmSubscription" : {
              "creationTimestamp" : "2025-03-31T11:03:02.3564674+03:00",
              "applicationId" : "applictionId",
      	      "fcmProjectId" : "my-awesome-fcm-project",
      	      "token" : "fcm-push-token"
            }
          },
          "isAgreedToReceiveMarketingMail": true
        });
      } catch (e) {}
  })
</script>

Примеры объектов подписки на мобильные push-уведомления

"mobilePushSubscription" : {
    "fcmSubscription" : {
      "creationTimestamp" : "2025-03-31T11:03:02.3564674+03:00",
      "applicationId" : "applictionId",
      "fcmProjectId" : "my-awesome-fcm-project",
      "token" : "fcm-push-token"
    }
}

"mobilePushSubscription" : {
    "apnsSubscription" : {
      "isDevEnvironment" : false,
      "creationTimestamp" : "2024-06-25T18:09:19.4754466+03:00",
      "applicationId" : "applictionId",
      "token" : "apns-push-token"
    }
}

"mobilePushSubscription" : {
    "huaweiSubscription" : {
      "creationTimestamp" : "2024-05-14T23:17:57.5577110+03:00",
      "applicationId" : "applictionId",
      "token" : "huawei-push-token"
    }
 }

Updated about 1 month ago