Unity CLI telemetry data
Review the data that the Unity command-line interface (CLI) sends to Unity and the project information that stays on your machine.
阅读时间2 分钟最后更新于 12 小时前
The Unity CLI sends three types of telemetry: an anonymous usage count, usage analytics, and crash reports. This page describes what each type contains and which project information never leaves your machine. To disable any of these data types, refer to Disable Unity CLI data collection.
Data types
The following table lists when the CLI sends each data type and what each data type includes. Each data type is separate, and you can disable each one independently.
Data type | Default setting | When data is sent | Data included | Data not included |
|---|---|---|---|---|
| Anonymous usage count | On | Once each time the CLI runs | The Unity tool that sent the event, the CLI version, the project's Unity version, and whether the CLI ran from a terminal, a continuous integration (CI) system, or an AI agent | Account, user, machine, or session identifiers; file paths; command arguments |
| Usage analytics | On | While the CLI runs | Command names (not their arguments or option values), outcomes and error codes, Unity and Editor versions, and an opaque project ID. If you're signed in, the CLI links this data to your Unity ID. | Project names, file paths, project contents, tokens, or credentials |
| Crash reports | On | Only when the CLI itself crashes | Technical details about the crash | Personal or project data. Before the CLI sends a report, it removes home directory paths, user account names, tokens, passwords, and URLs. |
First-run notice
The first time you run the CLI interactively, it displays the following one-time notice:
Unity CLI sends usage analytics and crash reports to help us improve it. To turn this off or learn more: https://docs.unity.com/en-us/unity-cli/data-collection-privacy-controls
Project information sent to Unity
The following table lists which project information the CLI sends to Unity. When you disable usage analytics, no information that identifies your project leaves your machine.
Information | Sent to Unity |
|---|---|
| Project name | No |
| File or folder paths | No |
| Project contents (scenes, assets, code) | No |
| Build target platform | No |
| Project's Unity version | Yes, in the anonymous usage count and in usage analytics |
| Project ID | Only while usage analytics is on, as an opaque ID |
If writes a build manifest, the manifest stays on your local disk. The CLI removes machine paths and credentials from the manifest.
unity build