Set up User Reporting
Integrate the User Reporting SDK with your app to set up user reports. Once integrated, you can use the built-in user report prefab, or create your own custom user reports without the prefab.
Note: Before you integrate User reports with your project, make sure you set up your project for Unity Services. Your project must be in the Editor to the Dashboard with a project ID. See Setting up your project for Unity Services.
To add the built-in example User Reporting Prefab to your project:
- Open the Package Manager in the Editor, then locate the User Reporting package and select the Samples tab.
- Locate the User Reporting Example, and select Import.
- In your project, add the User Reporting Prefab to the desired scene.
- In your Assets folder, open Samples and select the User Reporting folder.
- Open the folder titled with the package version you installed (for example, 1.0.0).
- Open the User Reporting Example folder.
- Drag and drop the UserReportFormExample prefab into your scene.
Set up notifications for new reports
User Reporting supports new report notifications via Integrations so you can connect your development workflow to non-Unity tools. Receive a notification via third-party integrations such as email, Slack, Discord, Trello, and more.
To set up notifications:
- Open the Unity Cloud Dashboard.
- Select your desired project from the project selector on the top menu. Note: Make sure you’ve added and enabled User Reporting for the project before setting up report notifications.
- From the main menu, select Projects.
- Select Project Settings > Integrations.
- Select New Integration and follow the instructions in the dialog for the integration you want to use.
Test reports and notifications
The sample scene is an effective tool for confirming whether or not your User Reporting has been set up correctly. In this example, we’ll optionally include a test of the email notification integration for new reports.
To set up email notifications (optional):
- Open the Unity Cloud Dashboard.
- Select your project from the top navigation menu. Note: Make sure you’ve added and enabled User Reporting for the project before setting up report notifications.
- Select Projects.
- Select Project Settings > Integrations.
- Select New Integration and follow the instructions in the dialog for Email integration. Enable the Report Received event option.
To test that reports are received:
- Open your Unity project.
- In your Assets folder, open Samples and select User Reporting.
- Locate the UserReportingExample.unity scene in the User Reporting Example folder.
- Start the scene. Click anywhere to spawn a cube in the scene, the select Create Report to open the submission form.
- Fill out the form and select Submit, and check the report is sent successfully.
- Open the Unity Cloud Dashboard.
- Select your project from the project selector on the top menu.
- Select Cloud Diagnostics > User Reporting.
- Wait a few minutes, then your report is visible on the dashboard. If you optionally set up an integration, you can see that the notification arrives close to the same time the report appears.