Integrate Pangle SDK for Android

This guide is for publishers who want to monetize an Android app with the traffic outside of china.

Environment requirement

minSdkVersion 14 and higher
targetSDKVersion 28 and higher
compileSdkVersion 29 and higher
gradleVersion required as below

Note: Pangle supports Android 11 since v3500 SDK, if your targetSDKVersion is 30 and above, we strongly recommend you that updating Pangle SDK to v3510 and higher

Import Pangle SDK

Note: JFrog has announced that they are shutting down the Bintray hosting service, which includes the popular JCenter hosting service for Java artifacts, the Pangle Android repository has been mrigrated to Maven

Apps can import the Pangle SDK with a Gradle dependency. First, make sure that Maven is referenced in the allprojects section of your project-level build.gradle file with the url 'https://artifact.bytedance.com/repository/pangle'.

Example project-level build.gradle (excerpt)

Next, open the app-level build.gradle file for your app, and look for a "dependencies" section.

Add the line in bold above, which instruct Gradle to pull in the Pangle SDK and additional related dependencies. Once that's done, save the file and perform a Gradle sync.

Update your AndroidManifestl.xml

Add the required permissions to your app's AndroidManifest.xml file, as shown below.

Tips: WAKE_LOCK permission is no longer required in version 4.2.5.2 and above

Add the TTMultiProvider to your app's AndroidManifest.xml file by adding a tag, as shown below:

Warning: TTMultiProvider needs to be removed starting from v4.1.0.0 sdk, otherwise it will cause packaging failure

Obfuscation

If you need to use proguard to obfuscate your code, be sure not to obfuscate the SDK code. Please add the following configuration at the end of the proguard.cfg file (or other obfuscated files):

After v3.6.0.0, the aar package will contain an proguard file proguard.txt. The default apk packaging will automatically reference the proguard file. If you modify the proguard task in the Gradle build script, please make sure that the content in proguard.txt is merged into the packaged proguard configuration.

And please make sure not to obfuscate our resource file, you can download the complete whitelist of each version from the platform.

If you use shrinkresource please add our resource file to your whitelist

Advanced topics

The app-ads.txt project is an initiative of the Interactive Advertising Bureau (IAB) that aims to reduce mobile advertising fraud.Developers need to refer to the documentation to configure app-ads.