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 IDin CloudX app mappingPangle Placement IDin CloudX ad-unit mapping- CloudX
app_keyand 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 field | Value to enter | Required |
|---|---|---|
Pangle App ID | Your Pangle App ID for this app | Yes |
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 field | Value to enter | Required |
|---|---|---|
Pangle Placement ID | The Pangle Placement ID for that ad unit and format | Yes |
- 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:
- Android integration guide
- iOS integration guide
- Unity integration guide
- Android Pangle Adapter page
- iOS Pangle Adapter page
- Unity Pangle Adapter page
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
- 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 onTest traffic. - 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.
- Build and run the app with the CloudX
app_keyand the correct CloudX ad unit identifiers. - Request an ad from each mapped ad unit.
- 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:
Pangleis enabled in theBidderssection- 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
Pangleline item exists for the ad unit - The user or test device is in a country Pangle supports; on line items with country targeting, the
Bidderspicker 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 field | Internal key | Scope |
|---|---|---|
Pangle App ID | app_id | App |
Pangle Placement ID | placement_id | Ad unit |