Перейти к содержимому
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.

Privacy & Data

Это содержимое пока не доступно на вашем языке.

This page describes the data practices of the Hyperstone Unity SDK — what information is collected, how it is transmitted and stored, and what you need to disclose in your app’s privacy policy and store listings.

The SDK sends the following device and app metadata when fetching a configuration from the server:

PropertyDescriptionExample Value
SDK VersionVersion of the Hyperstone SDK1
Unity PlatformActive Unity build targetAndroid, IPhonePlayer, WindowsPlayer
Unity VersionVersion of the Unity engine2022.3.20f1
App Bundle IDYour application identifiercom.example.mygame
App VersionYour application version string1.2.3
Operating SystemDevice OS name and versionAndroid OS 14 API-34
Device ModelHardware model stringSamsung SM-S911B
Device TypeComputed device categoryphone, tablet, desktop
System LanguageDevice locale / culture settingen-US, de-DE
Time ZoneDevice time zone(UTC+01:00) Central European Time
Developer FlagWhether this is a debug/editor buildtrue (only sent in development builds)

All of these properties are non-identifying technical metadata used to segment users into groups for optimization. None of them can identify an individual user.

The SDK automatically tracks the following behavioral metrics without requiring any additional code:

MetricDescription
Session CountNumber of app sessions (new session after 30s+ background pause)
Engagement TimeTime spent with the app in the foreground (in minutes)
Retention DaysNumber of distinct days the user has returned
Calendar Day RetentionNumber of distinct calendar days played
Retention StreakConsecutive calendar days played

When you call SDK methods like LogAdImpression, LogIapTransactionSuccess, or IncrementCustomMetric, the SDK collects:

  • Ad metrics — impression counts, ad revenue amounts, ad request counts, error counts, with labels for ad platform, network, and format
  • IAP metrics — transaction counts, revenue amounts, error counts, purchaser conversion flags, with labels for product ID and currency
  • Custom metrics — whatever metric names and values your app sends via IncrementCustomMetric or LogCustomEvent

Note: The content of developer-reported metrics is determined by your app’s code. If you pass sensitive data in custom metric names or labels, that data will be transmitted. Only send non-identifying, aggregate-friendly values.

The Hyperstone SDK explicitly does not collect or transmit:

  • Advertising identifiers — IDFA (iOS), GAID/ADID (Android)
  • Device identifiers — IDFV, IMEI, serial number, Android ID
  • MAC addresses or other hardware identifiers
  • User names, email addresses, or phone numbers
  • Location data — no GPS coordinates, no fine/coarse location
  • Contacts, photos, files, or any on-device content
  • Browsing history, search history, or installed apps
  • Health, fitness, or financial data
  • All communication between the SDK and Hyperstone servers uses HTTPS (TLS encryption in transit).
  • The SDK communicates with two endpoints:
    • POST /v1/c — fetches the optimized configuration (sends user properties)
    • POST /v1/i — sends accumulated metrics
  • Requests include your App ID and App Secret in HTTP headers for authentication. These are not user data — they are your app credentials from the Hyperstone Console.
  • A randomly generated User ID (UID) is included in request headers to associate metrics with a configuration. This UID is generated server-side and has no correlation with any external identifier.

The SDK persists the following data locally on the device using Unity’s PlayerPrefs:

DataPurpose
User ID (UID)Associates metrics with a configuration across sessions
Cached ConfigAllows the app to use the last-known config before fetching a new one
Accumulated MetricsBuffers metrics locally so no data is lost on crashes or network failures
Session MetadataLast session timestamp, retention day count, purchaser status

All keys are namespaced by App ID (e.g., xp-uid-{appId}), so multiple Hyperstone integrations in the same app do not conflict.

To clear all locally stored data, call:

Hyperstone.ClearData();

This removes the UID, cached config, all accumulated metrics, session history, and purchaser status from the device.

The server uses the request’s IP address only to derive coarse geographic information: country, region, city, and time zone. Before geo lookup, the IP address is anonymized by setting the last octet to zero (e.g., 192.168.1.42192.168.1.0). The full IP address is never stored.

Server-side data — including UIDs, user properties, and accumulated metrics — is retained for the duration of user activity plus 30 days. Each request from the SDK refreshes the TTL. If a user stops using the app, their data is automatically purged after 30 days of inactivity.

Hyperstone does not transfer, sell, or share any collected data with third parties. All data remains within the Hyperstone infrastructure and is used exclusively for configuration optimization.

As an app owner on Hyperstone, you have the ability to delete the entirety of your app’s data from the Hyperstone Console, including all UIDs, user properties, and accumulated metrics.

If your app uses the Hyperstone SDK, you should disclose this in your privacy policy. Below is example language you can adapt:

Analytics and Optimization

Our app uses Hyperstone, a configuration optimization service, to improve the user experience. The Hyperstone SDK collects non-personally-identifiable technical information, including:

  • App version and bundle identifier
  • Device type, model, and operating system
  • System language and time zone
  • Usage metrics such as session count, engagement time, and retention
  • SDK version and Unity engine version

This data is transmitted securely over HTTPS and associated with a randomly generated identifier that has no connection to your identity or any advertising identifier. Your IP address is anonymized (last octet removed) before being used to determine approximate geographic location (country/region level). No personal information, advertising identifiers, or device identifiers are collected.

This data is retained on Hyperstone servers for up to 30 days after your last app session, after which it is automatically deleted.

You can request deletion of your data by contacting us at [your contact email].

When submitting or updating your app on the App Store, you must complete the App Privacy questionnaire in App Store Connect. Here is how to fill it for the Hyperstone SDK:

Do you or your third-party partners collect data from this app?

Section titled “Do you or your third-party partners collect data from this app?”

Yes — The Hyperstone SDK collects data as described below.

Data CategoryData TypeCollected?How to Answer
Contact InfoName, email, phone, etc.❌ NoDo not select
Health & FitnessHealth, fitness❌ NoDo not select
Financial InfoPayment, credit info❌ NoDo not select
LocationPrecise / Coarse Location❌ NoDo not select
Sensitive InfoReligious, political, etc.❌ NoDo not select
ContactsContacts❌ NoDo not select
User ContentPhotos, videos, etc.❌ NoDo not select
Browsing HistoryBrowsing history❌ NoDo not select
Search HistorySearch history❌ NoDo not select
IdentifiersUser ID✅ YesSelect — the SDK generates a random anonymous user ID
Usage DataProduct Interaction✅ YesSelect — session counts, engagement time, retention metrics
DiagnosticsPerformance Data✅ YesSelect — app version, SDK version
Other DataOther✅ YesSelect — device type/model, OS, language, timezone

You will be asked follow-up questions for each selected data type:

Is this data linked to the user’s identity?No. The user ID is randomly generated and not linked to any account, name, email, or other identity.

Is this data used for tracking?No. The data is not used to track users across apps or websites owned by other companies. It is not shared with data brokers.

What are the purposes of this data collection? → Select Analytics and App Functionality (configuration optimization).

The Hyperstone SDK does not require an ATT prompt. ATT is only required when accessing the IDFA or linking user/device data across apps owned by other companies for advertising. The Hyperstone SDK does neither.

When publishing your app on Google Play, you must complete the Data Safety form. Here is guidance for the Hyperstone SDK:

Does your app collect or share any of the required user data types?

Section titled “Does your app collect or share any of the required user data types?”

Yes — The app collects data through the Hyperstone SDK.

CategoryData TypeCollected?Shared?Notes
LocationApproximate location❌ No❌ NoServer derives geo from anonymized IP, but the app does not collect location
LocationPrecise location❌ No❌ No
Personal infoName, email, address, phone, etc.❌ No❌ No
Financial infoPurchase history, credit info❌ No❌ No
Health and fitnessHealth, fitness❌ No❌ No
MessagesEmails, SMS, other messages❌ No❌ No
Photos and videosPhotos, videos❌ No❌ No
AudioVoice recordings, music files❌ No❌ No
Files and docsFiles, docs❌ No❌ No
CalendarCalendar events❌ No❌ No
ContactsContacts❌ No❌ No
App activityApp interactions✅ Yes❌ NoSession counts, engagement time, feature usage
App info and performanceDiagnostics✅ Yes❌ NoApp version, SDK version, OS, device model
Device or other IDsDevice or other IDs✅ Yes❌ NoAnonymous randomly generated user ID (not a device identifier)

Is this data processed ephemerally?No — data is persisted locally and retained server-side for 30 days.

Is this data collection required or can users opt out? → Data collection is required for the SDK to function (configuration optimization). App developers may optionally call ClearData() to reset user data.

Why is this data collected? → Select Analytics and App functionality.

For all data types, answer No to data sharing — Hyperstone does not share data with third parties.

Is data encrypted in transit?Yes — All SDK communication uses HTTPS.

Can users request data deletion?Yes — App developers can delete all app data from the Hyperstone Console, and users’ local data can be cleared with ClearData().

AspectDetails
PII collectedNone
Ad identifiersNot collected
Device identifiersNot collected
User IDRandomly generated, anonymous, non-correlatable
Transport securityHTTPS
IP handlingAnonymized before geo lookup, never stored
Server data retention7-day TTL from last activity
Third-party sharingNone
ATT requiredNo
Local data resetHyperstone.ClearData()
Server data deletionAvailable from Hyperstone Console