Identifying Your Users

With Sauce Mobile App Distribution's user identification feature, you can enhance your testing and debugging process by efficiently correlating session recordings with specific users and their traits. This capability empowers you to gain deeper insights into how different users interact with your app and aids in the diagnosis of user-specific issues during testing.

Example Configuration

Below are code examples illustrating how to utilize Sauce Mobile App Distribution's setUserId method on various platforms:

Android

TestFairy.setUserId("<userId>");

Example

// Be sure to import Sauce Mobile App Distribution
import com.testfairy.TestFairy;

TestFairy.setUserId("john@example.com");

iOS

[TestFairy setUserId:@"<userId>"];

Example

// Be sure to import Sauce Mobile App Distribution
#import "TestFairy.h"

[TestFairy setUserId:@"john@example.com"];

Cordova

TestFairy.setUserId("<userId>");

Example

TestFairy.setUserId("john@example.com");

React Native

TestFairy.setUserId("<userId>");

Example

// Be sure to import Sauce Mobile App Distribution
const TestFairy = require('react-native-testfairy');

TestFairy.setUserId("john@example.com");

Nativescript

TestFairySDK.setUserId("<userId>");

Example

// Be sure to import Sauce Mobile App Distribution
import { TestFairySDK } from 'nativescript-testfairy';

TestFairySDK.setUserId("john@example.com");

Xamarin

TestFairy.SetUserId ("<userId>");

Example

// Be sure to import Sauce Mobile App Distribution
using TestFairyLib;

TestFairy.SetUserId ("john@example.com");

Unity

TestFairy.setUserId("<userId>");

Example

// Be sure to import Sauce Mobile App Distribution
using TestFairyUnity;

TestFairy.setUserId("john@example.com");

Adobe Air

AirTestFairy.setUserId("<userId>");

Example

// Be sure to import Sauce Mobile App Distribution
import com.testfairy.AirTestFairy;

AirTestFairy.setUserId("john@example.com");

Titanium

TiTestFairy.setUserId("<userId>");

Example

// Be sure to import Sauce Mobile App Distribution
var TiTestFairy = require('com.testfairy.titestfairy');

TiTestFairy.setUserId("john@example.com");

Where userId is a string representing an association to your backend. We recommend passing values such as email, phone number, or user ID your app may use. This value may not be nil and is searchable via API and web search.

Important Notes

To make the most effective use of Sauce Mobile App Distribution's user identification feature, it's essential to keep in mind the following important notes:

• The setUserId method can be called multiple times to update the user identifier for different sessions.
• You can call setUserId before or after initializing a session with begin.
• The user identifier you provide must not be null and should be chosen from user attributes like email, phone number, or user ID.
• The user identifier you set using setUserId() will be searchable through the Sauce Mobile App Distribution API and web search interface.