# Pangle

This article is for publishers who want to use the DT FairBid SDK to load and display ads from Pangle via DT FairBid Mediation.

Pangle currently supports the following [ad types](https://app.gitbook.com/s/8KSLu5HNiyDWpvGRZh7B/publishers/additional-resources/ad-types-and-specification):

* Banner
* Interstitial
* Rewarded

To integrate Pangle as a DT mediated network:

* [Step 1: Locate Pangle Parameters](#step1).
* [Step 2: Adding Pangle as a DT mediated network](#h_01j8pvb189cn55ghv4e8pdt0za).
  * [Add Pangle for Waterfall mediation](#manual).\
    This allows for traditional waterfall mediation with Pangle. Ensure that your app and bidding placements have been added to the Pangle network.
  * Add Pangle for Bidding mediation.
    * [Add Pangle as a manually managed DT Bidding network](#biddingmanual).\
      This allows DT to include Pangle in bidding mediation. Ensure that your app and bidding placements have been added to the Pangle network.
    * [Add Pangle as an automatically managed DT Bidding network](#biddingauto).\
      This allows DT to include Pangle in bidding mediation. DT adds your app and bidding placements to the Pangle network on your behalf.
* [Step 3: Add the Pangle SDK to your integration](#id-01j8cvs1g0ac7g2tes6skwe8dg).
* [Step 4: Test your integration](#step-4-test-your-integration).

## Step 1: Locate Pangle Parameters <a href="#step1" id="step1"></a>

Depending on the type of mediation you intend to use, adding Pangle as a mediated network requires specific parameters from the Pangle Dashboard. Before you can locate these parameters, use the following table to ensure that you have completed any app setup tasks in the Pangle Dashboard.

| Pangle Tasks                                                                                                                                                                                        |            Waterfall            |         Bidding - Manual        |       Bidding - Automatic       |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-----------------------------: | :-----------------------------: | :-----------------------------: |
| [Create](https://www.pangleglobal.com/media/register) a Pangle account.                                                                                                                             | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| [Add](https://www.pangleglobal.com/integration/platform-configuration-for-mediation#1ud8r6953cf40) your app to Pangle.                                                                              | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |                                 |
| [Create](https://www.pangleglobal.com/integration/platform-configuration-for-mediation#14lmore1ieyk0) ad units in Pangle that correspond to your DT placements for traditional Waterfall mediation. | <i class="fa-check">:check:</i> |                                 |                                 |
| [Create](https://www.pangleglobal.com/integration/platform-configuration-for-mediation#14lmore1ieyk0) ad units in Pangle that correspond to your DT placements for Bidding mediation.               |                                 | <i class="fa-check">:check:</i> |                                 |

To set up Pangle as a mediated Network, locate the following Pangle parameters:

| Parameter                           | Description                                                |            Waterfall            |         Bidding - Manual        |         Bidding - Manual        |
| ----------------------------------- | ---------------------------------------------------------- | :-----------------------------: | :-----------------------------: | :-----------------------------: |
| `App ID`                            | Unique ID for your app in the Pangle system.               | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |                                 |
| `Ad Placement ID`                   | Unique identifier of the Placement in the Pangle system.   | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |                                 |
| `Role ID` for `Reporting` API       | Unique identifier to connect to the Pangle Reporting API.  | <i class="fa-check">:check:</i> |                                 |                                 |
| `Security Key` for `Reporting` API  | Unique identifier to connect to the Pangle Reporting API.  | <i class="fa-check">:check:</i> |                                 |                                 |
| `Role ID` for `Management` API      | Unique identifier to connect to the Pangle Management API. |                                 |                                 | <i class="fa-check">:check:</i> |
| `Security Key` for `Management` API | Unique identifier to connect to the Pangle Management API. |                                 |                                 | <i class="fa-check">:check:</i> |
| `User ID`                           | Unique identifier for your Pangle account.                 | <i class="fa-check">:check:</i> |                                 | <i class="fa-check">:check:</i> |

### Locating the App ID and Ad Placement ID <a href="#h_01j8pvb189fgnvjc1vb60e2k41" id="h_01j8pvb189fgnvjc1vb60e2k41"></a>

On the [Pangle dashboard](https://www.pangleglobal.com/media/login), go to **Applications** and select your app.\
The `App ID` and `Placement ID` for your app appear.

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2F4kKouZ2ZKJzocwynu4nx%2Fimage.png?alt=media&#x26;token=dceaf18e-d584-461b-becd-ad0b9e87a970" alt=""></div>

### Locating the API Key and Role ID for the Reporting API <a href="#h_01j8f8b5bmpqj3kk7sh8wxhqat" id="h_01j8f8b5bmpqj3kk7sh8wxhqat"></a>

On the [Pangle dashboard](https://www.pangleglobal.com/media/login), go to **Integrations→SDK & API→Pangle Reporting API 2.0**.\
The Reporting API credentials appear.

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FxApjk5fKhMbGyAjwm5Y9%2Fimage.png?alt=media&#x26;token=24ffe315-bd0f-45fe-af97-b18b45ee085a" alt=""></div>

### Locating the API Key and Role ID for the Management API <a href="#h_01jrxt75nffezbej4y87gkgqtt" id="h_01jrxt75nffezbej4y87gkgqtt"></a>

On the [Pangle dashboard](https://www.pangleglobal.com/media/login), go to **Integrations→SDK & API→Pangle Management API**\
The Management API credentials appear.

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FcyjfZ1BiJLWXSXOVGpeT%2Fimage.png?alt=media&#x26;token=7dbd0489-c39e-4c43-9fe6-5d0f8a661040" alt=""></div>

### Locating the User ID <a href="#h_01j8pvb189wcsp1b2bghtqkabx" id="h_01j8pvb189wcsp1b2bghtqkabx"></a>

On the [Pangle dashboard](https://www.pangleglobal.com/media/login), locate the `User ID` at the bottom left corner.

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FQx45F7qykrJ87n11KOGl%2Fimage.png?alt=media&#x26;token=e444fc95-0b51-40d7-9988-e024bae19a54" alt=""></div>

## Step 2: Add Pangle as a Mediated Network <a href="#h_01j8pvb189cn55ghv4e8pdt0za" id="h_01j8pvb189cn55ghv4e8pdt0za"></a>

Before you add Pangle as a mediated network in DT FairBid, complete the following tasks in the [DT Console](https://console.fyber.com/):

* Add your App to the DT ecosystem. For more information, see [Adding an App](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/adding-a-new-app/adding-an-app).
* Ensure that you have a DT Placement for each Pangle ad type you want to mediate with DT. For more information, see [Setting Up Placements](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-placements).

### Adding Pangle as a Waterfall Network <a href="#manual" id="manual"></a>

To add Pangle as a DT mediated network:

1. From the [DT Console](https://console.fyber.com/), go to **Monetization→App Management**, locate the **Network** tab for your app, and click **Add network**.\
   The list of available networks appears.

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FbMnkf84RAwS2NAdlKoMA%2Fimage.png?alt=media&#x26;token=48f40823-52a3-4039-a4e7-c7ec47787014" alt=""></div>

2. Click the **Pangle** tile and enter the parameters for waterfall integration that you located in [Step 1](#step1).\
   The **Add network** form for **Pangle bidder** appears.\
   For more information, see [Adding a Waterfall Network](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-mediated-networks#adding-a-waterfall-network).

{% hint style="info" %}
Some networks offer both traditional waterfall and programmatic bidding. Networks that offer programmatic bidding appear as separate tiles labeled specifically for bidding. For waterfall mediation, do not select the *bidder* version of the network.
{% endhint %}

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FUEz1JtTg0xzfckOSEAK5%2FFB_PangleWF_2025-04-15_16-25-53.png?alt=media&#x26;token=b5450915-0598-440d-9f1c-e0e99bed24b9" alt=""></div>

3. Create a Waterfall network instance for each Pnagle placement you want DT to mediate. Use the Pangle `Ad Placement ID` you located in [Step 1](#step1) as the **Instance ID**.\
   For more information, see [Adding a Waterfall Instance](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-instances#adding-a-waterfall-instance).

### Adding Pangle as a Manually Managed Bidding Network <a href="#biddingmanual" id="biddingmanual"></a>

To add Pangle as a DT mediated network:

1. From the [DT Console](https://console.fyber.com/), go to **Monetization → App Management**, locate the **Network** tab for your app, and click **Add network**.\
   The list of available networks appears.

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FNau7I4uFOLzXamcAsd7R%2Fimage.png?alt=media&#x26;token=3430ef25-5ae9-4769-968e-d1f868c18ba1" alt=""></div>

2. Click the **Pangle bidder** tile.\
   The **Add network** form for **Pangle bidder** appears.\
   For more information, see [Adding a Manually Managed Bidding Network](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-mediated-networks#adding-a-manually-managed-bidding-network).

{% hint style="info" %}
Networks that support programmatic bidding appear as separate tiles labeled specifically for bidding. To offer your placements for bidding, make sure you select the *bidder* version of the network—in this case, **Pangle bidder**.
{% endhint %}

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FXlte5S7DPu63upWcnnr9%2Fimage.png?alt=media&#x26;token=5c68a6d1-4df8-4a6b-836e-3acb7372d05c" alt=""></div>

3. Click **Manually managed** and enter the Pangle parameters for manual management from [Step 1](#step1).
4. Create a Bidding network instance for each Pangle placement you want DT to mediate. Use the using the Pangle `Ad Placement ID` you retrieved in [Step 1](#step1) as the **Instance ID**.\
   For more information, see [Manually Adding a Bidding Instance](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-instances#manually-adding-a-bidding-instance).

### Adding Pangle as an Automatically Managed Bidding Network <a href="#biddingauto" id="biddingauto"></a>

To add Pangle as an automatically managed bidding network:

1. From the [DT Console](https://console.fyber.com/), go to **Monetization → App Management**, locate the **Network** tab for your app, and click **Add network**.\
   The list of available networks appears.

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FidkLvxHu8h9j2LupgCTz%2Fimage.png?alt=media&#x26;token=eaced34f-c49e-4890-a432-b99298e0fcf2" alt=""></div>

2. Click the **Pangle bidder** tile.\
   The **Add network** form for **Pangle bidder** appears.\
   For more information, see [Adding an Automatically Managed Bidding Network](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-mediated-networks#adding-an-automatically-managed-bidding-network).

{% hint style="info" %}
Networks that support programmatic bidding appear as separate tiles labeled specifically for bidding. To offer your placements for bidding, make sure you select the *bidder* version of the network—in this case, **Pangle bidder**.
{% endhint %}

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2Fxu5xHnZVWGyibxFboblT%2Fimage.png?alt=media&#x26;token=8f24b5e6-4d74-4324-949b-a2f8b721b556" alt=""></div>

3. Click **Automatically managed** and enter the Pangle parameters for automatic management from [Step 1](#step1).
4. Auto-generate a Bidding network instance for each FairBid placement you want to mediate with Pangle. For more information, see [Automatically Adding a Bidding Instance](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-instances#automatically-adding-a-bidding-instance).

## Step 3: Add the Pangle SDK to your Integration <a href="#id-01j8cvs1g0ac7g2tes6skwe8dg" id="id-01j8cvs1g0ac7g2tes6skwe8dg"></a>

To integrate the Pangle SDK, follow the instructions on the [Supported Networks](https://docs.digitalturbine.com/dt-fairbid/fairbid-sdk/supported-networks) page.

{% hint style="info" %}
If you use ProGuard, follow the [Pangle instructions for SDK integration](https://www.pangleglobal.com/integration/integrate-pangle-sdk-for-android#as5ja83qobk0).
{% endhint %}

## Step 4: Test Your Integration

Use the DT Test Suite to verify that you have set up your app properly for FairBid mediation. The DT Test Suite is available for Android, iOS, and Unity apps. For more information about using the DT Test Suite, see [Test Suite](https://docs.digitalturbine.com/dt-fairbid/fairbid-sdk/tools/test-suite).

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FoqWJTBXcQ0oynphWzkiP%2FIMG_4982_copy%20(2).jpg?alt=media&#x26;token=24ad859d-8e24-4307-ba67-a2c908893584" alt="" width="188"></div>