dependencies {	 	
dependencies {
    implementation name:'youappi-sdk-android-moat', ext:'aar'	 	    implementation name:'youappi-sdk-android-moat', ext:'aar'
    implementation 'com.google.code.gson:gson:2.6'	 	    implementation 'com.google.code.gson:gson:2.6'
}
	 	}

<uses-permission android:name="android.permission.INTERNET"/>	 	
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>	 	<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>	 	<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
	 	<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

dependencies {	 	
dependencies {
     implementation "com.youappi.sdk:youappi-sdk-android-moat:4.3.10"	 	     implementation "com.youappi.sdk:youappi-sdk-android-moat:4.3.10"
}
	 	}

import android.app.Application;	 	
import android.app.Application;
import com.youappi.sdk.YouAPPi;	 	import com.youappi.sdk.YouAPPi;
            	 	            
public class YouAppApplication extends Application {	 	public class YouAppApplication extends Application {
                	 	                
      private static final String DEMO_TOKEN = "<YOUR_APP_TOKEN>;	 	      private static final String DEMO_TOKEN = "<YOUR_APP_TOKEN>;
 	 	 
      @Override	 	      @Override
      public void onCreate() {	 	      public void onCreate() {
            super.onCreate();	 	            super.onCreate();
 	 	 
           YouAPPi.init(this, DEMO_TOKEN, userConsent);	 	           YouAPPi.init(this, DEMO_TOKEN, userConsent);
      }	 	      }
}	 	}

	 	

<?xml version="1.0" encoding="utf-8"?>	 	
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"	 	<manifest xmlns:android="http://schemas.android.com/apk/res/android"
 package="com.youappi.sdk.demo">	 	 package="com.youappi.sdk.demo">
 <application	 	 <application
 android:name = ".YouAppApplication"	 	 android:name = ".YouAppApplication"
 android:allowBackup="true"	 	 android:allowBackup="true"
 android:icon="@mipmap/ic_launcher"	 	 android:icon="@mipmap/ic_launcher"
 android:label="@string/app_name"	 	 android:label="@string/app_name"
 ...	 	 ...
 ...	 	 ...
 </application>	 	 </application>
</manifest>
	 	</manifest>

YARewardedVideoAd rewardedVideoAd = YouAPPi.getInstance().rewardedVideoAd("test_rewarded_video_ad");	 	
YARewardedVideoAd rewardedVideoAd = YouAPPi.getInstance().rewardedVideoAd("test_rewarded_video_ad");
YAInterstitialVideoAd interstitialVideoAd = YouAPPi.getInstance().interstitialVideoAd("test_interstitial_ad");	 	YAInterstitialVideoAd interstitialVideoAd = YouAPPi.getInstance().interstitialVideoAd("test_interstitial_ad");
YAInterstitialAd interstitialAd = YouAPPi.getInstance().interstitialAd("test_interstitial_ad");
	 	YAInterstitialAd interstitialAd = YouAPPi.getInstance().interstitialAd("test_interstitial_ad");

• Load an ad (for example, a rewarded video ad):

  Load an ad (for example, a rewarded video ad):

  rewardedVideoAd.load();

  rewardedVideoAd.load();

• Show an ad:

  Show an ad:

  rewardedVideoAd.show();

  rewardedVideoAd.show();

Custom parameters and server-to-server callback (optional)

Custom parameters and server-to-server callback (optional)

YouAppi SDK supports customer parameters and server-to-server callback. Custom parameters could be passed during the ad request and received upon user’s completion event as a part of the callback string (server-to-server completion callback).

YouAppi SDK supports customer parameters and server-to-server callback. Custom parameters could be passed during the ad request and received upon user’s completion event as a part of the callback string (server-to-server completion callback).

Callback URL example:

Callback URL example:
http://www.app.com?appUserId={user_id}&RewardValue={reward_value}&RewardType={reward_type}&RewardId={reward_id}&DynamicUserId={dynamicUserId}

http://www.app.com?appUserId={user_id}&RewardValue={reward_value}&RewardType={reward_type}&RewardId={reward_id}&DynamicUserId={dynamicUserId}

