Skip to main content

Support

info

Need help? Use the channel that matches your question — technical integration issues go to your Partner Manager, commercial questions to account management.

Contact Information​

Technical support​

Contact: your dedicated Partner Manager Use for: integration issues, SDK bugs, implementation questions, Flutter-specific problems, early-access requests

Account management​

Email: allpublishers@teads.com Use for: business questions, account setup, revenue optimization, placement configuration, app-ads.txt and publisher IDs

Before Contacting Support​

  1. Work through the Troubleshooting Guide — it covers the common causes, including the two that explain most "no ad" reports
  2. Raise the log level: TeadsLog.level = LogLevel.debug
  3. Re-check the Prerequisites
  4. Confirm you are on the latest version available to you
  5. Reproduce in a minimal app, to rule out interactions with your other plugins

What to Include in a Report​

The more of this you can supply, the faster a problem gets diagnosed:

Environment

  • flutter --version output
  • The plugin version or git ref you depend on
  • Platform and OS version, and whether it is a real device or a simulator/emulator
  • Device model

Integration

  • The relevant pubspec.yaml section
  • The placement config you are using, with keys redacted
  • Which placement type, and which widget ID or PID
  • The widget tree around the placement — this matters more than it sounds, especially for Feed

Diagnostics

  • Dart logs at LogLevel.debug
  • Native logs: adb logcat | grep -i teads, or the Xcode console filtered on Teads
  • The onFailed / onUnsupported output
  • A screen recording, for a rendering or interaction problem
  • Whether it reproduces on both platforms

Reproduction

  • Exact steps
  • Expected versus actual behavior
  • Whether it is consistent or intermittent
Redact your keys

Never paste your app key or installation key into an issue report or a shared log.

Quick Resources​

Essential documentation​

Features​

Common Issues & Quick Solutions​

Installation​

Symptoms: dependency will not resolve, Gradle or CocoaPods failures Quick fix: Installation Guide → verify the Teads Maven repository and the iOS deployment target → clean and rebuild

App crashes at launch on Android​

Symptoms: the process dies before any Dart runs Quick fix: add the AdMob APPLICATION_ID meta-data entry — required even without AdMob

No ad appears​

Symptoms: an empty slot, no error Quick fix: check the widget ID matches the placement type, and that a Feed's widgetIndex is 0

Wrong-looking ad​

Symptoms: a feed where a banner should be Quick fix: the widget ID selects the format — use MB_10 for Banner, INT_MW_1 for Interstitial

App hangs on a white screen (iOS device)​

Symptoms: launches to white on a physical iPhone, fine in the Simulator Quick fix: do not await requestTrackingAuthorization() before runApp — request it after the first frame

No recommendations revenue​

Symptoms: recommendations render, nothing is earned Quick fix: drive RecommendationsViewabilityReporter — impressions are not reported without it

Low fill rates​

Symptoms: frequent no-fill Quick fix: verify app-ads.txt, check consent handling, confirm articleUrl points at real content, then contact your account manager

Flutter Resources​

App Submission for Review​

Before going live, submit your app to Teads so the integration can be verified — viewability and brand safety in particular.

  • Contact your publisher manager to arrange it
  • Provide debuggable iOS and Android builds, so network traffic can be inspected

Getting Started Checklist​

New to the SDK? In order:

  1. ✅ Read Getting Started
  2. ✅ Complete Installation
  3. ✅ Review Prerequisites
  4. ✅ Follow the Integration Guide
  5. ✅ Develop against the Test Configurations
  6. ✅ Handle Privacy & Consent
  7. ✅ Test on real iOS and Android devices
tip

Pro tip: a report with logs at LogLevel.debug, the platform, and the widget tree around the placement is usually enough to diagnose an issue in one round trip.