API

Управление сессией

Указатель на пользователя link

Для некоторых вызовов API требуется идентифицировать посетителя, для которого этот запрос применим. Для этого необходимо использовать указатель на пользователя - параметр link.

link - это указатель на посетителя: пара, состоящая из двух параметров — link.name, где указывается название сессии, и link.value, где передается идентификатор сессии.
Значения, передаваемые внутрь этих параметров, — произвольные (например, link.name — "сессия пользователя", link.value — "идентификатор сессии").

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

📘

Подробнее про link

Использование link позволяет объединять в один профиль данные из различных источников, например:

  • Сайт;
  • Мобильное приложение;
  • Розничные точки продаж;
  • Call-центры;

Использование session (cookie)

В платформе Retail Rocket также есть возможность совмещать интеграцию трекинга пользовательского поведения, сделанного через JS SDK, с товарными рекомендациями, которые можно запрашивать через API.

Для этого, в запросах рекомендаций вместо параметров link.name и link.value , необходимо использовать параметр session, где session - анонимизированный идентификатор пользователя. Содержится на сайте в cookie rcuid, которая используется при трекинге пользовательского поведения при JS SDK интеграции.

🚧

Важно

При использовании параметра session, для оценки эффективности рекомендаций, а также для учета продаж через товарные рекомендации, необходимо передавать специальные события взаимодействия с рекомендациями.

Вы можете получить значение rcuid с помощью следующего JS метода на сайте:

<script type="text/javascript">
    (window["rrApiOnReady"] = window["rrApiOnReady"] || []).push(function() {
    try{ window.rrVisitorSessionId = retailrocket.api.getSessionId(); } catch(e) {}
  })
</script>