Skip to main content

Prerequisites & Setup Checklist

info

Before You Begin: This checklist ensures you have all the necessary prerequisites and configurations in place for a successful Teads SDK integration on Android.

Mandatory Global Checklist​

Follow these essential requirements to ensure a successful integration and optimal performance:

1. SDK Version​

  • Use the latest SDK version (Android)
  • Verify compatibility with your minimum Android API level
  • Check for any breaking changes in the latest release notes

2. Ad Display Requirements​

  • Ensure ads are fully visible, clickable, and start properly
  • No element should cover the player, not even transparent ones
  • Filter Teads SDK logs by teads#LoggerBridge and ensure your ads are recording impressions
  • Test ad visibility across different device orientations

3. Brand Safety Configuration​

  • Enable brand safety by configuring the articleUrl property in your ad request settings
  • Provide valid article URLs for content-based apps
  • Ensure URLs are accessible from all target regions

4. App-ads.txt Setup​

  • Set up app-ads.txt for your app's website domain
  • Include Teads entry: teads.tv, YOUR_PUBLISHER_ID, DIRECT, 15a9c44f6d26cbe1
  • Verify file is publicly accessible at your domain root
  • Contact your account manager for your publisher ID

5. Privacy Compliance​

  • Enable GDPR/CCPA/GPP privacy compliance when applicable
  • Implement proper consent management
  • Configure consent strings according to IAB specifications
  • Test consent flow in all target regions

6. Integration Validation​

  • Validate the integration using the Validation Tool for each ad slot
  • Test all placement types (Media, Feed, Recommendations)
  • Verify tracking and analytics are working correctly
  • Document any issues found during validation

Pre-Release Testing Checklist​

Before releasing your app to production, ensure thorough testing:

Test Configuration Testing​

  • Test with different test PIDs or configurations
  • Use Media Placement test PIDs (84242, 127546, 127547, 128779, 128780)
  • Test Feed Placement configurations (MB_1, MB_2, TEST_FEED)
  • Test Recommendations API configurations (SDK_1, RECS_1, TEST_RECS)
  • Verify all placement types work correctly
  • For detailed test configurations: Refer to Test PIDs and Configurations for comprehensive testing setup

Device and Environment Testing​

  • Test on multiple device types (phones, tablets)
  • Test on different Android versions (minimum supported and latest)
  • Test in different network conditions (WiFi, cellular, poor connection)
  • Test with different user consent scenarios

Performance Testing​

  • Monitor app performance with ads enabled
  • Check memory usage and potential leaks
  • Test app launch time and responsiveness
  • Verify battery usage is within acceptable limits

User Experience Testing​

  • Test ad loading times and user experience
  • Verify ads don't interfere with app functionality
  • Test ad interactions (clicks, video playback)
  • Ensure proper error handling and fallbacks

Mediation Checklist (If Applicable)​

For mediation integrations, ensure additional requirements:

  • Ad slots comply with the resizing feature for Media Placement
  • Implement proper resize handling for dynamic ad sizes
  • Test with different creative formats and sizes
  • Verify mediation adapter settings are correctly configured

Common Issues to Avoid​

Integration Issues​

  • Don't use test PIDs in production
  • Don't forget to remove validation mode before release
  • Don't ignore SDK initialization requirements
  • Don't skip proper error handling implementation

Configuration Issues​

  • Don't forget to set proper placement IDs
  • Don't ignore privacy compliance requirements
  • Don't skip app-ads.txt implementation
  • Don't forget to test on actual devices

Next Steps​

After completing this checklist:

  1. Review Integration Guide: Follow the Integration Guide for detailed implementation steps
  2. Test Thoroughly: Use the Validation Tool to verify your implementation 3Stay Updated: Subscribe to SDK release notifications and update regularly

Support​

If you encounter issues during setup:

tip

Pro Tip: Keep this checklist handy during development and refer to it before each release to ensure nothing is missed.