Why Taproll?​

Google's IMA SDK is the default choice for VAST/VMAP ad playback on Android, but it has a critical weakness: it requires a persistent internet connection to fetch and render ads. During internet shutdowns — a recurring reality in Iran — IMA-based ad playback breaks entirely. Beyond that, IMA is not prepared for Iran's network conditions, offers no default localization for Farsi, and provides limited control over the ad UI. Taproll was built to address all of these.

Works Without Internet​

Taproll does not require internet access to render ads. IMA stops working the moment connectivity is lost — Taproll keeps your ad revenue flowing regardless of network conditions.

High Performance​

Taproll is based on minimal features, lightweightness, minimal footprint, faster builds, and fewer version conflicts. Benchmark results show it starts up and renders the first frame of a pre-roll ad roughly 1.9× faster than IMA — approximately 1.4s vs 2.65s under the same conditions.

Simple UI Control​

Customize the ad overlay through an XML layout using XmlOverlayAdapter, or implement the AdOverlay interface for more control over the skip button, countdown timer, and header views. UI elements use standard Android widgets (TextView or its subclasses) rather than opaque custom views.

Low Dependency​

Taproll's only required dependency is ExoPlayer (Media3). No Google IMA SDK, no Google Play Services — just a single, lightweight library that adds minimal footprint to your build.

Active Development​

Taproll is under active development with frequent updates. Need a feature or found a bug? Open a discussion — the team reviews and prioritizes community feedback.

How It Integrates​

Taproll integrates with ExoPlayer via TaprollAdLoader, which implements the Media3 AdsLoader interface. Wire it through DefaultMediaSourceFactory.setLocalAdInsertionComponents() and ads play automatically at cue points with zero ad-management code.

// ExoPlayer integration — minimal setup
val adsLoader = TaprollAdLoader.Builder(context)
    .setAdEventListener { adEvent -> /* handle event */ }
    .setAdErrorListener { adError -> /* handle error */ }
    .build()

val player = ExoPlayer.Builder(context)
    .setMediaSourceFactory(
        DefaultMediaSourceFactory(context)
            .setLocalAdInsertionComponents({ adsLoader }, playerView)
    )
    .build()

Getting Started​

Taproll is part of Tapsell Mediation SDK and fully integrated with it. Add the legacy adapter Taproll integration to your project:

// build.gradle
dependencies {
    implementation 'ir.tapsell.mediation.adapter:legacy-taproll:$tapsellVersion'
}

For full setup instructions and ExoPlayer integration details, refer to the Taproll documentation and sample app.

Why Tapsell Maven?​

Tapsell packages depend on a number of third-party libraries. Fetching all of them from scattered external sources can be slow or unreliable, especially in restricted network environments. By mirroring everything through maven.tapsell.ir, you get:

• Single source of truth — Tapsell SDKs and their dependencies served from one place.
• Faster downloads — servers are optimised for developers in the region.
• Higher reliability — no more transient failures from upstream registries.

Adding the Repository​

Depending on your project's Gradle setup, add the Tapsell Maven URL in one of the following ways:

// settings.gradle
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // Tapsell repository
        maven { url = uri("https://maven.tapsell.ir") }
        google()
        mavenCentral()
    }
}

Next Steps​

Once the repository is added, follow the full Android SDK setup guide to add the Tapsell dependency to your app module and initialise the SDK:

Android Quick Start — Set up your app

خوشبختانه پیشنهاد با استقبال خوبی مواجه شد، و مشخص شد این دغدغه، نه فقط یک دغدغه‌ی شخصی، که یک دغدغه‌ی تیمیه. با مشورت بچه‌های تیم، تصمیم گرفتیم مطالعه‌ی کتاب دوم رو شروع کنیم. قرار شد هر هفته بخشی از کتاب رو بخونیم و یک جلسه‌ی هفتگی داشته باشیم برای بحث و گفت‌وگو درباره‌ی اون بخش.

اما چرا این کتاب رو انتخاب کردیم؟ چند دلیل داشتیم:

۱. ساختن یک روتین سبک و منظم برای مطالعه: شاید این روتین بتونه کمک کنه از دام کمال‌گرایی نجات پیدا کنیم؛ اینکه برای به اشتراک‌گذاری یا یادگیری، لازم نیست همیشه موضوع خیلی پیچیده یا عجیبی مطرح بشه.

۲. زبان ساده و روان کتاب: باعث می‌شد هم خوندنش آسون‌تر باشه، هم گفت‌وگو راجع بهش.

۳. تمرکز بر مسائل بنیادی ولی مهم: کتاب ابزار یا تکنیک خاصی یاد نمی‌ده، ولی یک دید خوبی می‌ده که می‌تونه در تصمیم‌های کوچک فنی تأثیرگذار باشه. مثلاً اینکه اگر بشه یه قطعه کد رو به دو روش نوشت، کدوم روش احتمالاً پایدارتر، خواناتر یا قابل‌نگهداری‌تره؟

۴. نبود جزییات فنی پیچیده: خوندنش زمان زیادی نمی‌برد و همین باعث می‌شه برای شروع یک حلقه‌ی مطالعه جمعی گزینه‌ی خوبی باشه. اگر تجربه‌ی خوبی بود، می‌تونیم در ادامه سراغ موضوعات عمیق‌تر هم بریم.

۵. نزدیکی مثال‌های کتاب به زبان‌های جاوا و سی: که باعث می‌شه مثال‌ها ملموس‌تر باشن، چون بخش زیادی از کدهای ما هم به جاوا و کاتلین نوشته شدن.

۶. هم‌زمانی با نیاز تیم به بازبینی کد: با توجه به عمر پروژه و روندهای اخیر، برخی تسک‌ها مربوط به بازنگری در بخش‌هایی از کد بودن. این کتاب می‌تونست دید بهتری برای انجام این بازبینی‌ها بهمون بده.

امیدواریم این تجربه‌ی جمعی، فارغ از نتیجه‌ی نهایی، بتونه برامون شروعی باشه برای بیشتر فکر کردن به طراحی نرم‌افزار، بهتر دیدن کدهایی که می‌نویسیم، و شنیدن صداهای مختلف در مورد مسائل فنی روزمره‌ای که شاید تا حالا از کنارشون بی‌تفاوت رد می‌شدیم.

تیم ما مشتاقه که بخش‌هایی از نتیجه‌ی این جلسات رو در بلاگ شرکت منتشر کنه، شاید نه فقط برای مستندسازی مسیرمون، بلکه برای به اشتراک گذاشتن چیزهایی که فکر می‌کنیم برای دیگر تیم‌ها هم مفید یا الهام‌بخش باشن.