# Mobile SpotChecks

Configuring mobile-based SpotChecks can be accomplished in 4 simple steps.&#x20;

## **Installation**

This involves installing the necessary dependencies to implement the SpotChecks functionality in your application.

## **Initialization**

This involves adding required configurations such as specifying the targetToken, and domain name and inserting the component into all the necessary screens of your application. Below are the required properties to be set when initializing the SpotChecks.

* **userDetails** -> The properties here should be the same as the contact properties in SurveySparrow such as uuid, email, firstName, lastName, etc. This will ensure that a contact is being created in SurveySparrow.
  * You can provide either email, uuid, or mobile to act as a unique identifier.
* **domainName** -> The domain of your SurveySparrow account. For example, domain.surveysparrow.com.
* **targetToken** -> A token that is provided in the code snippet when creating a target.
* **customProperties** -> These are the user-defined key-value pairs that can act as additional information for triggering surveys.
* **sparrowLang** -> It allows the surveys to be displayed in the specified languages.
  * en -> English
  * hi -> Hindi
  * ml -> Malayalam
  * ta -> Tamil
  * te -> Telugu
* **variables** -> These are the global variables that are part of the survey. Make sure to use the **API identifier** of the global variable, which you will find when you are creating a variable
  *   While using variables of type "Date",  it is recommended to pass the value as a **String** in the following format -> **"yyyy-mm-dd" or "mm-dd-yyyy"**

      ![](https://1276128239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtGUy1ZRP5wQqzJV0uQav%2Fuploads%2FwYKd3MM7WgqQRF2V3GTz%2FScreenshot%202024-07-11%20at%2012.04.57%E2%80%AFPM.png?alt=media\&token=fa490d06-5033-449a-a765-2b812a91df22)

## **Screen Track**

This allows for specifying the screens in which the surveys should be displayed. It is required to create the screen in the SpotChecks configuration panel and paste the screen name here to track the respective screen. Tracking screens is required even if you choose "All screens" in the Spots section.

<figure><img src="https://1276128239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtGUy1ZRP5wQqzJV0uQav%2Fuploads%2FkCMeoAgt6hrNUKWZkEAZ%2FScreenshot%202024-06-13%20at%2010.27.54%E2%80%AFAM.png?alt=media&#x26;token=219234cf-db4c-4663-a302-4b2008bc3dc2" alt=""><figcaption></figcaption></figure>

## **Event Track**

It is necessary to add custom events while creating a mobile-based target in SpotChecks to display a survey, based on event triggers.

<figure><img src="https://1276128239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtGUy1ZRP5wQqzJV0uQav%2Fuploads%2FbuN7a8gFPEVQr8AftBcu%2FScreenshot%202024-05-31%20at%203.47.12%E2%80%AFPM.png?alt=media&#x26;token=2de59c14-8354-495d-9bfc-0e8c140cbe9a" alt=""><figcaption></figcaption></figure>

There is also an option to pass custom properties to the event triggers using which you can set conditions in the visitors section of the configure panel.

<figure><img src="https://1276128239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtGUy1ZRP5wQqzJV0uQav%2Fuploads%2FRl9gOcFGj2Yow4ADSFuX%2FScreenshot%202024-06-11%20at%2011.36.20%20AM.png?alt=media&#x26;token=c8c33f28-72f5-4c2a-869f-370ab397e1d8" alt=""><figcaption></figcaption></figure>



{% hint style="info" %}
**Note:**&#x20;

1. Voice Transcriptions within the **Text-Based Survey Questions** are unavailable for all mobile targets.
2. Question types namely **Photo Capture**, **Upload**, **Record Audio**, and **Signature** are not available in the Android Operating System.
{% endhint %}

Below is the SpotChecks setup guide for various tech stacks of a mobile application.
