Pangle Integration Guide

This guide instructs you step-by-step on how to set Pangle live on the ironSource mediation platform.

Before you start Pangle serves ads to users in China (iOS only), Japan, South Korea, Taiwan, Thailand, Vietnam, Malaysia, Saudi Arabia, United Arab Emirates, Egypt, Turkey, Indonesia and Russia.

Step 1. Create a Pangle account

To access Pangle’s ad inventory through ironSource‘s mediation platform, you must create an account with Pangle. You can do so here.

Step 2. Create an application in Pangle 

Next, add the app in your Pangle account.

Add Your App

  1. Log into your Pangle account. On your dashboard, hover ‘Applications and click ‘Apps’

  2. Add your app or select an existing app to monetize.

Step 3. Activate Pangle in your ironSource network setup module

Serving Pangle’s ads through the ironSource mediation platform has never been this easy. Sign in to your Pangle account when setting up Pangle on the ironSource SDK Networks setup page and insert all the necessary parameters to run Pangle Interstitials and Rewarded Videos!

Account Settings

App Settings

There are parameters from your Pangle account that you’ll need to enter into your ironSource network setup module so Pangle can connect with ironSource:

User ID
The unique ID assigned to your user on
Pangle’s dashboard.
Secure Key
Key generated by Pangle for reporting API purposes
Application ID
The unique ID assigned to your app on
Pangle’s dashboard.
Placement ID
The unique ID assigned to the ad you have created on Pangle’s dashboard.


Once you obtain this information, configure Pangle’s parameters in your ironSource account. By adding the above information correctly, you’ll be able to take full advantage of Pangle’s ad inventory and reporting data on the ironSource mediation platform.

User ID

Once you logged in to your Pangle account, you’ll find your User ID on the top right corner of the dashboard


Secure Key

To retrieve your Pangle Secure key, contact the Pangle team.

Application ID

Once you’ve created an application in the Pangle dashboard (as described in step 2), you’ll find your Application ID under ‘Apps‘ (hover ‘Applications and click ‘Apps’).

Placement ID

Once you’ve created an application in the Pangle dashboard, you’ll need to include ads. Hover over ‘Application and click ‘Ad placements.
Add your placement manually or select an existing placement to get its Placement ID.

Step 4. Add the Pangle adapter to your build

ironSource supports both Gradle dependencies and manual download mechanisms.

Gradle

  1. Make sure the following Maven URL exist in your build.gradle script of your app module (should appear only once for all the adapters).
    repositories {
        maven {
            url "https://dl.bintray.com/ironsource-mobile/android-adapters"
        }
    }
  2. Add the adapter’s Maven name to your build.gradle script of your app module.
    dependencies { 
       implementation 'com.ironsource.adapters:pangleadapter:4.1.5'
       implementation 'com.bytedance.sdk:pangle-sdk:3.1.7.4'
    }

Manual Download

  1. Download the Pangle Adapter and SDK:
    Add the Pangle Adapter and SDK to your build. You can find the latest Pangle files here.
  2. Add the Pangle Adapter to your Project:
    After you download the Adapter and SDK; drop the Pangle files into the libs folder in your Android Project.
    Supersonic Mediation Drop Libs
  3. Make sure you add the following to your Gradle build file under the dependencies section:
        implementation files('libs/pangleadapter:4.1.5')
        implementation 'com.bytedance.sdk:pangle-sdk:3.1.7.4'
    

For ProGuard Users Only

If you are using ProGuard with Pangle adapter, you must add the following code to your ProGuard file:

-keep class com.bytedance.sdk.openadsdk.*{ public *; }

Step 5. Update AndroidManifest.xml

As of Pangle Android adapter version 4.1.1 + (Android SDK Version 6.17.0), Pangle adapter will be released as AAR. Only if you intend to keep your Jar integration, please add the manifest.


Manifest Permissions:

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

<!-- If there is a video ad and it is played with textureView, please be sure to add this, otherwise a black screen will appear --/>
<uses-permission android:name="android.permission.WAKE_LOCK"/>

Manifest Activities:
Add the following information inside the <application> tag on your manifestAdditions:

<provider
  android:name="com.bytedance.sdk.openadsdk.multipro.TTMultiProvider"
  android:authorities="${applicationId}.TTMultiProvider"
  android:exported="false"/>

Step 6. Pangle Additional Settings

Set COPPA

ironSource’s mediation platform lets publishers communicate Pangle COPPA settings directly to the Pangle network.
This feature is enabled using ironSource SDK 6.17.0+, Pangle Android Adapter 4.1.2+.

Use the following syntax, to set Pangle COPPA with the value 1, to report Child:

 IronSource.setMetaData("Pangle_COPPA","1");

Use the following syntax, to set Pangle COPPA with the value 0, to report Adult:

 IronSource.setMetaData("Pangle_COPPA","0");

Verify Your Ad Network Integration

The ironSource SDK provides an easy way to verify that your mediation integration was completed successfully. To verify your ironSource and additional ad networks’ integration, follow this document.

Done!
You are now all set to deliver Pangle within your application!