Initializing the AppsPrize SDK

Call initialize(Context,AppsPrizeConfig,AppsPrizeListener) from your Application class. When it finishes you are notified through the AppsPrizeListener, via either onInitialize or onInitializedFailed, depending on the result.

public class MainApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        AppsPrizeConfig config = new AppsPrizeConfig.Builder()
                .build(APPS_PRIZE_APP_TOKEN, ADVERTISING_ID, USER_ID);

        AppsPrize.initialize(getApplicationContext(), config, new AppsPrizeListener() {
            @Override
            public void onInitialize() {
                Log.d("[AppsPrize]", "MainApplication:onCreate AppsPrize:onInitialize");
            }

            @Override
            public void onInitializeFailed(@NonNull String errorMessage) {
                Log.d("[AppsPrize]", "MainApplication:onCreate AppsPrize:onInitializeFailed: err: " + errorMessage);
            }

            @Override
            public void onRewardUpdate(@NonNull List<AppReward> rewards) {
                Log.d("[AppsPrize]", "MainApplication:onCreate AppsPrize:onRewardUpdate: " + rewards);
            }
          
            @Override
            public void onNotification(@NonNull List<AppsPrizeNotification> notifications) {
                Log.d("[AppsPrize]", "MainApplication:onCreate AppsPrize:onNotification: " + notifications);
            }
        });
    }
}

class MainApplication : Application() {

    override fun onCreate() {
        super.onCreate()

        val config = AppsPrizeConfig.Builder()
            .build(APPS_PRIZE_APP_TOKEN, ADVERTISING_ID, USER_ID)
        AppsPrize.initialize(applicationContext, config, object : AppsPrizeListener {
            override fun onInitialize() {
                Log.d("[AppsPrize]", "MainApplication:onCreate AppsPrize:onInitialize")
            }

            override fun onInitializeFailed(errorMessage: String) {
                Log.d("[AppsPrize]", "MainApplication:onCreate AppsPrize:onInitializeFailed: err: $errorMessage")
            }

            override fun onRewardUpdate(rewards: List<AppReward>) {
                Log.d("[AppsPrize]", "MainApplication:onCreate AppsPrize:onRewardUpdate: $rewards")
            }
            
            override fun onNotification(notifications: List<AppsPrizeNotification>) {
                Log.d("[AppsPrize]", "MainApplication:onCreate AppsPrize:onNotification: $notifications")
            }
        })
    }
}

The parameters are:

• Context: Your application's context.
• AppsPrizeConfig: An object to pass additional options to the AppsPrize SDK when initializing. This parameter is a must and you can call initialize(Context, AppsPrizeConfig) or initialize(Context, AppsPrizeConfig, AppsPrizeListener) instead.
• AppsPrizeListener: A listener which informs you about whether the AppsPrize Playtime SDK was initialized successfully or not. This parameter is optional and you can call initialize(Context,AppsPrizeConfig) or initialize(Context, AppsPrizeConfig, AppsPrizeConfig) instead.

AppsPrizeConfig

data class AppsPrizeConfig

This class holds the configuration information of AppsPrize.

build

fun build(token: String, advertisingId: String, userId: String): AppsPrizeConfig

Builds an AppsPrizeConfig from the current properties and returns the instance.

• token: AppsPrize token provided once you sign up and add your app to dashboard (dashboard.appsprize.com).
• advertisingId: Google advertising id from device.
• userId: App unique user ID

setCountry and setLanguage

 val config = AppsPrizeConfig.Builder()
	 .setCountry("ES") 
   .setLanguage("es")

User profile

Collecting a user profile matters, because it is how offers get targeted to the right people. We use gender, age, UA channel, UA network and ad placement for segmentation.

Gender

setGender(gender: String?)

Age

setAge(age: Int?)

UA Channel

setUaChannel(uaChannel: String?)

UA Network

setUaNetwork(uaNetwork: String?)

Ad Placement

setAdPlacement(adPlacement: String?)

AppsPrizeListener

interface AppsPrizeListener

This interface notifies your application when an AppsPrize event occurs.

onInitialize

open fun onInitialize()

