Skip to main content

Validation Tool

tip

The Teads SDK 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.

warning

Important: The Validation Tool currently works only for Teads Media placements (video ads). It does not support Media Native, Feed placements or Recommendations API validation.

What the Validation Tool Checks​

✅ 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

info

Static landscape 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.

warning

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

Please feel free to report any anomaly or feedback, for more check our support page.

Launch a Validation Session​

1. Enable the validation mode on the Teads SDK​

To enable validation mode, configure your ad settings with debug and validation mode enabled. For detailed configuration instructions, see the Settings Configuration page.

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​

  • 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

validationTool

4. Follow these instructions:​

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

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 for Other SDK Placements​

info

Coming Soon: Validation tool support for Feed placements and Recommendations API is being developed. The following sections will be updated with specific configuration instructions once available.

Feed Placement Validation​

Placeholder for Feed placement validation configuration

// TODO: Add Feed placement validation configuration
// This will include specific settings for validating Feed placements
// with the combined SDK

Recommendations API Validation​

Placeholder for Recommendations API validation configuration

// TODO: Add Recommendations API validation configuration
// This will include specific settings for validating Recommendations API
// with the combined SDK

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.

Table of Contents​

1. App Store Issues​

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

Your app defines a bundle 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 name
  • Your bundle name is not properly set on our side
1.2 We are not able to find your Developer Website from Apple. 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.

1.3 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.

2. App-ads.txt Issues​

2.1 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.

warning

Known Issue: On iOS, the app-ads.txt validation step may fail due to an issue with the iTunes API. This is a known limitation and does not affect the actual functionality of your app-ads.txt implementation.

2.2 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.

3.1 The consent string is empty / seems to be wrong / is not formatted correctly / cannot be parsed​

The user consent signal is not specified correctly. Make sure to set it to AdPlacementSettings. For detailed privacy and compliance configuration, see the Privacy & Compliance page.

3.2 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.

4. Brand Safety Issues​

4.1 You need to pass the page URL to Teads 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).

5. Tracking Issues​

5.1 Tracking has not been received.​

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

6. Visibility Issues​

6.1 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 Prerequisites & Setup Checklist page and the Troubleshooting Guide for detailed visibility solutions.

6.2 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.

Support​

For questions about the Validation Tool or to report issues: