چرا Taproll؟​

Google IMA SDK انتخاب پیش‌فرض برای پخش تبلیغات VAST/VMAP در اندروید است، اما یک ضعف اساسی دارد: برای دریافت و نمایش تبلیغات به اتصال مداوم اینترنت نیاز دارد. در زمان قطعی اینترنت — که در ایران بارها تجربه شده — پخش تبلیغات مبتنی بر IMA کاملاً از کار می‌افتد. علاوه بر این، IMA برای شرایط شبکه ایران طراحی نشده، پشتیبانی پیش‌فرض از زبان فارسی ندارد، و کنترل محدودی روی رابط کاربری تبلیغات می‌دهد. Taproll برای حل تمام این مشکلات ساخته شده.

بدون نیاز به اینترنت​

Taproll برای نمایش تبلیغات نیازی به اینترنت ندارد. IMA با قطع شدن اتصال از کار می‌افتد — Taproll درآمد تبلیغاتی شما را بدون توجه به وضعیت شبکه حفظ می‌کند.

عملکرد بالا​

Taproll مبتنی بر حداقل امکانات، سبک‌سازی، حجم کم، بیلد سریع‌تر و تداخل نسخه کمتر است. نتایج بنچمارک نشان می‌دهد که شروع به کار و نمایش اولین فریم تبلیغ pre-roll حدود ۱.۹ برابر سریع‌تر از IMA است — تقریباً ۱.۴ ثانیه در مقابل ۲.۶۵ ثانیه در شرایط یکسان.

کنترل ساده رابط کاربری​

می‌توانید ظاهر تبلیغات را از طریق یک فایل XML با XmlOverlayAdapter شخصی‌سازی کنید، یا با پیاده‌سازی اینترفیس AdOverlay کنترل بیشتری روی دکمه رد کردن، تایمر شمارش معکوس و نمای هدر داشته باشید. المان‌های رابط کاربری با ویجت‌های استاندارد اندروید (TextView یا کلاس‌های مشتق از آن) ساخته می‌شوند — نه Viewهای سفارشی مبهم.

وابستگی سبک​

تنها وابستگی Taproll، ExoPlayer (Media3) است. بدون Google IMA SDK، بدون Google Play Services — یک کتابخانه سبک که حجم کمی به بیلد شما اضافه می‌کند.

توسعه فعال​

Taproll فعالانه توسعه داده می‌شود و مدام به‌روزرسانی می‌شود. نیاز به ویژگی جدید دارید یا باگی پیدا کرده‌اید؟ یک بحث باز کنید — تیم توسعه بازخوردهای کاربران را بررسی و اولویت‌بندی می‌کند.

نحوه یکپارچه‌سازی​

Taproll از طریق TaprollAdLoader با ExoPlayer یکپارچه می‌شود که اینترفیس AdsLoader مربوط به Media3 را پیاده‌سازی می‌کند. با متصل کردن آن از طریق DefaultMediaSourceFactory.setLocalAdInsertionComponents()، تبلیغات به صورت خودکار در نقاط cue پخش می‌شوند بدون آنکه نیاز به کد اضافه برای مدیریت تبلیغات باشد.

// راه‌اندازی ExoPlayer — تنظیمات حداقلی
val adsLoader = TaprollAdLoader.Builder(context)
    .setAdEventListener { adEvent -> /* مدیریت رویداد */ }
    .setAdErrorListener { adError -> /* مدیریت خطا */ }
    .build()

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

شروع به کار​

Taproll بخشی از Tapsell Mediation SDK است و کاملاً با آن یکپارچه است. اداپتر legacy یکپارچه‌سازی با Taproll را به پروژه خود اضافه کنید:

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

برای راهنمای کامل راه‌اندازی و جزئیات یکپارچه‌سازی با ExoPlayer، به مستندات Taproll و اپلیکیشن نمونه سر بزنید.

چرا Maven تپسل؟​

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

• منبع واحد — SDK های تپسل و وابستگی‌هایشان از یک مکان ارائه می‌شوند.
• دانلود سریع‌تر — سرورها برای توسعه‌دهندگان منطقه بهینه‌سازی شده‌اند.
• قابلیت اطمینان بالاتر — دیگر خبری از خطاهای موقتی در زمان اختلال اینترنت نیست.

افزودن مخزن​

بسته به پیکربندی Gradle پروژه‌تان، آدرس Maven تپسل را به یکی از روش‌های زیر اضافه کنید:

// settings.gradle
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // مخزن تپسل
        maven { url = uri("https://maven.tapsell.ir") }
        google()
        mavenCentral()
    }
}

گام‌های بعدی​

پس از افزودن مخزن، راهنمای کامل راه‌اندازی SDK اندروید را دنبال کنید تا وابستگی تپسل را به ماژول اپلیکیشن خود اضافه کرده و SDK را مقداردهی اولیه کنید:

شروع سریع اندروید — راه‌اندازی اپلیکیشن

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

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

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

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

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

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

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

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

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

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