Adjoe SDK

What is the adjoe SDK?

The adjoe SDK will allow you to integrate our "Playtime"-based offerwall format 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 our offerwall 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.

Term

Definition

SDK

Our code fragments you need to integrate in your app to earn money via the adjoe offerwall. 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.

Offerwall

The place in which we show our ads to your users. These ads are for other apps. The offerwall is displayed in a separate activity and can be launched via Adjoe.showOfferwall.

Partner App

An app advertised on our offerwall. 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 offerwall 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 adjoe offerwall in your app, for example: the different placements of the adjoe button via which users have accessed the offerwall, 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 the adjoe offerwall 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