Enabling test ads - cleveradssolutions/CAS-Android GitHub Wiki

:zap: Before you start
Make sure you have correctly Initialize CAS.

This guide explains how to enable test ads in your ads integration. It's important to enable test ads during development so that you can click on them without charging CAS advertisers.

[!IMPORTANT]
We strongly suggest that you enable test ads mode when you validate the integration.  If you click on too many ads without being in test mode, you risk your account being flagged for invalid activity.

There are two ways to get test ads:

Ads with Test Ads mode are safe to click. Requests, impressions, and clicks on test ads will not show up in your account's reports.
Test full-screen ads displays details of CAS integration and tips for solving errors. Go to the Mediation Adapters section to make sure that the advertising networks you want are integrated correctly.

Enable test ad mode

The quickest way to enable testing is to use test ad mode. The test ad mode are not associated with your CAS account, so there's no risk of your account generating invalid traffic when using these test ad mode.

The easiest way to load test ads is to use:

CAS.buildManager().withTestAdMode(true).Initialize()

[!WARNING]
Make sure you disable test ad mode and replace test manager ID with your own ad manager ID before publishing your app!

Enable test devices

If you want to do more rigorous testing with production-looking ads, you can now configure your device as a test device and use your own manager id. Test devices can either be added programmatically.

Follow the steps below to add your device as a test device.

  1. Run an app configured with the CAS on device.
  2. Check the logcat output for a message that looks like this:
To get test ads on this device, set "12345678901234567890123456789012"
  1. Copy your alphanumeric test device ID to your clipboard.
  2. Modify your code to set the test device ID through add TestDeviceIDs before CAS manager initialize.
CAS.settings.testDeviceIDs = setOf("12345678901234567890123456789012")

[!NOTE]
Be sure to remove the code that sets these test devices before you release your app.

  1. Re-run your app.
  2. Well done, ads on this device are safe to click. Requests, impressions, and clicks on ads in test mode will not show up in your account's reports.

๐Ÿ”— Done! Whatโ€™s Next?