flet-yandex-ads

Display Yandex Mobile Ads in Flet apps.

A 1:1 wrapping of the official yandex_mobileads Flutter plugin, in the same architecture as flet-ads. Yandex is a large demand source on its own, and it can mediate AdMob, AppLovin, Mintegral, Pangle, Unity and more behind one integration.

Test it without an account

Every release builds an unsigned test APK of the example app with Yandex demo ad units — no signup needed:

Android Architecture Build Splits

Platform Support

⚠️ Android TV runs and attempts to serve ads (the SDK is an Android SDK), but fill rate and remote-control focus are untested — try the APK above on a TV and see.

Usage

uv add flet-yandex-ads

import flet as ft
import flet_yandex_ads as fya

def main(page: ft.Page):
    page.services.append(fya.YandexAdsService(user_consent=True))
    page.add(fya.BannerAd(unit_id="demo-banner-yandex"))

ft.run(main)

The demo ad units (demo-banner-yandex, demo-interstitial-yandex, demo-rewarded-yandex, demo-appopenad-yandex) work out of the box. Replace them with your own ad block IDs (R-M-XXXXXX-Y) from the partner interface for production.

Controls

Full-screen ads load when the service is added to the page. Each is one-shot — create a new instance per ad and call destroy() afterwards.

Event handlers

BannerAd(
    unit_id="R-M-XXXXXX-Y",
    on_load=lambda e: print(f"{e.width}x{e.height}"),       # typed
    on_load_failed=lambda e: print(e.code, e.description),  # typed
    on_click=lambda e: print("clicked"),                    # plain
)

Typed handlers must use ft.EventHandler[SomeEvent], not ft.ControlEventHandler[SomeEvent] — ControlEventHandler[X] double-wraps X in Event[...], so Flet builds a plain Event and e.width raises AttributeError. (flet-ads 1.0.4 has this bug in its on_paid.)

Typed events: BannerLoadedEvent (width, height), AdRequestErrorEvent (code, description, ad_unit_id), AdErrorEvent (description), ImpressionEvent (impression_data — ILRD), RewardEvent (amount, type).

Configuration

No manifest keys or Info.plist entries are needed for basic operation. Mediation adapters are added to the generated Flutter app's Gradle config — see the plugin docs.

Limitations

• The Flutter plugin exposes four formats: banner, interstitial, rewarded, app open. Native and InStream ads exist only in Yandex's native SDKs.
• Ads don't render on desktop or web (by design — same as every mobile ad SDK).

Example

A complete app (sticky + inline banner, interstitial, rewarded, app open, with an activity-terminal log view) is in examples/flet_yandex_ads_example/.

License

MIT