Adjoe SDK
What is the adjoe SDK?
The adjoe SDK will allow you to integrate our ad formats into your app to monetize your reach easily and effectively.
"Playtime" is a unique advertising format, which rewards users for installing and continuously using apps from our advertising partners. Clicking on any ad displayed in the Playtime feed will bring the user to the Play Store. By playing this advertised app, users receive rewards in your app - the more they play, the more they earn! And, of course, you also earn money for every install generated through users of your app.
Glossary
This is a short list of terms that will occur in the documentation and which might be unfamiliar to you or which we might use in another way as you maybe know them.
SDK
Our code fragments you need to integrate in your app to earn money via adjoe's ad formats. This documentation guides you through the integration process.
SDK App
The app in which you integrate the adjoe SDK.
Sign-up Process
Before the user can use the adjoe SDK with all its functionalities, he has to sign up. This is a two-step process in which he has to accept adjoe's Terms of Service and allow your app to track his app usage. Only signed-up users (i.e. users who successfully completed both steps) can install partner apps and earn rewards.
Feed
The place in which we show our ads to your users. These ads are for other apps. Playtime is displayed in a separate activity and can be launched via Adjoe.showOfferwall
.
Partner App
An app advertised in Playtime. Users can earn rewards by installing and playing these apps and you earn money for every user install.
App Usage
adjoe rewards your users for the amount of time they use partner apps. For this to work, we need to be able to track the usage of the partner apps. Thus, the sign-up process includes a step in which the user can allow this in his phone settings. Once the user has spent enough time in another app, his app usage results in a reward payout. The amount of time required to reach a payout via a partner app can be individually defined per SDK app.
Reward
A virtual currency in your app which the user receives after continuously playing a partner app. Users qualify for rewards repeatedly after playing the partner app for specified amounts of time.
Payout
The process of redeeming the rewards. Once a reward is paid out, it cannot be paid out again.
Adjoe Parameters
These are flexible and unique user acquisition and Playtime placement parameters you can pass with many requests (as specified below). By passing this information to us, you can aggregate your statistics by these individual parameters when evaluating the performance of the Playtime in your app, for example: the different placements of the adjoe button via which users have accessed Playtime, and the UA source. You can pass any of these parameters (Network
, Channel
, SubPublisherCleartext
, SubPublisherEncrypted
or Placement
) independently. A brief description of each parameter is given below.
UA Network
The network which the user was acquired from, e.g. adwords, facebook, organic
UA Channel
The channel of the campaign in the network where the user was acquired, e.g. incent, video
UA Sub Publisher Encrypted
The encrypted package name or app id of the sub-publisher app in the network where the user was acquired.
UA Sub Publisher Cleartext
The cleartext package name of app id of the sub publisher app in the network where the user was acquired, e.g. com.domain.appName
Placement
The placement of Playtime inside your app, e.g. "Main Screen", "Shop", "Interstitial", "More Diamonds Screen", etc.
The UA Parameters and Placement Strings each have a maximum length of 64 characters.
Last updated