Documentation

Here you will find all the info you need to integrate the various monetization tools OfferToro has to offer.

Android SDK

SDK version 3.1.10
Updated: Nov 10, 2017

7. VideoLab

VideoLab allows your users to get rewarded for watching videos and content 24/7.
Each 10-15 minutes being watched rewards your user once, at which point - a new session start automatically.

Currently, VideoLab is only available for users from United States. We advice not to display it to users from other countries.

For further details, please contact your account manager.

  • Step 1. Initialize the SDK

    In order to initialize Videolab, the following parameters should be passed in the initialization call: secret key, app id and user id.

    The call should look similar to:

    public static final String YOUR_VL_SECRET_KEY = ""; //set your value
    public static final String YOUR_VL_APP_ID = ""; //set your value
    public static final String YOUR_VL_USER_ID = ""; //set your value
    
    Videolab.getInstance().init(YOUR_VL_APP_ID, YOUR_VL_SECRET_KEY, YOUR_VL_USER_ID);

    NOTES:

    - APPID and SECRET_KEY can be found in your OfferToro account, under your "App Placement" settings.

    - UserID, is a parameter which should be passed from your end as an id for each end user of your app. A common practice is to use the Google Advertising ID (GAID) .

    - If you are using OfferWall and want this activity working there, please follow the OfferWall documentation how to implement (via initializing and implementing listeners if needed), otherwise VideoLab offers will be showing in a separate OS webview as it always was earlier.

    Step 2. Create OfferToro SDK instance

    OfferToro SDK instances should be created in the activity by calling the following method:

    OffersInit.getInstance().create(this);

    Step 3. Implement Videolab listeners

    The Videolab module gives a possibility to be notified of events happening in Videolab lifecycle via listeners.

    The following listeners are available:

    onOTVideolabSessionCreateSuccess(int completion) - invoked when Videolab is successfully initialized and the user has successfully created a Videolab session. The (@param completion) is a number between 0 and 100 indicating last saved point in previous session;

    onOTVideolabSessionCreateFail() - invoked when user failed to create a Videolab session;

    onOTVideolabSessionFulfill(int completion) - notify how far the user is from completion;

    onOTVideolabSessionCompleted() - invoked when a user successfully completed one Videolab session, and should be rewarded.

    onOTVideolabFatalError(int errorCode, String errorMessage) - invoked when Videolab encounters a fatal error (@param errorMessage) that requires the attention of a higher level program to rectify the problem;

    onOTVideolabLog(String message) - invoked periodically with verbose messages (@param message);

    To be notified of Videolab events, setVideolabListener(VideolabListener listener) method should be called:

    OffersInit.getInstance().setVideolabListener(VideolabListener listener);

    Please also take a look at the short guide and the sample of listeners implementation.

    Step 4. Display Videolab

    After being successfully initialized, Videolab could be displayed into the app.

    For displaying Videolab, showVideolab() method should be called:

    OffersInit.getInstance().showVideolab(activity);

    Step 5. Reward the User

    OfferToro SDK supports two ways to reward your users. Those are:

    • 1. Client-side postback
    • 2. Server-to-Server postback

    Client-side postback

    To get notified on VideoLab session completions, use the onOTVideolabSessionCompleted() listener as explained in section 3.

    Server-to-Server postback

    Server to Server postbacks is a more secured way to receive notifications, in order to rewarded your users.
    To receive Server to Server postbacks, you must define your postback URL in your App Placement under your OfferToro account
    For more information - Please check this page: