> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Testing

> Test devices allow you to safely test ads on specific devices without affecting your revenue data. Register devices by their identifier (IDFA for iOS, GAID for Android) to control test traffic and debug logging.

<img src="https://mintcdn.com/cloudx-928dcb24/dvzjl4I9j7cnSnQy/images/test-devices.png?fit=max&auto=format&n=dvzjl4I9j7cnSnQy&q=85&s=12272e2a78e060040b8a045861a7010b" alt="Testing" width="2608" height="1184" data-path="images/test-devices.png" />

# Add a test device

To access test devices, navigate to your app page, click the three dots  `⋮`  menu in the top right, and select Test devices.

<img src="https://mintcdn.com/cloudx-928dcb24/dvzjl4I9j7cnSnQy/images/test-devices-menu.png?fit=max&auto=format&n=dvzjl4I9j7cnSnQy&q=85&s=e40e25f126b6f9047b254597f7400454" alt="Testing" width="2608" height="1184" data-path="images/test-devices-menu.png" />

1. Click **Add device**
2. Enter your **Device IFA**
3. Optionally add a **Device Name** to make the device easier to identify
4. Select your platform (iOS or Android)
5. Configure your settings using the toggles (see below)
6. Click **Add**

<Info>
  Changes take effect when the device starts a new app session, not immediately.
</Info>

<video controls width="100%" playsInline alt="Walkthrough of adding a test device in the CloudX Dashboard">
  <source src="https://mintcdn.com/cloudx-928dcb24/dvzjl4I9j7cnSnQy/en/files/adding-test-devices.mp4?fit=max&auto=format&n=dvzjl4I9j7cnSnQy&q=85&s=595f1768c491818b49f398308bdae31e" type="video/mp4" data-path="en/files/adding-test-devices.mp4" />
</video>

# Configure

Control how each test device behaves using these settings:

| Setting      | Description                                                                                                                     |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| Test Traffic | When on: Device receives test ads only and data is excluded from revenue reports. Use for visual QA and ad integration testing. |
| Debug mode   | When on: Device gathers diagnostic logs for troubleshooting integration issues.                                                 |

# Finding your device ID

You need your device's advertising identifier to register it as a test device.

### **iOS (IDFA)**

Finding your IDFA requires a third-party app. My Device IDFA by AppsFlyer and Adjust Insights by Adjust are both available free on the App Store.

### **Android (GAID)**

1. Open **Settings** on your Android device
2. Tap **Security and privacy** → **Ads**
3. Your GAID appears under **Advertising ID**
