Pangle (BETA)

Use this guide to configure Pangle bidding in CloudX.

Keep using the platform integration guides for SDK installation and ad loading:

For platform-specific Pangle adapter requirements, see:

Overview

Use the following values:

  • Pangle App ID in CloudX app mapping
  • Pangle Placement ID in CloudX ad-unit mapping
  • CloudX app_key and CloudX ad unit identifiers in app code

CloudX collects the Pangle bid token through the Pangle adapter, so you do not need to fetch or pass the token in your app code.

Supported ad formats:

  • Banner (320x50)
  • MREC (300x250)
  • Interstitial
  • Rewarded
  • Native
  • App Open

Native-in-banner and native-in-MREC use the separate Pangle Native bidder. See Set up native-in-banner and native-in-MREC. In Unity apps, Native is available on iOS only.

Supported countries

Pangle buys inventory only in the regions Pangle supports, so CloudX requests Pangle bids only for users in those countries. On line items with country targeting, the Bidders picker shows whether Pangle is eligible.

United States

In the United States, Pangle bids on Rewarded and Interstitial ad units only, and reports show that traffic as Pangle US.

US traffic uses your existing Pangle setup, so there is nothing to configure separately. CloudX turns it on per account; contact your CloudX account manager. Until it is on, CloudX does not request Pangle bids for users in the United States.

Step 1. Complete Pangle onboarding and update app-ads.txt

Contact your CloudX account manager to start Pangle onboarding before you enable Pangle in CloudX.

You need:

  • A Pangle App ID for each app you want to monetize.
  • A Pangle Placement ID for each ad unit and ad format you want to monetize.

Add the Pangle lines below to your app-ads.txt file. These are the lines CloudX requires for Pangle. The App-ads.txt page in your CloudX dashboard shows the full list for your file.

Loading the app-ads.txt lines…

Publish the lines at https://yourdomain.com/app-ads.txt, where yourdomain.com is the developer website listed in the App Store or Google Play. Keep the existing entries for CloudX and other networks.

Step 2. Enable Pangle in CloudX

Go to Bidders, select Pangle, click Enable, then click Confirm.

If Pangle is disabled, CloudX will not request bids from Pangle even if your mappings are correct.

You can also enter the Pangle App ID and Placement IDs on this page instead of in the next two steps.

Step 3. Configure your CloudX app

Go to Apps and create or open the app that matches your mobile application.

CloudX fieldValue to enterRequired
Pangle App IDYour Pangle App ID for this appYes

Also copy the CloudX app_key from the app details page. Use the CloudX app_key in Android or iOS code.

Step 4. Configure CloudX ad units

Go to Ad Units and add the mapping below for each eligible ad unit.

CloudX fieldValue to enterRequired
Pangle Placement IDThe Pangle Placement ID for that ad unit and formatYes
  • Match each Placement ID to the CloudX ad-unit format.
  • Use a separate Pangle placement for each CloudX ad unit or format as needed.

Step 5. Add Pangle line items

Go to Line Items and create line items for bidder Pangle on each CloudX ad unit where Pangle should compete.

  • Target Banner, MREC, Interstitial, Rewarded, Native, or App Open ad units
  • Repeat the setup for each ad unit where Pangle should bid

Step 6. Finish app integration

Complete the integration and adapter setup for your platform:

In app code:

  • Initialize CloudX with the CloudX app_key
  • Load ads using CloudX ad unit identifiers
  • Do not pass Pangle App IDs or Placement IDs into app code
  • For Interstitial and Rewarded ads, call show() only after the ad is ready

Step 7. Test and validate

  1. Register your device as a CloudX test device: go to Dev Tools → Test Devices, add the device with the app in its scope, and turn on Test traffic.
  2. Test on a real device in a country Pangle supports. We recommend a real device because Pangle may not bid on simulators or emulators. In the United States, test Rewarded and Interstitial ad units only, after CloudX turns on Pangle in the United States for your account.
  3. Build and run the app with the CloudX app_key and the correct CloudX ad unit identifiers.
  4. Request an ad from each mapped ad unit.
  5. Confirm that the ad loads and that Pangle participates or wins where expected.

Troubleshooting

Pangle is not listed

Pangle is currently beta in CloudX. Contact your CloudX account manager to request access if it is not visible under Bidders.

Pangle is not bidding

Check the following first:

  • Pangle is enabled in the Bidders section
  • The app has a valid Pangle App ID
  • The ad unit has a valid Pangle Placement ID, and the placement matches the ad-unit format
  • A Pangle line item exists for the ad unit
  • The user or test device is in a country Pangle supports; on line items with country targeting, the Bidders picker shows whether Pangle is eligible
  • You are testing on a real device; simulators and emulators may not get Pangle bids
  • In the United States, the ad unit is Rewarded or Interstitial, and CloudX has turned on Pangle in the United States for your account
  • The Pangle adapter is installed, so the CloudX SDK can collect the Pangle bid token
  • Your app-ads.txt file includes the Pangle lines from Step 1 with your Pangle Account ID

Pangle bids but the ad does not render

Check the following:

  • Your app is using the CloudX app_key, not a Pangle ID
  • Your app is loading the intended CloudX ad unit
  • The Pangle App ID and Placement ID belong to the same Pangle app and format
  • The Pangle adapter is installed and its platform requirements are complete
  • Interstitial and Rewarded ads are shown only after they are ready

Mapping Reference

CloudX fieldInternal keyScope
Pangle App IDapp_idApp
Pangle Placement IDplacement_idAd unit