Skip to main content

Prerequisites & Setup Checklist

Mandatory Global Checklist​

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

1. SDK Version​

  • Use the latest SDK version (iOS)
  • Verify compatibility with your minimum iOS deployment target
  • Check for any breaking changes in the latest release notes
  • Build with Xcode 26.2 or newer: the SDK ships as a binary framework compiled with the Swift 6.2.3 toolchain (Swift 5 language mode), so older toolchains can't link against it

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 pageUrl 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. App Tracking Transparency (iOS)​

  • Satisfy App Tracking Transparency requirements (iOS 14.5+)
  • Implement proper ATT permission requests
  • Handle user consent responses appropriately
  • Configure IDFA usage according to user preferences

7. Audio Management​

  • Adjust audio management as needed
  • Configure audio session categories appropriately
  • Test audio behavior with background audio and other apps
  • Implement proper audio interruption handling

8. Integration Validation​

  • Validate the integration using the Validation Tool for each ad slot (Media format only)
  • Test all placement types (Media, Media Native, Feed, Recommendations, Banner, Interstitial)
  • 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)
  • Use Media Native test PID 124859
  • Test Feed Placement configurations (MB_1, MB_2, TEST_FEED)
  • Test Recommendations API configurations (SDK_1, RECS_1, TEST_RECS)
  • Test Banner with widget ID MB_10 and installation key NANOWDGT01
  • Test Interstitial with widget ID INT_APP_1 and installation key NANOWDGT01
  • Verify all placement types work correctly
  • Test IDs: Test PIDs and Configurations

Device and Environment Testing​

  • Test on multiple device types (iPhone, iPad)
  • Test on different iOS 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
  • Remove validation mode before release
  • Initialize the SDK where Feed or Recommendations require it
  • Handle load errors

Configuration Issues​

  • Use production placement IDs
  • Pass privacy consent
  • Publish app-ads.txt
  • Test on devices

App Submission for Review​

Before going live, submit your app to Teads for review to ensure your integration meets quality standards:

  • Contact your publisher manager to learn how to submit your app for review
  • This review helps verify critical aspects of your integration, such as viewability and brand safety, are working as expected
  • Provide a debuggable build for network traffic inspection during the review process. iOS apps support proxy debugging by default, so no additional configuration is needed.

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
  3. Stay Updated: Subscribe to SDK release notifications and update regularly (iOS releases)

Support​

If you encounter issues during setup: