Перейти к содержимому
AI Agent

Install with AI Agent

Copy & paste this prompt

Install the Hyperstone Unity SDK in this project. Follow these steps: 1. Read the integration recipe: https://hyperstone.ai/docs/llms.txt 2. Use the documentation that best fits your context window: - Minimal (fast): https://hyperstone.ai/docs/llms.txt - Full (comprehensive): https://hyperstone.ai/docs/llms-full.txt - Small (optimized): https://hyperstone.ai/docs/llms-small.txt 3. Execute the installation following the recipe instructions. 4. Verify that the SDK is correctly installed and integrated into the project.

Конфиденциальность и данные

Эта страница описывает практику работы с данными Hyperstone Unity SDK — какую информацию собирает SDK, как она передается и хранится, и что вам необходимо раскрыть в политике конфиденциальности вашего приложения и в описании в магазинах приложений.

Свойства пользователя (User Properties)

Section titled “Свойства пользователя (User Properties)”

SDK отправляет следующие метаданные устройства и приложения при получении конфигурации с сервера:

СвойствоОписаниеПример значения
SDK VersionВерсия SDK Hyperstone1
Unity PlatformАктивная цель сборки UnityAndroid, IPhonePlayer, WindowsPlayer
Unity VersionВерсия движка Unity2022.3.20f1
App Bundle IDИдентификатор вашего приложенияcom.example.mygame
App VersionСтрока версии вашего приложения1.2.3
Operating SystemИмя и версия ОС устройстваAndroid OS 14 API-34
Device ModelСтрока модели оборудованияSamsung SM-S911B
Device TypeВычисленная категория устройстваphone, tablet, desktop
System LanguageНастройка локали / культуры устройстваen-US, de-DE
Time ZoneЧасовой пояс устройства(UTC+01:00) Central European Time
Developer FlagЯвляется ли это debug/editor сборкойtrue (отправляется только в development-сборках)

Все эти свойства являются неидентифицирующими техническими метаданными, используемыми для сегментации пользователей по группам для оптимизации. Ни одно из них не может идентифицировать конкретного пользователя.

Автоматически отслеживаемые метрики

Section titled “Автоматически отслеживаемые метрики”

SDK автоматически отслеживает следующие поведенческие метрики, не требуя никакого дополнительного кода:

МетрикаОписание
Session CountКоличество сессий приложения (новая сессия после паузы в фоне 30с+)
Engagement TimeВремя нахождения приложения на переднем плане (в минутах)
Retention DaysКоличество уникальных дней, в которые пользователь возвращался
Calendar Day RetentionКоличество уникальных календарных дней игры
Retention StreakКоличество последовательных календарных дней игры

Метрики, передаваемые разработчиком

Section titled “Метрики, передаваемые разработчиком”

Когда вы вызываете методы SDK, такие как LogAdImpression, LogIapTransactionSuccess или IncrementCustomMetric, SDK собирает:

  • Метрики рекламы — количество показов, суммы рекламного дохода, количество запросов рекламы, количество ошибок, с лейблами рекламной платформы, сети и формата
  • Метрики IAP — количество транзакций, суммы дохода, количество ошибок, флаги конверсии в плательщика, с лейблами ID продукта и валюты
  • Кастомные метрики — любые имена и значения метрик, которые ваше приложение отправляет через IncrementCustomMetric или LogCustomEvent

Примечание: Содержимое метрик, передаваемых разработчиком, определяется кодом вашего приложения. Если вы передаете конфиденциальные данные в именах кастомных метрик или лейблах, эти данные будут переданы. Отправляйте только неидентифицирующие значения, подходящие для агрегации.

Данные, которые НЕ собираются

Section titled “Данные, которые НЕ собираются”

SDK Hyperstone явным образом не собирает и не передает:

  • Рекламные идентификаторы — IDFA (iOS), GAID/ADID (Android)
  • Идентификаторы устройств — IDFV, IMEI, серийный номер, Android ID
  • MAC-адреса или другие аппаратные идентификаторы
  • Имена пользователей, адреса электронной почты или номера телефонов
  • Данные о местоположении — никаких GPS-координат, никакой точной или примерной локации
  • Контакты, фотографии, файлы или любой контент на устройстве
  • Историю браузера, историю поиска или список установленных приложений
  • Данные о здоровье, фитнесе или финансовые данные
  • Все взаимодействие между SDK и серверами Hyperstone использует HTTPS (шифрование TLS при передаче).
  • SDK взаимодействует с двумя эндпоинтами:
    • POST /v1/c — получение оптимизированной конфигурации (отправляет свойства пользователя)
    • POST /v1/i — отправка накопленных метрик
  • Запросы включают ваш App ID и App Secret в HTTP-заголовках для аутентификации. Это не пользовательские данные — это учетные данные вашего приложения из Консоли Hyperstone.
  • В заголовках запроса передается случайно сгенерированный User ID (UID) для связывания метрик с конфигурацией. Этот UID генерируется на стороне сервера и не имеет никакой связи с любым внешним идентификатором.

SDK сохраняет следующие данные локально на устройстве с помощью PlayerPrefs в Unity:

ДанныеЦель
User ID (UID)Связывает метрики с конфигурацией между сессиями
Cached ConfigПозволяет приложению использовать последнюю известную конфигурацию перед получением новой
Accumulated MetricsБуферизирует метрики локально, чтобы данные не терялись при вылетах или сбоях сети
Session MetadataВременная метка последней сессии, счетчик дней retention, статус плательщика

Все ключи имеют пространство имен по App ID (например, xp-uid-{appId}), поэтому несколько интеграций Hyperstone в одном приложении не конфликтуют.

Чтобы очистить все локально сохраненные данные, вызовите:

Hyperstone.ClearData();

Это удаляет UID, закэшированную конфигурацию, все накопленные метрики, историю сессий и статус плательщика с устройства.

Обработка данных на стороне сервера

Section titled “Обработка данных на стороне сервера”

Анонимизация IP-адресов

Section titled “Анонимизация IP-адресов”

Сервер использует IP-адрес запроса только для получения примерной географической информации: страна, регион, город и часовой пояс. Перед поиском геоданных IP-адрес анонимизируется путем обнуления последнего октета (например, 192.168.1.42192.168.1.0). Полный IP-адрес никогда не хранится.

Данные на сервере — включая UID, свойства пользователей и накопленные метрики — хранятся в течение периода активности пользователя плюс 30 дней. Каждый запрос от SDK обновляет TTL (время жизни). Если пользователь перестает использовать приложение, его данные автоматически удаляются через 30 дней бездействия.

Отсутствие передачи данных третьим лицам

Section titled “Отсутствие передачи данных третьим лицам”

Hyperstone не передает, не продает и не делится любыми собранными данными с третьими лицами. Все данные остаются внутри инфраструктуры Hyperstone и используются исключительно для оптимизации конфигураций.

Как владелец приложения в Hyperstone, вы имеете возможность удалить все данные вашего приложения из Консоли Hyperstone, включая все UID, свойства пользователей и накопленные метрики.

Обновление вашей политики конфиденциальности

Section titled “Обновление вашей политики конфиденциальности”

Если ваше приложение использует SDK Hyperstone, вы должны раскрыть это в своей политике конфиденциальности. Ниже приведен пример формулировки, которую вы можете адаптировать:

Аналитика и оптимизация

Наше приложение использует Hyperstone, сервис оптимизации конфигураций, для улучшения пользовательского опыта. SDK Hyperstone собирает неидентифицируемую техническую информацию, включая:

  • Версию приложения и идентификатор пакета (bundle identifier)
  • Тип устройства, модель и операционную систему
  • Системный язык и часовой пояс
  • Метрики использования, такие как количество сессий, время вовлеченности и retention
  • Версию SDK и версию движка Unity

Эти данные передаются по защищенному протоколу HTTPS и связываются со случайно сгенерированным идентификатором, который не имеет связи с вашей личностью или любым рекламным идентификатором. Ваш IP-адрес анонимизируется (последний октет удаляется) перед использованием для определения примерного географического положения (на уровне страны/региона). Личная информация, рекламные идентификаторы или идентификаторы устройств не собираются.

Эти данные хранятся на серверах Hyperstone до 30 дней после вашей последней сессии в приложении, после чего автоматически удаляются.

Вы можете запросить удаление ваших данных, связавшись с нами по адресу [ваш контактный email].

Apple App Store — Детали конфиденциальности приложения

Section titled “Apple App Store — Детали конфиденциальности приложения”

При отправке или обновлении приложения в App Store вы должны заполнить анкету App Privacy в App Store Connect. Вот как заполнить её для SDK Hyperstone:

Собираете ли вы или ваши сторонние партнеры данные из этого приложения?

Section titled “Собираете ли вы или ваши сторонние партнеры данные из этого приложения?”

Да — SDK Hyperstone собирает данные, описанные ниже.

Типы данных для декларирования

Section titled “Типы данных для декларирования”
Категория данныхТип данныхСобирается?Как отвечать
Contact InfoИмя, email, телефон и т.д.❌ НетНе выбирать
Health & FitnessЗдоровье, фитнес❌ НетНе выбирать
Financial InfoПлатежи, кредитная инфо❌ НетНе выбирать
LocationТочное / Примерное местоположение❌ НетНе выбирать
Sensitive InfoРелигиозные, политические и т.д.❌ НетНе выбирать
ContactsКонтакты❌ НетНе выбирать
User ContentФото, видео и т.д.❌ НетНе выбирать
Browsing HistoryИстория браузера❌ НетНе выбирать
Search HistoryИстория поиска❌ НетНе выбирать
IdentifiersUser ID✅ ДаВыбрать — SDK генерирует случайный анонимный ID пользователя
Usage DataProduct Interaction✅ ДаВыбрать — количество сессий, время вовлеченности, метрики retention
DiagnosticsPerformance Data✅ ДаВыбрать — версия приложения, версия SDK
Other DataOther✅ ДаВыбрать — тип/модель устройства, ОС, язык, часовой пояс

Для каждого выбранного типа данных

Section titled “Для каждого выбранного типа данных”

Вам будут заданы уточняющие вопросы для каждого выбранного типа данных:

Связаны ли эти данные с личностью пользователя?Нет. User ID генерируется случайно и не связан с каким-либо аккаунтом, именем, email или другой личностью.

Используются ли эти данные для трекинга (отслеживания)?Нет. Данные не используются для отслеживания пользователей между приложениями или веб-сайтами, принадлежащими другим компаниям. Они не передаются брокерам данных.

Каковы цели сбора этих данных? → Выберите Analytics и App Functionality (оптимизация конфигурации).

SDK Hyperstone не требует запроса ATT. ATT требуется только при доступе к IDFA или при связывании данных пользователя/устройства между приложениями других компаний в рекламных целях. SDK Hyperstone не делает ни того, ни другого.

Google Play — Безопасность данных

Section titled “Google Play — Безопасность данных”

При публикации приложения в Google Play вы должны заполнить форму Безопасность данных. Вот руководство для SDK Hyperstone:

Собирает или передает ли ваше приложение какие-либо из требуемых типов пользовательских данных?

Section titled “Собирает или передает ли ваше приложение какие-либо из требуемых типов пользовательских данных?”

Да — приложение собирает данные через SDK Hyperstone.

Типы данных для декларирования

Section titled “Типы данных для декларирования”
КатегорияТип данныхСобирается?Передается?Примечания
LocationПримерное местоположение❌ Нет❌ НетСервер определяет гео по анонимизированному IP, но приложение не собирает локацию
LocationТочное местоположение❌ Нет❌ Нет
Personal infoИмя, email, адрес, телефон и т.д.❌ Нет❌ Нет
Financial infoИстория покупок, кредитная инфо❌ Нет❌ Нет
Health and fitnessЗдоровье, фитнес❌ Нет❌ Нет
MessagesEmail, SMS, другие сообщения❌ Нет❌ Нет
Photos and videosФото, видео❌ Нет❌ Нет
AudioГолосовые записи, музыкальные файлы❌ Нет❌ Нет
Files and docsФайлы, документы❌ Нет❌ Нет
CalendarСобытия календаря❌ Нет❌ Нет
ContactsКонтакты❌ Нет❌ Нет
App activityApp interactions✅ Да❌ НетКоличество сессий, время вовлеченности, использование функций
App info and performanceDiagnostics✅ Да❌ НетВерсия приложения, версия SDK, ОС, модель устройства
Device or other IDsDevice or other IDs✅ Да❌ НетАнонимный случайно сгенерированный ID пользователя (не идентификатор устройства)

Для каждого собираемого типа данных

Section titled “Для каждого собираемого типа данных”

Обрабатываются ли эти данные эфемерно?Нет — данные сохраняются локально и хранятся на сервере в течение 30 дней.

Является ли сбор данных обязательным или пользователи могут отказаться? → Сбор данных обязателен для работы SDK (оптимизация конфигурации). Разработчики приложений могут опционально вызвать ClearData() для сброса пользовательских данных.

Для чего собираются эти данные? → Выберите Analytics и App functionality.

Для всех типов данных ответьте Нет на вопрос о передаче данных — Hyperstone не передает данные третьим лицам.

Практики обработки данных

Section titled “Практики обработки данных”

Зашифрованы ли данные при передаче?Да — всё взаимодействие SDK использует HTTPS.

Могут ли пользователи запросить удаление данных?Да — разработчики приложений могут удалить все данные приложения из Консоли Hyperstone, а локальные данные пользователей могут быть очищены с помощью ClearData().

АспектДетали
Сбор PIIНет
Рекламные идентификаторыНе собираются
Идентификаторы устройствНе собираются
User IDСлучайный, анонимный, не коррелируемый
Безопасность передачиHTTPS
Обработка IPАнонимизируется перед поиском гео, не хранится
Хранение на сервереTTL 30 дней с момента последней активности
Передача третьим лицамНет
Требуется ATTНет
Сброс локальных данныхHyperstone.ClearData()
Удаление данных с сервераДоступно из Консоли Hyperstone