Validation Tool

Launch a Validation Session
Validation error list

The Teads inApp Validation tool is the best way to ensure all basic features and prerequisites are correctly implemented.
We also recommend using it between each integration iteration/update to make sure no regression has been introduced.

✅ Validates the overall ad integration and display within your content

✅ Checks that creatives are correctly running

✅ Validates Teads tracking

✅ Validates Brand Safety is enabled

✅ Validates User consent retrieval

✅ Validates app-ads.txt setup

✅ Validates support for creative resize

Static landspace video

Please note that once you run the Validation tool, it will always use the same creative, which is a landscape video. This test is not designed for validating different types of creatives, so your PIDs will not have any effect here. However, the test is not limited to landscape videos; it still evaluates your overall integration.

⚠️ IMPORTANT: Do not forget to remove this setting before going into production!

Please feel free to report any anomaly or feedback to your Teads local account manager.

Launch a Validation Session

1. Enable the validation mode on the Teads inApp SDK

Direct Integration

Add the following code to your ad placement settings and ad request settings:

// iOS
let adPlacementSettings = TeadsAdPlacementSettings { settings in
    settings.enableDebug()
}

let adRequestSettings = TeadsAdRequestSettings { settings in
    settings.enableValidationMode()
}

// Android
val adPlacementSettings = AdPlacementSettings.Builder()
    .enableDebug() 

val adRequestSettings = AdRequestSettings.Builder()
    .enableValidationMode()

Mediation Integration

Add the following code to your mediation adapter settings:

// iOS
let teadsAdapterSettings = TeadsAdapterSettings { settings in
    settings.enableDebug()
    settings.enableValidationMode()
}

// Android
val teadsMediationSettings = TeadsMediationSettings.Builder()
    .enableDebug()
    .enableValidationMode()

2. Build your app and open an article or a page that displays a Teads ad placement where the validation mode is activated.

Do not tap on Abort; it will cancel the validation test.
Copy the URL from the log tool on your IDE by filtering for sdkvalidation.teads.tv.
Open the URL in your desktop browser; do not attempt to open it on your mobile device.
.

4. Then, follow these instructions:

Click on BEGIN TEST:
.
Scroll down to the ad location in your app.
Wait for the end of the video ad.
.

5. In less than a minute, the following checks should be verified:

✅ Page URL (or article URL) is valid
- The page or article URL used for brand safety purposes is provided.
  This is only required for publishers displaying articles (news).
✅ GDPR-compliant, CCPA Compliant, GPP Compliant
- The user consent signals are provided.
  This is only required if you are distributing your app where user consent regulations apply.
✅ SDK version is up to date
- The SDK version used is the latest available.
✅ App-ads.txt includes Teads.tv
- The app-ads.txt is properly available on your website provided in the app store.
✅ Teads tracking is correctly sent and received
- The ad lifecycle events are properly computed.
✅ Media playback is completed successfully.
- The video ad is played until the end.
✅ Creative Resize
- The creative is resized correctly.

Validation error list

Please find below the list of errors that could be detected by the Validation Tool.
Each one of them can be solved with instructions detailed below.

We were unable to find your app on the App Store/Google Play. If you think there is an issue, contact support-sdk@teads.tv with your Session Info.

Your app defines a bundle/package name reverse domain as com.domain.myapplication. If the package name is not found on public stores, this could mean two things:

The app is not released yet on the store.

The app is using a test bundle/package name.

Your bundle/package name is not properly set on our side.

We are not able to find your Developer Website from Apple/Google. Did you fill the Marketing URL / Developer URL on App Store?

You need to specify the URL pointing to your website in the store marketing section / developer website, the same website that hosts your app-ads.txt.

We found your developer URL but were not able to find a proper URL to crawl.

App Ads Crawler encountered a problem scanning your website. Make sure your website is publicly available and not behind a firewall.

We are not able to find your app-ads.txt file. It may not exist, or the server may not be configured correctly. You can find more information on the IAB App Ads txt Specs.
This could be due to app-ads.txt hidden by redirection on your server.

The app-ads.txt file can't be found on the specified website URL (Store). Make sure it is available publicly.

We found your app-ads.txt but it did not include Teads. Contact your Teads Publisher Manager for more info. Also, "teads.com" is not a valid domain.

Contact your Publisher Manager to double-check if you have the correct portion to be added to the app-ads.txt file.

The consent string is empty

The consent string seems to be wrong

The consent string is not formatted correctly

The consent string cannot be parsed

The user consent signal is not specified correctly. Make sure to set it to AdPlacementSettings (iOS, Android).

The consent string is missing some data, there is probably something wrong with the CMP you are using.

We did not get any response from your CMP

Your CMP doesn't set the consent string respecting IAB specifications CMP Internal Structure.

You need to pass the page URL to Teads inApp SDK. This may be the sharing URL from a given content (article, sport result). This URL should be available from any country.

If applicable, specify the pageUrl relative to the content, for instance .pageUrl("https://mysite.com/specificArticleContent").
Make sure to set it to AdRequestSettings (iOS, Android).

Tracking has not been received.

Make sure you are not running a proxy or VPN on your device/simulator.

Make sure the ad is visible on the screen. If you can see the ad, but it does not start check your console logs for more information, it could be due to an overlay.

The ad should be fully visible to run tests. Maybe content overlays the ad, or the ad size is too low: undersized ads will be considered not visible/displayed.
Double-check the page Troubleshooting & common issues.

You need to wait for the end of the video, so we can check that the ad played entirely.

Wait for the video progress to complete.

Modified on: Mon, 28 Oct, 2024 at 8:43 AM

Launch a Validation Session

1. Enable the validation mode on the Teads inApp SDK

Direct Integration

Mediation Integration

2. Build your app and open an article or a page that displays a Teads ad placement where the validation mode is activated.

3. A popup will appear and show a URL

4. Then, follow these instructions:

5. In less than a minute, the following checks should be verified:

Validation error list

We were unable to find your app on the App Store/Google Play. If you think there is an issue, contact support-sdk@teads.tv with your Session Info.

We are not able to find your Developer Website from Apple/Google. Did you fill the Marketing URL / Developer URL on App Store?

We found your developer URL but were not able to find a proper URL to crawl.

We are not able to find your app-ads.txt file. It may not exist, or the server may not be configured correctly. You can find more information on the IAB App Ads txt Specs.This could be due to app-ads.txt hidden by redirection on your server.

We found your app-ads.txt but it did not include Teads. Contact your Teads Publisher Manager for more info. Also, "teads.com" is not a valid domain.

The consent string is empty

The consent string seems to be wrong

The consent string is not formatted correctly

The consent string cannot be parsed

The consent string is missing some data, there is probably something wrong with the CMP you are using.

We did not get any response from your CMP

You need to pass the page URL to Teads inApp SDK. This may be the sharing URL from a given content (article, sport result). This URL should be available from any country.

Tracking has not been received.

Make sure the ad is visible on the screen. If you can see the ad, but it does not start check your console logs for more information, it could be due to an overlay.

You need to wait for the end of the video, so we can check that the ad played entirely.

We are not able to find your app-ads.txt file. It may not exist, or the server may not be configured correctly. You can find more information on the IAB App Ads txt Specs.
This could be due to app-ads.txt hidden by redirection on your server.