illumin

Use this guide to configure illumin bidding in CloudX.

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

illumin is a server-side bidder: CloudX requests bids on the server and renders winning creatives with the CloudX SDK’s built-in renderer. There is no illumin SDK or adapter to add to your app.

Overview

Unlike SDK-based networks, illumin has no credentials to configure: no account ID, no app ID, and no placement IDs. Besides enabling the bidder and adding line items, the setup requires the illumin app-ads.txt entries.

Supported ad formats:

  • Banner (320x50)
  • MREC (300x250)
  • Interstitial
  • Rewarded

Native is not supported yet.

Step 1. Enable illumin in CloudX

Go to Bidders in the dashboard navigation, select illumin in the bidder list, and click Enable.

There is nothing to enter: illumin has no account-level credentials. If illumin is disabled, CloudX will not request bids from illumin for any of your inventory.

Step 2. Add illumin line items

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

  • Use bidder illumin
  • Target Banner, MREC, Interstitial, or Rewarded ad units
  • Repeat the setup for each ad unit where illumin should bid

Step 3. Add illumin entries to your app-ads.txt

These entries are required: illumin’s demand includes buyers that only buy inventory whose app-ads.txt authorizes illumin’s supply paths.

app-ads.txt lives at https://yourdomain.com/app-ads.txt, where yourdomain.com is the developer website in your App Store or Google Play listing. One file covers every app published under that domain. If your store listing has no developer website, set one first: buyers cannot verify any app-ads.txt entries without it.

Add the following entries to your existing file. These are the lines CloudX requires for illumin. The App-ads.txt page in your CloudX dashboard shows the full list for your file. Do not remove or modify lines that are already there — entries for other networks are unaffected by this change, and a duplicate entry is harmless if an identical line already exists in your file. Keep your CloudX DIRECT line in place — the illumin entries add to it, they do not replace it.

Loading the app-ads.txt lines…

If your file already lists these domains with different IDs — added for another SSP or mediation platform — keep those lines and add these as well; each ID authorizes a separate path.

After you publish the updated file, buyers re-crawl app-ads.txt on their own schedules. Expect illumin demand to ramp gradually rather than immediately.

Step 4. Test and validate

  1. Enable test mode for your device in CloudX.
  2. Build and run the app with the CloudX app_key and the correct CloudX ad unit identifiers.
  3. Request an ad from each ad unit where illumin is enabled.
  4. Confirm that the ad loads and that illumin participates or wins where expected.

Troubleshooting

illumin is not bidding

Check the following first:

  • illumin is enabled in the Bidders section
  • An illumin line item exists for the ad unit

Demand is lower than expected

  • If you have not added the app-ads.txt entries from Step 3, buyers that require authorized inventory cannot buy your impressions.
  • Confirm the updated file is live at https://yourdomain.com/app-ads.txt and allow up to a week for buyers to re-crawl it.

illumin bids but the ad does not render

Check the following:

  • Your app is using the CloudX app_key and loading the intended CloudX ad unit
  • Your app is on a current CloudX SDK version — illumin creatives render through the CloudX SDK’s built-in renderer

If a specific creative fails consistently, contact CloudX support with the app, ad unit, and approximate time of the failure.