Test Users

Test users were built to allow Oculus development without a personal Facebook account and to test applications before release.

There are two options for developing Oculus apps: 1. a test user account or 2. your personal Facebook account. This documentation will help you set up with 1. using a test user account rather than your personal Facebook account. You can create a test user account with an Oculus Developer account, and then sign into your headset with that test user account.

Check out this Youtube video on test users for an overview and walkthrough of test user features.

A Facebook account is not required to create a Test User account. However, Test User accounts are automatically linked to a Facebook Test User account so you can test features that require a FB account. Test User accounts are not connected to your personal Facebook account. Because the Test User has a Facebook Test User account connected to it, data generated based on the Test User account activities will be used in accordance with the Supplemental Oculus Data Policy and Facebook Data Policy.


What Can You Do With Test Users?

You can create, search, delete, export Test Users to a CSV, and bulk friend test users on creation from the Developer Dashboard.

Test users:

  • Are automatically associated with the organization they are created with
  • Can test In-App Purchases (IAP) For more information about testing IAP, go to engine-specific documentation: Unity, Unreal, and Native
  • Can test Entitlement Checks when test users are added to a release channel For more information about testing Entitlement Checks, go to engine-specific documentation: Unity, Unreal, and Native
  • Are visible to other users in your application, but they cannot be friended
  • Are visible to users with admin or developer roles in the Developer Dashboard
  • Can test multiplayer functionality in games
  • Can be exported to a CSV file
  • Can be created with an Oculus Developer account and used in place of a personal Facebook account to sign in and develop on an Oculus headsets
  • Can playtest your app before release

Requirements For Working With Test Users

These steps must be completed prior to working with test users.


Create Test Users

Create test users in the Developer Dashboard.

  1. Navigate to an Org’s publishing page on the developer dashboard.
  2. Select Test Users under the Settings menu.
  3. Click the Add Test User button.
  4. Fill out the Create Test User form.
    • Username Prefix - Required - The prefix you choose will be used to generate a username.
      • For example, if you choose the prefix “testing,” we will generate a username like testing_a1b2c3 for your Test User account.
      • The prefix must be between 4-12 alphanumeric, underscore, or dot characters.
      • It cannot have consecutive special characters and cannot start or end with them.
      • We recommend not using personal identifying information for the Username Prefix.
    • Email Prefix - Required - This is the prefix for the email address that will be automatically generated for the Test User.
      • For example, if you choose “testing” as the prefix, we will generate an email address like testing_1xYz23@tfbnw.net for the Test User account.
      • The prefix must be between 4-10 alphanumeric, underscore, or dot characters.
      • It cannot have consecutive special characters and cannot start or end with them.
      • We recommend not using personal identifying information for the Email Prefix.
      • You will use this email address to log-in to your VR headset.
    • Password - Required - Must be at least 4 characters long.
      • Be sure to remember this, as it’s not visible on the dashboard.
      • You will need to use this password to log-in to your VR headset.
    • Pin - Optional - The PIN can be used for buying items in the Oculus Store. Must be 4 numeric characters long. Defaults to 1234 if nothing is entered.
    • Locale - Optional - If you don’t provide a locale, en_US will be used.
    • Country - Optional - If you don’t provide a country, US will be used.
    • User Count - Required - This count is the amount of Test Users that are created with these settings. An integer between 1 and 5. Defaults to one.
    • Inherit my organization entitlements - By default, new test users will inherit the test user owner developer Organization entitlements. This includes only app entitlements granted as a result of being part of the organization, and does not include other apps the test user creator has purchased, or any in-app purchases.
      • Clear Inherit my organization entitlements check box to not inherit developer app entitlements.
    • When creating multiple users, select “Friend test users with each other” checkbox to automatically make users friends.
  5. Click Submit to create the user.
  6. After you click Submit, information about the Test User will appear as an item in the Test Users table, including a random-generated “Name,” “Alias,” and “Email Address.”

Configure Test User App Entitlements

Test users can inherit the app entitlements from developers using the Configure Entitlements modal.

Note: Existing test users did not inherit the test user owner developer Organization entitlements by default.

  1. Navigate to Test Users in organization settings.
  2. Click the ellipses (...) menu on a test user.
  3. Click Configure Entitlements.
    • Select Inherit my organization entitlements check box to inherit test user owner developer Organization entitlements.
      • New test users automatically inherit the test user owner Organization developer entitlements.
    • Clear Inherit my organization entitlements check box will revoke developer app entitlements.
      • The test user doesn’t inherit the test user owner Organization developer entitlements.
      • If the test user has purchased an item, it will still be in their entitlements.

Log In to Oculus Device with a Test User Account

You must log in to the test user account on your headset.

May Require Factory Reset

If you were logged in with a personal account, the headset must be factory reset. This will take about 1 minute to complete.

.

  1. If you were logged in to the headset with a personal account, then factory reset your headset following the Oculus Support instructions.
  2. Select Log Out of Oculus app on your mobile device.
  3. Select Log In with test user account using the Oculus login.
  4. Enter 5 digit code from the headset to connect the headset with Oculus mobile app.

The headset is now connected to the test user account.


Add Apps to the Test User Library

Add apps to the test user’s library on the Oculus device they are using so the apps download to the Oculus device.

  1. Open the Oculus app on your phone.
  2. Navigate to the Store tab.
  3. Click Add to Library for the apps the test user needs access to.

Manage Test Users in the Developer Dashboard

Navigate to test users in the developer dashboard to manage test user settings:


Manage Test User Friends

The Manage Friends modal will return all test users in your org, not just test users that are owned by you.

  1. Navigate to Test Users in organization settings.
  2. Click the ellipses (...) menu on a test user.
  3. Click Manage Friends.
    • Users not connected will have an + Add Friend button that can be clicked to make Test Users friends.
    • Users already connected will have a green check mark with friends. Click the Friends button to unfriend users.

Manage Test User Friends 2


Revoke IAP Entitlements

Test user IAP entitlements can be revoked from the Revoke Entitlements window. This allows test user accounts to continue to test IAP. For more information about testing IAP, go to engine-specific documentation: Unity, Unreal, and Native

  1. Navigate to Test Users in organization settings.
  2. Click the ellipses (...) menu on a test user.
  3. Click Revoke IAP Entitlements.
  4. Click Submit.

Bulk Delete Test Users

  1. Navigate to Test Users in organization settings.
  2. Select multiple Test Users by clicking checkboxes.
  3. Click the drop-down and then Delete.

Bulk Delete Test Users


Export Test Users to a CSV File

Test users can be downloaded to a CSV file to easily manage test user data for an org. For example, test users must be added to release channels in order to test Entitlement Checks and In App Purchases. You can use this generated CSV to create a list of test users’ email addresses rather than adding them to the channel one by one.

  1. Navigate to Test Users in the organization settings.
  2. Select multiple Test Users by clicking checkboxes.
  3. Click the drop-down and then Export CSV. The file will automatically download to your browser.

FBID May Be Altered by CSV Software

The FBID may be incorrect due to rounding by the software used to open the CSV.

Bulk Delete Test Users