Pangle integration

Integrate Pangle with Unity LevelPlay by creating a Pangle account, adding your app, and configuring ad units for interstitials and rewarded videos.

Read time 3 minutes

Prerequisites
Prerequisites

  • Pangle serves ads to users in: Japan, South Korea, Taiwan, Thailand, Philippines, Singapore, Cambodia, Vietnam, Malaysia, Saudi Arabia, United Arab Emirates, Egypt, Turkey, Indonesia, Canada, Argentina, Chile, Peru, Colombia, Brazil, Mexico, Belarus, Ukraine, Israel, Kazakhstan, Russia, Australia, New Zealand, South Africa, Pakistan, Kuwait, Iraq, Morocco, Qatar, Jordan, Oman, Bahrain, Uruguay, Ecuador, Lebanon, Kenya, Sri Lanka, Algeria, Azerbaijan, Serbia, Paraguay and Bolivia (iOS & Android, bidding & non-bidding)

  • Pangle supports Android Operating Systems Version 5 (API level 21) and up. [/platform]

Step 1. Create a Pangle account
Step 1. Create a Pangle account

To access Pangle's ad inventory through Unity LevelPlay, you must create an account with Pangle. You can do so here.

Step 2. Create an application in Pangle 
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 'Add'
  2. Add your app or select an existing app to monetize.

Step 3. Activate Pangle in your LevelPlay Network Setup module
Step 3. Activate Pangle in your LevelPlay Network Setup module

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

App Settings

There are parameters from your Pangle account that you'll need to enter into your LevelPlay Network Setup module so Pangle can connect with LevelPlay:

User IDThe unique ID assigned to your user on Pangle's dashboard.
API KeyKey generated by Pangle for reporting API purposes (Called API key in Pangle platform)
Application IDThe unique ID assigned to your app on Pangle's dashboard.
Placement IDThe unique ID assigned to the ad you have created on Pangle's dashboard.

After 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 LevelPlay platform.

User ID

After you sign in to your Pangle account, you'll find your User ID on the top right corner of the dashboard

Application ID

After 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

After 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
Step 4. Add the Pangle adapter to your build

ironSource supports both Gradle dependencies and manual download mechanisms.

Gradle
Gradle

  1. Make sure the following Maven URL exist in your build.gradle script of your app module.

    repositories {
    mavenCentral()
    maven {
        url 'https://artifact.bytedance.com/repository/pangle' 
    }
}

  2. Add the adapter's Maven name to your build.gradle script of your app module.

dependencies {
   implementation 'com.unity3d.ads-mediation:pangle-adapter:4.3.47'
   implementation 'com.pangle.global:pag-sdk:7.3.0.4'
   implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0'
}

Manual Download
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.

  3. Make sure you add the following to your Gradle build file under the dependencies section:

dependencies {
   implementation 'com.unity3d.ads-mediation:pangle-adapter:4.3.47'
   implementation 'com.pangle.global:pag-sdk:7.3.0.4'
   implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0'
}

For ProGuard Users Only
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.** { *; }

Step 5. Update AndroidManifest.xml
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. If you intend to keep your Jar integration, add the manifest.

Manifest Permissions:

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

Step 6. Pangle Additional Settings
Step 6. Pangle Additional Settings

Set COPPA
Set COPPA

Unity LevelPlay 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");

To verify your ironSource and additional ad networks' integration, follow this document.

You can now deliver Pangle within your application.