You can use YAAdRequest object to add custom parameters as <key, value> to your ad request before loading an ad: You can use YAAdRequest object to add custom parameters as <key, value> to your ad request before loading an ad:

YaAdRequest adRequest = new YAAdRequest();	 	
YaAdRequest adRequest = new YAAdRequest();
adRequest.addCustomParam("param_key", "param_value");	 	adRequest.addCustomParam("param_key", "param_value");
rewardedVideoAd.setAdRequest(adRequest);
	 	rewardedVideoAd.setAdRequest(adRequest);

YouAPPi.getInstance().setDynamicUserId("best_user_ever");

YouAPPi.getInstance().setDynamicUserId("best_user_ever");

YAAdRequest adRequest = new YAAdRequest()	 	
YAAdRequest adRequest = new YAAdRequest()
 .setGender(YAAdRequest.Gender.Female)	 	 .setGender(YAAdRequest.Gender.Female)
 .setAge("40");
	 	 .setAge("40");
Implementation example for Rewarded Video
Implementation example for Rewarded Video
Please note: this example is for rewarded video. Other products work in a similar way.	 	Please note: this example is for rewarded video. Other products work in a similar way.


Create a rewarded video instance:
Create a rewarded video instance:






YARewardedVideoAd rewardedVideoAd = YouAPPi.getInstance().rewardedVideoAd("test_rewarded_video_ad");
YARewardedVideoAd rewardedVideoAd = YouAPPi.getInstance().rewardedVideoAd("test_rewarded_video_ad");

rewardedVideoAd.setRewardedVideoAdListener(new YARewardedVideoAd.RewardedVideoAdListener() {	 	
rewardedVideoAd.setRewardedVideoAdListener(new YARewardedVideoAd.RewardedVideoAdListener() {
            @Override	 	            @Override
            public void onRewarded(String s) {	 	            public void onRewarded(String s) {
                	 	                
            }	 	            }
 	 	 
            @Override	 	            @Override
            public void onVideoStart(String s) {	 	            public void onVideoStart(String s) {
 	 	 
            }	 	            }
 	 	 
            @Override	 	            @Override
            public void onVideoEnd(String s) {	 	            public void onVideoEnd(String s) {
 	 	 
            }	 	            }
 	 	 
            @Override	 	            @Override
            public void onVideoSkipped(String s, int i) {	 	            public void onVideoSkipped(String s, int i) {
 	 	 
            }	 	            }
 	 	 
            @Override	 	            @Override
            public void onCardShow(String s) {	 	            public void onCardShow(String s) {
 	 	 
            }	 	            }
 	 	 
            @Override	 	            @Override
            public void onCardClose(String s) {	 	            public void onCardClose(String s) {
 	 	 
            }	 	            }
 	 	 
            @Override	 	            @Override
            public void onCardClick(String s) {	 	            public void onCardClick(String s) {
 	 	 
            }	 	            }
 	 	 
            @Override	 	            @Override
            public void onLoadSuccess(String s) {	 	            public void onLoadSuccess(String s) {
 	 	 
            }	 	            }
 	 	 
            @Override	 	            @Override
            public void onLoadFailure(String s, YAErrorCode yaErrorCode, Exception e) {	 	            public void onLoadFailure(String s, YAErrorCode yaErrorCode, Exception e) {
 	 	 
            }	 	            }
 	 	 
            @Override	 	            @Override
            public void onShowFailure(String s, YAErrorCode yaErrorCode, Exception e) {	 	            public void onShowFailure(String s, YAErrorCode yaErrorCode, Exception e) {
 	 	 
            }	 	            }
 	 	 
            @Override	 	            @Override
            public void onAdStarted(String s) {	 	            public void onAdStarted(String s) {
 	 	 
            }	 	            }
 	 	 
            @Override	 	            @Override
            public void onAdEnded(String s) {	 	            public void onAdEnded(String s) {
 	 	 
            }	 	            }
        });
	 	        });

YAAdRequest adRequest = new YAAdRequest()	 	
YAAdRequest adRequest = new YAAdRequest()
 .addCustomParam("user_id", "user100")	 	 .addCustomParam("user_id", "user100")
 .addCustomParam("reward_value", "25")	 	 .addCustomParam("reward_value", "25")
 .addCustomParam("reward_type", "coins")	 	 .addCustomParam("reward_type", "coins")
 .setGender(YAAdRequest.Gender.Female)	 	 .setGender(YAAdRequest.Gender.Female)
 .setAge("40");	 	 .setAge("40");
rewardedVideo.setAdRequest(adRequest);	 	rewardedVideo.setAdRequest(adRequest);
rewardedVideoAd.load();
	 	rewardedVideoAd.load();

YouAPPi.getInstance().setDynamicUserId("best_user_ever");	 	
YouAPPi.getInstance().setDynamicUserId("best_user_ever");
rewardedVideoAd.show();
	 	rewardedVideoAd.show();

rewardedVideoAd.isAvailable();

rewardedVideoAd.isAvailable();

-keep class com.google.gson.**{ *;}	 	
-keep class com.google.gson.**{ *;}
-keep class com.google.android.gms.**{*;}	 	-keep class com.google.android.gms.**{*;}
-keep class com.youappi.sdk.**{*;}	 	-keep class com.youappi.sdk.**{*;}
-keep interface com.youappi.sdk.**{*;}	 	-keep interface com.youappi.sdk.**{*;}
-keep enum com.youappi.sdk.**{*;}	 	-keep enum com.youappi.sdk.**{*;}
-keepclassmembers class * {	 	-keepclassmembers class * {
   @android.webkit.JavascriptInterface <methods>;	 	   @android.webkit.JavascriptInterface <methods>;
}
	 	}

Android App Bundle

Android App Bundle

In order to upload your app’s compiled code and resources to Google Play using Android App Bundle without generating APK, exclude Android Manifest from the package options of your build.gradle: In order to upload your app’s compiled code and resources to Google Play using Android App Bundle without generating APK, exclude Android Manifest from the package options of your build.gradle:

packagingOptions {	 	
packagingOptions {
 exclude 'AndroidManifest.xml'	 	 exclude 'AndroidManifest.xml'
}
	 	}
User’s Private Information
User’s Private Information
For providing more relevant ads according to user’s interests YouAppi collects user’s installed packages information. By default, the user’s explicit consent flag value is ‘false’. By choosing ‘true’ you allow YouAppi to collect this information which helps us to optimise yield and raise eCPM. Make sure to post a privacy policy in both the designated field in the Play Developer Console and from within the Play distributed app itself to avoid violation of Google’s Developer Distribution Agreement.	 	For providing more relevant ads according to user’s interests YouAppi collects user’s installed packages information. By default, the user’s explicit consent flag value is ‘false’. By choosing ‘true’ you allow YouAppi to collect this information which helps us to optimise yield and raise eCPM. Make sure to post a privacy policy in both the designated field in the Play Developer Console and from within the Play distributed app itself to avoid violation of Google’s Developer Distribution Agreement.

User’s explicit consent can be set the following way:	 	User’s explicit consent can be set the following way:
YouAPPi.getInstance().sendApps(true);
YouAPPi.getInstance().sendApps(true);
GDPR User’s Consent
GDPR User’s Consent
The userConsent flag  value should be determined by the app developer according to the User’s response to a Consent Request and according to the user being subject to the GDPR rules (e.g.: an EU residence). The userConsent flag value signals to YouAppi the permission to process and store the user’s Personal Information (e.g.: Advertising ID and IP address). In case that the flag value is false, YouAppi may decide not to respond to the ad request, since the user cannot be detected and his actions cannot be attributed to the user and hence also to YouAppi and to the app developer.	 	The userConsent flag  value should be determined by the app developer according to the User’s response to a Consent Request and according to the user being subject to the GDPR rules (e.g.: an EU residence). The userConsent flag value signals to YouAppi the permission to process and store the user’s Personal Information (e.g.: Advertising ID and IP address). In case that the flag value is false, YouAppi may decide not to respond to the ad request, since the user cannot be detected and his actions cannot be attributed to the user and hence also to YouAppi and to the app developer.

GDPR user consent can be passed in the following ways:	 	GDPR user consent can be passed in the following ways:


It is mandatory to pass user consent in SDK init:
It is mandatory to pass user consent in SDK init:


YouAPPi.init(context, "<YOUR_APP_TOKEN>", userConsent);
YouAPPi.init(context, "<YOUR_APP_TOKEN>", userConsent);


User’s consent can be set by using:
User’s consent can be set by using:


YouAPPi.getInstance().setUserConsent(userConsent);
YouAPPi.getInstance().setUserConsent(true);


If the user is known to be in an age restricted class (e.g.: under the age of 16 in some countries or under the age of 13 in other countries ) then the age restricted indication should be passed:
If the user is known to be in an age restricted class (e.g.: under the age of 16 in some countries or under the age of 13 in other countries ) then the age restricted indication should be passed:


YouAPPi.getInstance().setAgeRestrictedUser(ageRestrictedUser);
YouAPPi.getInstance().setAgeRestrictedUser(true);
Logging and troubleshooting
Logging and troubleshooting
After initializing the SDK you can set LogListener to get detailed log events from YouAppi’s SDK:	 	After initializing the SDK you can set LogListener to get detailed log events from YouAppi’s SDK:






YouAPPi.getInstance().setLogListener(new Logger.LogListener()	 	
YouAPPi.getInstance().setLogListener(new Logger.LogListener()
   {	 	   {
       @Override	 	       @Override
       public void log(String tag, String message)	 	       public void log(String tag, String message)
       {	 	       {
           // This will be called each time YouAppi SDK generates a log message.	 	           // This will be called each time YouAppi SDK generates a log message.
       }	 	       }
   });
	 	   });




Load and Show best practices
Load and Show best practices


Make sure to init the SDK as soon as the app starts. It might take few seconds to complete the init process.
Make sure to init the SDK as soon as the app starts. It might take few seconds to complete the init process.
Make sure to load the ad about 30 seconds before you want to show it since it takes time for the ad and assets to be prepared.
Make sure to load the ad about 30 seconds before you want to show it since it takes time for the ad and assets to be prepared.
Make sure to show an ad as close as possible to its load, in order to have a better fill rate and relevant ads.
Make sure to show an ad as close as possible to its load, in order to have a better fill rate and relevant ads.
Make sure not to wait too long before showing an ad, since the ad will be expired 5 hours after being called for. In other words, “show” must be performed no more than 5 hours after the “load”.
Make sure not to wait too long before showing an ad, since the ad will be expired 5 hours after being called for. In other words, “show” must be performed no more than 5 hours after the “load”.
Use ad event listeners in order to be notified when an ad is ready to be shown.
Use ad event listeners in order to be notified when an ad is ready to be shown.
Use ad event listeners to handle load and show.
Use ad event listeners to handle load and show.
Loading an ad too many times without showing it might cause YouAppi servers to block the SDK from requests.
Loading an ad too many times without showing it might cause YouAppi servers to block the SDK from requests.


Demo App
Demo App
A demo app showing a simple usage of the SDK can be found in the following Github repository:	 	A demo app showing a simple usage of the SDK can be found in the following Github repository:

https://github.com/YouAppi/youappi-sdk-android-demo	 	https://github.com/YouAppi/youappi-sdk-android-demo

The demo app contains 4 modules:	 	The demo app contains 4 modules:


app-demo – Shows how to use YouAppi’s SDK
app-demo – Shows how to use YouAppi’s SDK
app-demo-admob – Shows how to use YouAppi’s SDK with AdMob adapter
app-demo-admob – Shows how to use YouAppi’s SDK with AdMob adapter
app-demo-mopub – Shows how to use YouAppi’s SDK with MoPub adapter
app-demo-mopub – Shows how to use YouAppi’s SDK with MoPub adapter
app-demo-nativeads – Shows how to use YouAppi’s SDK Native Ads
app-demo-nativeads – Shows how to use YouAppi’s SDK Native Ads


Please make sure to read the README.md file for further instructions.	 	Please make sure to read the README.md file for further instructions.