Skip to main content
zMaticoo is currently beta in CloudX. If it is not visible in the Bidders section, contact your CloudX account manager for beta access.
Keep using the platform integration guides for SDK installation and ad loading: zMaticoo 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 zMaticoo SDK or adapter to add to your app.

Overview

Unlike SDK-based networks, zMaticoo has no credentials to configure: no account ID, no app ID, and no placement IDs. Enabling the bidder and adding line items is the entire setup.
  • zMaticoo currently bids on Banner (320x50) and MREC (300x250) ad units. Additional formats will be enabled in a future rollout.
  • Adding zMaticoo’s app-ads.txt entries is optional but recommended — around 30% of zMaticoo’s spend requires them (see Step 3).

Step 1. Enable zMaticoo in CloudX

Go to Bidders in the dashboard navigation, select zMaticoo in the bidder list, and click Enable. zMaticoo in the Bidders section There is nothing to enter: zMaticoo has no account-level credentials. If zMaticoo is disabled, CloudX will not request bids from zMaticoo for any of your inventory.

Step 2. Add zMaticoo line items

Go to Line Items and create line items for bidder zMaticoo on each CloudX ad unit where zMaticoo should compete. zMaticoo line item
  • Use bidder zMaticoo
  • Target Banner and MREC ad units
  • Repeat the setup for each ad unit where zMaticoo should bid

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

This step is optional — zMaticoo bids without it — but strongly recommended: around 30% of zMaticoo’s spend comes from buyers that only buy inventory whose app-ads.txt authorizes zMaticoo’s reseller entries. 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. Append the following 24 entries to your existing 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 zMaticoo entries add to it, they do not replace it.
The account IDs in these entries are zMaticoo’s seats at each exchange. They are identical for every CloudX publisher and are not tied to your account. 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 the additional zMaticoo 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 Banner and MREC ad unit where zMaticoo is enabled.
  4. Confirm that the ad loads and that zMaticoo participates or wins where expected.

Troubleshooting

zMaticoo is not bidding

Check the following first:
  • zMaticoo is enabled in the Bidders section
  • A zMaticoo line item exists for the ad unit

zMaticoo 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 — zMaticoo 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.

Demand is lower than expected

  • If you have not added the app-ads.txt entries from Step 3, around 30% of zMaticoo’s spend cannot buy your inventory.
  • 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.