Настройка аутентификации для интеграции с MMP

Варианты аутентификации

Когда вы создаете Web Shop, вы можете настроить разные варианты аутентификации пользователя. Чтобы интеграция с партнерами по мобильному измерению (Mobile Measurement Partners, MMP) и атрибуция аналитики работали корректно, следуйте рекомендациям, описанным в таблице ниже.

Вариант аутентификацииДействия для настройки атрибуции аналитики

Аутентификация через ID пользователя.

Убедитесь, что CUID в Web Shop совпадает с тем, который вы отправляете MMP из вашего мобильного приложения. Если они отличаются, обратитесь к персональному менеджеру проекта или напишите на [email protected], чтобы настроить обработку вебхука Проверка пользователя в Web Shop — в ответе на него вам необходимо передавать CUID в параметре user.appPlayerId. В качестве альтернативы вы можете настроить аутентификацию пользователя через диплинк.

Аутентификация через диплинк.

Дополнительные действия не требуются.

Аутентификация через Xsolla Login, включая аутентификацию с привязкой ID пользователя.

Внимание
Обратите внимание, что для этих вариантов аутентификации не поддерживается вебхук Проверка пользователя в Web Shop.
Примечание
Мы рекомендуем использовать хранилище Xsolla в вашем проекте Login.

Настройте аутентификацию через кастомный ID. Для этого:

  1. Подключите клиент OAuth 2.0:
    1. В проекте в Личном кабинете перейдите в раздел Игроки > Авторизация.
    2. В панели необходимого проекта Login нажмите Настроить.
    3. В блоке Безопасность нажмите OAuth 2.0 аутентификация.
    4. Нажмите Добавить клиент OAuth 2.0.
    5. В модальном окне укажите:
      • Укажите название клиента.
      • Выберите тип аутентификации — Серверная (соединение server-to-server).
      • Укажите срок действия токена в секундах (опционально). Срок действия токена по умолчанию — 1 час (3600 секунд).
      • Нажмите Подключить.
    6. В новом модальном окне скопируйте значения ID клиента и Секретный ключ. Эти данные необходимы для создания JWT пользователя.
  2. Получите JWT пользователя с помощью метода API Generate JWT. Используйте ID клиента и секретный ключ, полученные на предыдущем шаге.
  3. Используйте созданный JWT пользователя для вызова метода, в котором необходимо передать CUID в параметре server_custom_id:
  1. Подключите клиент OAuth 2.0:
    1. В вашем проекте в аккаунте перейдите в раздел Другие инструменты > Авторизация.
    2. В панели необходимого проекта Login нажмите Настроить.
    3. В блоке Безопасность нажмите OAuth 2.0 аутентификация.
    4. Нажмите Добавить клиент OAuth 2.0.
    5. В модальном окне укажите:
      • Укажите название клиента.
      • Выберите тип аутентификации — Серверная (соединение server-to-server).
      • Укажите срок действия токена в секундах (опционально). Срок действия токена по умолчанию — 1 час (3600 секунд).
      • Нажмите Подключить.
    6. В новом модальном окне скопируйте значения ID клиента и Секретный ключ. Эти данные необходимы для создания JWT пользователя.
  2. Получите JWT пользователя с помощью метода API Generate JWT. Используйте ID клиента и секретный ключ, полученные на предыдущем шаге.
  3. Используйте созданный JWT пользователя для вызова метода, в котором необходимо передать CUID в параметре server_custom_id:
Примечание
Подробная информация о настройке аутентификации приведена в разделе Протокол OAuth 2.0.

Типы ID

В процессе интеграции вы можете использовать несколько типов ID. Наиболее распространенные из них описаны в таблице ниже. Обратите внимание, что не все ID могут использоваться для интеграции с MMP.

IDОписаниеПоддерживается ли MMP
ID игрока в мобильном приложении (customer user ID, CUID).ID пользователя, сгенерированный и установленный владельцем приложения в момент регистрации пользователя.Да, когда CUID в Web Shop совпадает с тем, который вы отправляете MMP из вашего мобильного приложения.
Кастомный ID сервера (server_custom_id).ID пользователя, полученный из игры в JWT пользователя. Используется, когда в Web Shop настроена аутентификация через Xsolla Login.Да, если он совпадает с CUID, который вы отправляете MMP из вашего мобильного приложения.
Universally Unique Identifier (UUID), переданный в поле sub JWT пользователя.Уникальный ID, присвоенный каждому пользователю на стороне сервера Xsolla Login. Используется, когда в Web Shop настроена аутентификация через Xsolla Login.Нет.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 30 сентября 2026

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!
Не получилось отправить ваш комментарий
Попробуйте еще раз позже или напишите нам на [email protected].