Javascript SDK

Интеграция JavaScript SDK через Анонимизатор

Copy page

Анонимизатор — это промежуточный сервис, который обрабатывает запросы от JavaScript SDK перед их отправкой в Mindbox. Он позволяет анонимизировать персональные данные (ПД) и другую чувствительную информацию, не передавая ее за пределы инфраструктуры клиента.

Обобщенная схема потока данных:

Анонимизатор принимает запросы от трекера, обрабатывает ПД согласно заданным правилам (хеширование, токенизация, удаление), а затем передает обезличенные данные в Mindbox.

Отличия от стандартной интеграции Javascript SDK

Характеристика	Стандартная интеграция	Анонимизатор
Адрес запросов	API Mindbox (домен проекта)	Анонимизатор (инфраструктура клиента)
Передача ПД	ПД передаются напрямую в Mindbox	ПД сначала анонимизируются, после чего передаются в Mindbox
Прямые вызовы к API Mindbox	Разрешены	Запрещены

Инициализация

Для работы с JavaScript SDK используется один объект mindbox.​ Методы вызываются через конструкцию: mindbox('methodName', methodParameters, ... ), при этом логика анонимизации реализуется на стороне Анонимизатора и недоступна напрямую из трекера.​

Для работы с Анонимизатором используется стандартный механизм инициализации JavaScript SDK с дополнительным параметром serviceDomain.

Пример:

Code
<script>
  window.mindbox = window.mindbox || function () {
    mindbox.queue.push(arguments);
  };
  mindbox.queue = mindbox.queue || [];

  mindbox('create', {
    endpointId: 'example.Website', //Идентификатор точки интеграции
    serviceDomain: 'anonymizer.example.com', // публичный домен сервиса анонимизатора

  });
</script>
<script src="https://...mindbox.ru/.../tracker.js" async></script>

---

Вызов операций через Анонимизатор

Вызов операций не меняется — используется стандартный метод async, в котором указывается название операции (operation) и данные (data).​

Запрос уйдет на эндпоинт Анонимизатора (указанный в serviceDomain). Данные клиента будут обработаны в Анонимизаторе и только после этого переданы к API Mindbox.

Пример:

Code
mindbox('async', {
  operation: 'MySite.Registration',
  data: {
    customer: {
      email: 'user@example.com',
      mobilePhone: '79990000000',
      firstName: 'Иван'
    }
  },
  onSuccess: function () {
    console.log('Операция успешно отправлена');
  },
  onError: function (error) {
    console.error(error);
  }
});

Возможные ошибки

Ошибка	Причина	Решение
401 Unauthorized	В Анонимизаторе неверно указаны ключи.	Необходимо проверить корректность указанных ключей в настройках Анонимизатора.
500 Internal Server Error	Сервис Анонимизатор установлен с ошибками или возникла ошибка на стороне инфраструктуры клиента.	Проверьте наличие ошибок на стороне инфраструктуры клиента и убедитесь, что все шаги по установке сервиса выполнены.
Cross-Origin Request Blocked	Поддомен, который используется Javascript SDK для работы, был заблокирован настройками сайта.	Необходимо разрешить кросс-доменные запросы, либо добавить https://*.mindbox.ru в разрешенные зоны для кросс-доменных запросов
Refused to connect to 'https://....mindbox.ru/....' because it violates the following Content Security Policy directive: ...	Настройки сайта запрещают трекеру обращаться к api на одном из наших поддоменов.	Разрешить все для скриптов с https://*.mindbox.ru
Refused to load the script 'https://....mindbox.ru/....js' because it violates the following Content Security Policy directive: ...	Настройки сайта запрещают загружать трекер или его части из-за используемых ими возможностей браузера.	Разрешить все для скриптов с https://*.mindbox.ru