Tells you that AppsPrize initialization completed.

onInitializedFailed

open fun onInitializeFailed(errorMessage: String)

Tells you that AppsPrize initialization failed to complete. errorMessage carries the reason for the failure.

onRewardUpdate

open fun onRewardUpdate(rewards: List<AppReward>)

Tells you the user completed one or more rewards in a session. rewards is the list of rewards they earned.

onNotification

open fun onNotification(notifications: List<AppsPrizeNotification>)

Tells you about the user's current notifications, such as receiving rewards or a prompt to open the SDK. notifications is the list of current notifications.

Call AppsPrize.init(Config) as your app starts. When it finishes you are notified through AppsPrize.init's onInitialize or onInitializedFailed, depending on the result.

onRewardUpdate tells you that the user has completed one or multiple rewards in a session.

const appsPrizeConfig: AppsPrizeConfig = {
    /// The token used for authentication.
    token: "token";

    // The advertising identifier used for tracking.
    advertisingId: "adId";

    // The user identifier.
    userId: "userId";

    // The country associated with the user.
    country: "UK";

    // The language preference of the user.
    language: "en";
  
    //User Profile for better targeting.
    gender: "gender",
    age: 30,
    uaChannel: "uaChannel",
    uaNetwork: "uaNetwork",
    adPlacement: "adPlacement",

    // (Optional) The styling configuration for UI customization.
    style: AppsPrizeStyleConfig;
}

AppsPrize.init(config, {
  onInitialize: (event) => {
    console.log("AppsPrize:TS:onInitialize")
  },
  onInitializeFailed: (event) => {
    console.log(`AppsPrize:TS:onInitializeFailed:${JSON.stringify(event)}`)
  },
  onRewardUpdate: (event) => {
    console.log(`AppsPrize:TS:onRewardUpdate:${JSON.stringify(event)}`)
  },
  onNotification: (event) => {
    console.log(`AppsPrize:TS:onNotification:${JSON.stringify(event)}`)
  },
})

The config object takes these parameters:

• String token: The SDK token that you can take it from the dashboard once you add your app.
• String userId: A custom user identifier that you give to your users. With the help of this ID, we will match the payouts to your users and inform you by server-to-server payout method.

Call AppsPrize.Initialize as your app starts. When it finishes you are notified through AppsPrize.Initialize's OnInitialize or OnInitializedFailed, depending on the result.

OnRewardUpdate tells you that the user has completed one or multiple rewards in a session.

new AppsPrizeConfig(
        token: TOKEN,
        advertisingId: AD_ID,
        userId: USER_ID,
        country: "US",
        language: "en",
        // User Profile for better targeting.
        gender: "MALE",
        age: 30,
        uaChannel: "uaChannel",
        uaNetwork: "uaNetwork",
        adPlacement: "adPlacement",
        new AppsPrizeStyleConfig(
            primaryColor: Color.blue,
            secondaryColor: Color.black,
            highlightColor: Color.green,
            offersTitleText: "Test Offer",
            appsTitleText: "Test Apps"
        )
    )

The config object takes these parameters:

• String token: The SDK token that you can take it from the dashboard once you add your app.
• String userId: A custom user identifier that you give to your users. With the help of this ID, we will match the payouts to your users and inform you by server-to-server payout method.

Setting up AppsprizeListener

public class AppsPrizeCustomListener : IAppsPrizeListener {
//...
    public void OnInitialize()
    {
        Debug.Log("[AppsPrize-Unity]: OnInitialize");
    }

    public void OnInitializeFailed(string errorMessage)
    {
        Debug.Log("[AppsPrize-Unity]: OnInitializeFailed");
    }

    public void OnRewardUpdate(List<AppRewards> rewards)
    {
        Debug.Log("[AppsPrize-Unity]: OnRewardUpdate: " + rewards.ToString());
    }
  
    public void OnNotification(List<AppsPrizeNotification> notifications)
    {
        Debug.Log("[AppsPrize-Unity]: OnNotification: " + notifications.ToString());
    }
//...
}

//...
AppsPrize.Initialize(
    appsPrizeConfig,
    new AppsPrizeCustomListener()
);
//...