adtrace_sdk_android | This is the Android SDK

Example Apps
Getting started Add the SDK to your project Add Google Play Services Add permissions Proguard settings Install referrer Google Play Referrer API Google Play Store intent
Integrate the SDK into your app Basic setup Native App SDK Web View SDK Session tracking API level 14 and higher API level between 9 and 13 SDK signature AdTrace logging Build your app
These are the minimal steps required to integrate the AdTrace SDK into your Android project. We are going to assume that you use Android Studio for your Android development and target an Android API level 9 (Gingerbread) or later.
For native use example-app-java
For web view use example-app-webbridge
Create a class that extends Application.
Open the AndroidManifest.xml file of your app and locate the <application> element.
Add the attribute android:name and set it to the name of your new application class pefixed by a dot. In our example app we use an Application class named GlobalApplication, so the manifest file is configured as: <application android:name=".GlobalApplication" <!-- ...--> </application>
In your Application class find or create the onCreate method and add the following code to initialize the AdTrace SDK: import io.adtrace.sdk.AdTrace; import io.adtrace.sdk.AdTraceConfig; public class GlobalApplication extends Application { @Override public void onCreate() { super.onCreate(); String appToken = "{YourAppToken}"; String environment = AdTraceConfig.ENVIRONMENT_SANDBOX; AdTraceConfig config = new AdTraceConfig(this, appToken, environment); AdTrace.onCreate(config); } }
Call webView.getSettings().setJavaScriptEnabled(true), to enable Javascript in the web view
Start the default instance of AdTraceBridgeInstance by calling AdTraceBridge.registerAndGetInstance(getApplication(), webView)
This will also register the AdTrace bridge as a Javascript Interface to the web view
Add a private class that implements the ActivityLifecycleCallbacks interface. If you don't have access to this interface, your app is targeting an Android API level inferior to 14. You will have to update manually each Activity by following these instructions. If you had AdTrace.onResume and AdTrace.onPause calls on each Activity of your app before, you should remove them.
Edit the onActivityResumed(Activity activity) method and add a call to AdTrace.onResume(). Edit the onActivityPaused(Activity activity) method and add a call to AdTrace.onPause().
Add on the onCreate() method where the AdTrace SDK is configured and add call registerActivityLifecycleCallbacks with an instance of the created ActivityLifecycleCallbacks class. import io.adtrace.sdk.AdTrace; import io.adtrace.sdk.AdTraceConfig; public class GlobalApplication extends Application { @Override public void onCreate() { super.onCreate(); String appToken = "{YourAppToken}"; String environment = AdTraceConfig.ENVIRONMENT_SANDBOX; AdTraceConfig config = new AdTraceConfig(this, appToken, environment); AdTrace.onCreate(config); registerActivityLifecycleCallbacks(new AdTraceLifecycleCallbacks()); //... } private static final class AdTraceLifecycleCallbacks implements ActivityLifecycleCallbacks { @Override public void onActivityResumed(Activity activity) { AdTrace.onResume(); } @Override public void onActivityPaused(Activity activity) { AdTrace.onPause(); } //... } }
Open the source file of your Activity.
Add the import statement at the top of the file.
In your Activity's onResume method call AdTrace.onResume(). Create the method if needed.
In your Activity's onPause method call AdTrace.onPause(). Create the method if needed.