Play Store Privacy

If the user has consented to the collection of geolocation and the list of applications, the methods allowGeoLocation() allowAppList() should be called before the start() method, as shown in the example below:

@Override
public void onResume() {
super.onResume();
try {
    mBehavior.allowGeoLocation(); // Enables geolocation capture
    mBehavior.allowAppList(); //Enables the capture of information from applications installed on the device
    mBehavior.start(); //Initialization of information capture.
        
        String sessionId = mBehavior.generateSessionID();

        //Only on screens where you want to send the collected data to ClearSale
        mBehavior.collectDeviceInformation(sessionId); //Preferably after some user interaction time.
}
catch (CaptureWasStartedException e) {
        //This error occurs when the start() method was called more than once without using the stop() method.
        //Each capture (which starts with the start method) needs to be ended (with the stop method call)
    }
}
        

Behavior Class

Behavior is the class responsible for collecting information.

• Static Method

• Other Methods

Examples

There are two ways to initialize the SDK. This depends on the type of screen that will be used. If the screen is an Activity, initialization should be done in the onCreate() method. If it is a Fragment, initialization should be done in the onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) method.

Note: In both cases (Activity or Fragment), if the stop() method is not called within the onStop() method of one of the screens, since it is a singleton, the next screen when start() is called will throw the exception CaptureWasStartedException.

In all examples, the following variables are assumed to exist:

• mBehavior which represents the instance of the Behavior class. It can be replaced by Behavior.getInstance(context, CLEAR_SALE_APP).
• CLEAR_SALE_APP a string variable, the value of this variable must be provided by ClearSale.

To initialize the call when the screen is a Fragment.

@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container,
Bundle savedInstanceState) {
    // To get the Context in a Fragment.
    View rootView = inflater.inflate(R.layout.fragment_login, container, false);
    Context context = rootView.getContext();
    //CLEAR_SALE_APP is a unique identification value that must be provided by ClearSale.
    mBehavior = Behavior.getInstance(context, CLEAR_SALE_APP);
    return rootView;
}

When the screen is an Activity

@Override
public void onCreate() {
    //CLEAR_SALE_APP is a unique identification value that must be provided by ClearSale.
    mBehavior = Behavior.getInstance(this, CLEAR_SALE_APP);
}

To start the capture:

@Override
public void onResume() {
    super.onResume();
    try {
        mBehavior.start(); //Initialization of information capture.
        String sessionId = mBehavior.generateSessionID();
        //Only on screens where you want to send the collected data to ClearSale
        mBehavior.collectDeviceInformation(sessionId); //Preferably after some user interaction time.
    } catch (CaptureWasStartedException e) {
        //This indicates that the mBehavior.start() method has already been called previously and
        //the collection was not properly finalized using the mBehavior.stop() method.
    } catch (SessionIDAlreadyUsedException e) {
        //The same sessionId was used previously. The SessionID must be unique per collection.
    }
}

The methods start() and stop() should be implemented only on the screen where the information capture will be performed. The collectDeviceInformation(SESSION_ID) method should be called when you want to send the collected information to ClearSale, on the same screen where the previous methods were implemented.

Note: The collectDeviceInformation method must be called after the start() method has been executed.

We recommend that these methods be implemented on a "finalization" screen where there is user interaction for at least 3 seconds.

To end the capture:

@Override
public void onStop() {
    super.onStop();
    mBehavior.stop(); //Finalization of information capture.
}                         

Complete implementation example:

public class ExampleImplementationActivity extends AppCompatActivity {

    private Behavior mBehavior;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //CLEAR_SALE_APP is a unique identification value that must be provided by ClearSale.
        mBehavior = Behavior.getInstance(this, "CLEAR_SALE_APP");
    }

    @Override
    public void onResume() {
        super.onResume();
        try {
            mBehavior.start(); //Initialization of information capture.
            String sessionId = mBehavior.generateSessionID();

            //Only on the screen where you want to send the collected data to ClearSale
            mBehavior.collectDeviceInformation(sessionId); //Preferably after some user interaction time.
        } catch (CaptureWasStartedException e) {
            //This indicates that the mBehavior.start() method has already been called previously and
            //the collection was not properly finalized using the mBehavior.stop() method.
        } catch (SessionIDAlreadyUsedException e) {
            //The same sessionId was used previously. The SessionID must be unique per collection.
        }
    }

    @Override
    public void onStop() {
        super.onStop();
        mBehavior.stop(); //Finalization of information capture.
    }
}

FAQ

Click here to access our FAQ