Monetize your App with data

How to integrate our Android SDK

Prerequisites

• Your app has a minimum Android SDK level of 14 (Android 4+).
• Contact us to qualify for integration.
• You registered your app on App Management Dashboard, and you have its generated app ID.
• The app's status must be switched to ON.

Integrate the SDK library

1. Download and reference it, or put the following repository and dependency in your build.gradle:

   repositories {
       maven {
           url "http://dl.bintray.com/42matters/android"
       }
   }
   
   dependencies {
       implementation 'com.google.android.gms:play-services-ads:15.0.1'
       implementation 'com.core42matters.android:registrar:2.2.0@aar'
       ...
   }

2. If you use Proguard and your app does not use Google Play Services, add these line into your proguard-rules.pro

   -dontwarn com.google.android.gms.**

3. Call Registrar.init in the onCreate of your app's starting Activity.

   import com.core42matters.android.registrar.Registrar;
   ...
   
   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       ...
       Registrar.init(this, YOUR_APP_ID);
       ...
   }                    

   Replace YOUR_APP_ID with the app ID we generated for you in the App Management Dashboard.

4. Start up your app: you should see successful hits appearing in your App Management Dashboard.

5. Implement the User Consent and Opt-Out for users in your app. Please follow the documentation in the sections below.

6. After your integration is complete, please contact us for activating the monetization via our SDK and payout details.

User Consent

It's obligatory to inform your users and collect their consent (opt-in) before initializing our SDK. We support two ways for you to get consent from your users:

1) Default consent dialog

A default consent collecting dialog (opt-in) will be shown upon your first Registrar.init call.

Additionally, you also have to reference in a clear way our Privacy Policy in your own app's privacy policy.

2) Custom implementation

If you have implemented a consent dialog (opt-in) in your own way, you may call Registrar.setConsent before Registrar.init to prevent our default consent dialog from showing.

import com.core42matters.android.registrar.Registrar;
...

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    Registrar.setConsent(this, true);
    Registrar.init(this, YOUR_APP_ID);
    ...
}                    

If you use your custom implemented consent dialog it is also obligatory for you to clearly explain to your users which data is collected, its scope, and to whom and where you share/send this data. Additionally, you also have to reference in a clear way our Privacy Policy in your own app's privacy policy.

Opt-Out for users

You also need to provide a preference in the default shared preferences for users to opt-out at any time from the data collection. The consent status is saved under com.core42matters.android.registrar.user_consent as a boolean. Please use the XML code below to add our opt-out preference to your PreferenceActivity.

<SwitchPreference
    android:defaultValue="false"
    android:key="com.core42matters.android.registrar.user_consent"
    android:summary="Personalize your future advertising experience through 42matters AG"
    android:title="Personalize Your Experience" />