پیاده‌سازی تبلیغات ویدئویی (جایزه دار-بینابینی) و تبلیغات بنری تمام صفحه در پروژه B4A
پیاده‌سازی تبلیغات بنری استاندارد در پروژه B4A
پیاده‌سازی تبلیغات بنری هم‌نما (Native Banner) در پروژه B4A
پیاده‌سازی تبلیغات ویدئویی هم‌نما (Native Video) در پروژه B4A
موارد پیشرفته‌تر در SDK
[ht_message mstyle="danger" title="نکته Build پروژه" " show_icon="" id="" class="" style="" ]برای Build کردن پروژه حتما نوع Build را در حالت Release قرار دهید.[/ht_message]
فایل حاوی SDK تپسل را از آدرس زیر دریافت کنید و محتویات آن را در پوشه‌ای ذخیره کنید. فایل‌های TapsellSDK.jar و TapsellSDK.xml را از SDK تپسل به پوشه‌ی Libraries در محل نصب B4A اضافه کنید. پروژه B4A خود را باز کنید و در بخش Libraries Manager، کلیک راست کرده و گزینه Refresh را انتخاب کنید تا فهرست به‌روزرسانی شود. سپس کتابخانه‌ی تپسل را از لیست پیدا کرده و آن را به پروژه خود اضافه کنید.
#Region Activity Attributes
...
#AdditionalJar : tapsellsdk-b4a-4.0.4.jar
#AdditionalJar : gson-2.8.5.jar
#End Region
در صورتی که پروژه‌ی خود را در حالت debug اجرا می‌کنید خط زیر را در بخش Project Attributes فایل اصلی پروژه خود اضافه کنید:
#Region Project Attributes
...
#DebuggerForceStandardAssets : true
#End Region
از منو Project گزینه Manifest Editor را انتخاب کرده و خطوط زیر را به manifest برنامه خود اضافه کنید.
AddManifestText( … <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> <uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.READ_PHONE_STATE"/> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>) … 'End of default text. AddApplicationText( <!-- Required Activity --> <activity android:name="ir.tapsell.sdk.TapsellAdActivity" android:configChanges="keyboardHidden|orientation|screenSize"/> )در کد فوق سترسی موقعیت (ACCESS_COARSE_LOCATION) اختیاری است اما درصورتیکه این دسترسی را نیز در برنامه خود قرار دهید، تبلیغات نشان‌داده‌شده به کاربر از کیفیت بالاتری برخوردار خواهد بود.
برای ارتباط با کتابخانه‌ی تپسل باید از کلاس
Tapsell استفاده کنید. کافیست یک شیء از آن داشته باشید. این دسترسیبا نوشتن خط زیر در بخش Globals قابل انجام است:
Sub Globals Private tapsell As Tapsell End Sub
سپس در activity اصلی برنامه‌ی خود در قسمت Activity_Create خط زیر را اضافه کنید:
tapsell.initialize(appKey)
ورودی appKey کلید تپسلی است که در گام قبل از پنل تپسل دریافت کردید.
نمایش یک تبلیغ ویدئویی در اپلیکیشن به دو صورت ممکن است صورت پذیرد. یک روش، نمایش تبلیغ بصورت stream می‌باشد. در این حالت، همزمان که کاربر درحال مشاهده بخشی از تبلیغ است، ادامه آن از اینترنت لود میگردد. ممکن است به دلیل کندی سرعت اینترنت، در این حالت کاربر با مکث‌های متعددی در هنگام دریافت و مشاهده تبلیغ مواجه شود. برای اینکه کاربر در هنگام نمایش تبلیغ منتظر نماند و تجربه کاربر در استفاده از اپلیکیشن بهبود یابد،روش دیگری نیز در SDK تپسل تعبیه شده است که در آن ابتدا فایل ویدئوی تبلیغاتی بطور کامل بارگذاری شده و سپس تبلیغ نمایش داده میشود.
همچنین در تپسل، تبلیغ می تواند در ناحیه‌های مختلفی از برنامه شما (مانند فروشگاه، انتهای هر مرحله، ابتدای مرحله جهت دریافت امتیاز دوبرابر، دریافت بنزین/لایف و ...) پخش شود. در تپسل به این ناحیه‌ها zone گفته می شود. ناحیه‌های هر اپلیکیشن در پنل تپسل تعریف می شوند.
با اجرای تابع زیر، میتوانید یک درخواست تبلیغ به تپسل ارسال کرده و یک تبلیغ دریافت نمایید:
tapsell.requestAd(zoneId,isCached)
هر درخواست شامل یک ورودی zoneId است که برای استفاده از ناحیه پیش فرض می توانید از یک رشته خالی استفاده نمایید. اطلاعات بیشتر درباره نواحی نمایش تبلیغ را می توانید از تیم فنی تپسل دریافت کنید. ورودی isCached یک متغیر Boolean می‌باشد که نشان می‌دهد که آیا تبلیغ باید ابتدا دانلود شده و سپس به کاربر نشان داده شود یا خیر.
[ht_message mstyle="danger" title="کش کردن ویدئو" " show_icon="" id="" class="" style="" ]تنها در ناحیه‌هایی که کاربر با احتمال زیادی پس از باز کردن اپلیکیشن تبلیغ آن را مشاهده می‌کند، از تبلیغ Cached استفاده کنید. جهت توضیحات بیشتر درباره روش انتخاب متد دریافت مناسب، اینجا را مطالعه کنید.[/ht_message]
نتیجه درخواست بصورت Event به یک Sub در برنامه شما بازگردانده میشود. در صورت وجود یک تبلیغ، شناسه آن تبلیغ به یک ساب‌روتین (Sub) با نام Tapsell_onAdAvailable در کد شما داده میشود و می‌بایست آن را جهت نمایش تبلیغ ذخیره نمایید. در گام بعدی همه روتین‌های مورد استفاده در تپسل آورده و توضیح داده شده‌اند.
در Activity پروژه خطوط زیر را اضافه کنید:
Sub Tapsell_onAdAvailable (zoneId As String, adId As String) ' ad is available to show, store adId to show it later ad = adId End Subتوضیحات روتین‌های مختلف و شرایط اجرا شدن آن‌ها در جدول ۱ آمده است.Sub Tapsell_onNoAdAvailable (zoneId As String) ' No ad available now End Sub
Sub Tapsell_onNoNetwork (zoneId As String) ' No network End Sub
Sub Tapsell_onError (zoneId As String, error As String) ' Encountered and error while connecting to tapsell End Sub
Sub Tapsell_onExpiring (zoneId As String, adId As String) ' The stored ad with given adId is expiring and cannot be shown anymore ad = Null End Sub
Sub Tapsell_onOpened (zoneId As String, adId As String) ' The ad is being opened (shown) End Sub
Sub Tapsell_onClosed (zoneId As String, adId As String) ' The ad is being closed and ad show has finished, returning to user's Activity End Sub
جدول ۱ Sub های مربوط به دریافت نتیجه درخواست تبلیغ
| تابع | توضیحات (زمان اجرا) |
|---|---|
| Tapsell_onError (String) | هنگامی که هر نوع خطایی در پروسه‌ی دریافت تبلیغ بوجود بیاید |
| Tapsell_onAdAvailable (String, String) | زمانی که تبلیغ دریافت شده و آماده‌ی نمایش باشد. |
| Tapsell_onNoAdAvailable (String) | در صورتی که تبلیغی برای نمایش وجود نداشته باشد. |
| Tapsell_onNoNetwork (String) | زمانی که دسترسی به شبکه موجود نباشد. |
| Tapsell_onExpiring (String, String) | زمانی که تبلیغ منقضی شود. هر تبلیغ مدت زمان مشخصی معتبر است و در صورتی که تا قبل از آن نمایش داده نشود منقضی شده و دیگر قابل نمایش نخواهد بود. |
| Tapsell_onOpened (String, String) | زمانی که تبلیغ شروع به پخش شود. |
| Tapsell_onClosed (String, String) | زمانی که پخش تبلیغ تمام شود و کاربر به اکتیویتی برنامه/بازی باز می گردد. |
tapsell.showAd(adId,back_disabled,immersive_mode,rotation_mode,show_dialog)
ورودی adId شناسه تبلیغ است که در گام قبل و در روتین Tapsell_onAdAvailable به شما داده شده‌است. ورودی‌های disable_back و immersive_mode از نوع Boolean هستند که جهت قفل کردن کلید back گوشی در هنگام نمایش تبلیغ جایزه‌دار و همینطور نمایش تبلیغ در حالت Immersive Mode (عدم نمایش دکمه‌های روی اسکرین و نمایش ویدئو بصورت Fullscreen در اندروید 4.4 و بالاتر) بکار می‌روند. ورودی show_dialog نیز یک متغیر Boolean است که در صورتی که مقدار آن برابر True باشد، در هنگام زدن دکمه Back در زمان نمایش ویدئو جایزه‌دار، یک اخطار به کاربر نشان داده میشود. ورودی rotation_mode برای تعیین جهت نمایش ویدئو در دستگاه ( Orientation ) بکار می‌رود و مقادیر مختلف قابل استفاده برای آن در جدول ۲ آمده است.
جدول ۲ مقادیر قابل استفاده برای rotation_mode
| مقدار | توضیحات |
|---|---|
| tapsell.ROTATION_LOCKED_PORTRAIT |
نمایش ویدئو در حالت Portrait |
| tapsell.ROTATION_LOCKED_LANDSCAPE |
نمایش ویدئو در حالت Landscape |
| tapsell.ROTATION_UNLOCKED |
تعدم قفل کردن چرخش گوشی |
| tapsell.ROTATION_LOCKED_REVERSED_PORTRAIT |
نمایش ویدئو در حالت Reversed Portrait |
| tapsell.ROTATION_LOCKED_REVERSED_LANDSCAPE |
نمایش ویدئو در حالت Reversed Landscape |
Sub Tapsell_onAdShowFinished (zoneId As String, adId As String, completed As Boolean, rewarded As Boolean) ' showing ad was finished End Subدر نتیجه‌ی دریافت شده، adId و zoneId شناسه مربوط به تبلیغ و محل نمایش آن در اپلیکیشن است. دو متغیر
completed و rewarded از نوع Boolean بوده و نشان دهنده‌ی این است که کاربر ویدئو را تا انتها مشاهده کرده است یا خیر و تبلیغ نمایش داده شده از نوع جایزه‌دار بوده است یا خیر. در صورتی که کاربر تبلیغی از نوع جایزه دار را تا انتها مشاهده کند و هردو مقدار completed و rewarded برابر با True باشند، ، باید جایزه درون برنامه (سکه، اعتبار، بنزین یا ...) را به کاربر بدهید.
برای ارتباط با کتابخانه‌ی تپسل باید از کلاس
Tapsell استفاده کنید. کافیست یک شیء از آن داشته باشید. این دسترسیبا نوشتن خط زیر در بخش Globals قابل انجام است:
Sub Globals Private tapsell As Tapsell End Sub
سپس در activity اصلی برنامه‌ی خود در قسمت Activity_Create خط زیر را اضافه کنید:
tapsell.initialize(appKey)
ورودی appKey کلید تپسلی است که در گام قبل از پنل تپسل دریافت کردید.
جهت نمایش بنر استاندارد، باید محلی برای نمایش آن در صفحه در نظر بگیرید. بنر استاندارد، دارای سایزهای استانداردی است که در SDK تپسل مشخص شده اند. جهت نمایش بنر، از تابع زیر استفاده کنید:
tapsell.fillBannerAd(adPanel, zoneId, bannerSize)
ورودی adPanel از جنس Panel بوده و نشان دهنده محلی است که برای نمایش تبلیغ انتخاب کرده‌اید. پارامترzoneId شناسه تبلیغ‌گاه بنر استاندارد است که آن را میتوانید از داشبورد تپسل دریافت کنید. ورودی آخر، نوع بنر را مشخص می‌کند. مقادیر قابل قبول انواع بنر، در کلاس Tapsell بصورت tapsell.BANNER_WxH آورده شده‌اند که W و H به ترتیب عرض و طول بنر استاندارد هستند.
اگر میخواهید callback های مربوط به نمایش بنر را مدیریت کنید میتوانید از قطعه کد زیر استفاده کنید:
Sub Tapsell_onNoBannerAdAvailable (zoneId As String)
//Todo
End Sub
Sub Tapsell_onBannerNoNetwork (zoneId As String)
//Todo
End Sub
Sub Tapsell_onBannerAdRequestFilled (zoneId As String)
//Todo
End Sub
Sub Tapsell_onBannerAdMadeHidden (zoneId As String)
//Todo
End Sub
Sub Tapsell_onBannerAdError (zoneId As String, error As String)
/Todo
End Sub
به صورت پیش فرض زمانی که تبلیغات بنری دریافت میشود به صفحه اضافه میگردد و Visible می شود. اگر بنا به هر دلیلی میخواهید بنر را مخفی کنید یا بنر مخفی شده را نمایش دهید از این کد استفاده کنید:
برای ارتباط با کتابخانه‌ی تپسل باید از کلاس
Tapsell استفاده کنید. کافیست یک شیء از آن داشته باشید. این دسترسیبا نوشتن خط زیر در بخش Globals قابل انجام است:
Sub Globals Private tapsell As Tapsell End Sub
سپس در activity اصلی برنامه‌ی خود در قسمت Activity_Create خط زیر را اضافه کنید:
tapsell.initialize(appKey)
ورودی appKey کلید تپسلی است که در گام قبل از پنل تپسل دریافت کردید.
در تبلیغات هم‌نما، شما قادر هستید ویژگی‌های ظاهری هر یک از اجزای تبلیغ (اندازه، محل قرارگیری، رنگ فونت و…) را بصورتی که هماهنگ با محتوای اپلیکیشن شما باشد تعیین کنید. لذا باید Layout هم‌نما اپلیکیشن خود را که مدنظرتان است ایجاد نموده و از آن برای نمایش تبلیغ استفاده نمایید. این Layout می‌تواند شامل یک لوگو، یک عنوان، توضیحات، یک نشانگر آگهی بودن، یک بنر و یک دکمه برای دعوت از کاربر به انجام عمل تبلیغ باشد. جهت نمایش تبلیغ باید این اجزا را به SDK تپسل بدهید تا تبلیغ را در آن نمایش دهد.
جهت ایجاد Layout تبلیغ هم‌نما میتوانید از Designer استفاده کرده و یک قالب مانند زیر آماده کنید.
در تپسل، تبلیغ می تواند در ناحیه‌های مختلفی از برنامه شما (مانند منو اصلی، بین پست‌ها و ...) پخش شود. در تپسل به این ناحیه‌ها zone گفته می شود. ناحیه‌های هر اپلیکیشن در داشبورد تپسل تعریف می شوند.
با اجرای تابع زیر، میتوانید یک درخواست تبلیغ به تپسل ارسال کرده و یک تبلیغ دریافت نمایید:
tapsell.requestNativeBannerAd(zoneId)
هر درخواست شامل یک ورودی شناسه تبلیغ‌گاه (zoneId) است که نشانگر محل نمایش تبلیغ در اپلیکیشن شماست. تبلیغ‌گاه مرتبط با این شناسه در داشبورد تپسل باید از نوع بنری هم‌نما باشد.
نتیجه درخواست بصورت Event به یک Sub در برنامه شما بازگردانده میشود. در صورت وجود یک تبلیغ، شناسه آن تبلیغ به یک ساب‌روتین (Sub) با نام Tapsell_onNativeBannerAdAvailable در کد شما داده میشود و می‌بایست آن را جهت نمایش تبلیغ ذخیره نمایید. در گام بعدی همه روتین‌های مورد استفاده در تپسل آورده و توضیح داده شده‌اند.
در Activity اصلی خود خطوط زیر را اضافه کنید:
Sub Tapsell_onNativeBannerAdAvailable (zoneId As String, adId As String) ' Native ad is available and ready to show ad = adId End Subتوضیحات روتین‌های مختلف و شرایط اجرا شدن آن‌ها در جدول ۱ آمده است.Sub Tapsell_onNoNativeBannerAdAvailable (zoneId As String) ' No ad available now End Sub
Sub Tapsell_onNoNetwork (zoneId As String) ' No network End Sub
Sub Tapsell_onError (zoneId As String, error As String) ' Encountered and error while connecting to tapsell End Sub
جدول ۱ روتین‌های مربوط به دریافت نتیجه درخواست تبلیغ هم‌نما
| تابع | توضیحات (زمان اجرا) |
|---|---|
| Tapsell_onError (String) | هنگامی که هر نوع خطایی در پروسه‌ی دریافت تبلیغ بوجود بیاید |
| Tapsell_onNativeBannerAdAvailable (String, String) | زمانی که تبلیغ دریافت شده و آماده‌ی نمایش باشد. |
| Tapsell_onNoNativeBannerAdAvailable (String) | در صورتی که تبلیغی برای نمایش وجود نداشته باشد. |
| Tapsell_onNoNetwork (String) | زمانی که دسترسی به شبکه موجود نباشد. |
tapsell.fillNativeBannerAd(adId,lblTitle,lblDescription,ivBanner,ivLogo,btnCallToAction,lblSponsored,adContainer)
ورودی adId شناسه تبلیغ است که در گام قبل و در روتین Tapsell_onNativeBannerAdAvailable به شما داده شده‌است. ورودی‌های بعدی از نوع ImageView، Label، Panel و یا Button هستند که به ترتیب نشانگر عنوان تبلیغ، توضیحات تبلیغ، پنل نمایش ویدئو، لوگو، دکمه دعوت از کاربر و نشانگر آگهی بودن می‌باشند. آخرین ورودی نیز Panel دربرگیرنده تبلیغ هست که اختیاری بوده و می‌تواند Null باشد.
برای نمایش تبلیغ حتما باید عنوان و یکی از دو مورد دکمه دعوت از کاربر و Panel دربرگیرنده به SDK ارسال شوند.
برای ارتباط با کتابخانه‌ی تپسل باید از کلاس
Tapsell استفاده کنید. کافیست یک شیء از آن داشته باشید. این دسترسیبا نوشتن خط زیر در بخش Globals قابل انجام است:
Sub Globals Private tapsell As Tapsell End Sub
سپس در activity اصلی برنامه‌ی خود در قسمت Activity_Create خط زیر را اضافه کنید:
tapsell.initialize(appKey)
ورودی appKey کلید تپسلی است که در گام قبل از پنل تپسل دریافت کردید.
در تبلیغات هم‌نما، شما قادر هستید ویژگی‌های ظاهری هر یک از اجزای تبلیغ (اندازه، محل قرارگیری، رنگ فونت و…) را بصورتی که هماهنگ با محتوای اپلیکیشن شما باشد تعیین کنید. لذا باید Layout هم‌نما اپلیکیشن خود را که مدنظرتان است ایجاد نموده و از آن برای نمایش تبلیغ استفاده نمایید. این Layout می‌تواند شامل یک لوگو، یک عنوان، توضیحات، یک نشانگر آگهی بودن، یک بنر و یک دکمه برای دعوت از کاربر به انجام عمل تبلیغ باشد. جهت نمایش تبلیغ باید این اجزا را به SDK تپسل بدهید تا تبلیغ را در آن نمایش دهد.
جهت ایجاد Layout تبلیغ هم‌نما میتوانید از Designer استفاده کرده و یک قالب مانند زیر آماده کنید.
در تپسل، تبلیغ می تواند در ناحیه‌های مختلفی از برنامه شما (مانند منو اصلی، بین پست‌ها و ...) پخش شود. در تپسل به این ناحیه‌ها zone گفته می شود. ناحیه‌های هر اپلیکیشن در داشبورد تپسل تعریف می شوند.
با اجرای تابع زیر، میتوانید یک درخواست تبلیغ به تپسل ارسال کرده و یک تبلیغ دریافت نمایید:
tapsell.requestNativeVideoAd(zoneId)
هر درخواست شامل یک ورودی شناسه تبلیغ‌گاه (zoneId) است که نشانگر محل نمایش تبلیغ در اپلیکیشن شماست. تبلیغ‌گاه مرتبط با این شناسه در داشبورد تپسل باید از نوع بنری هم‌نما باشد.
نتیجه درخواست بصورت Event به یک Sub در برنامه شما بازگردانده میشود. در صورت وجود یک تبلیغ، شناسه آن تبلیغ به یک ساب‌روتین (Sub) با نام Tapsell_onNativeBannerAdAvailable در کد شما داده میشود و می‌بایست آن را جهت نمایش تبلیغ ذخیره نمایید. در گام بعدی همه روتین‌های مورد استفاده در تپسل آورده و توضیح داده شده‌اند.
در Activity اصلی خود خطوط زیر را اضافه کنید:
Sub Tapsell_onNativeVideoAdAvailable (zoneId As String, adId As String) ' Native ad is available and ready to show ad = adId End Subتوضیحات روتین‌های مختلف و شرایط اجرا شدن آن‌ها در جدول ۱ آمده است.Sub Tapsell_onNoNativeVideoAdAvailable (zoneId As String) ' No ad available now End Sub
Sub Tapsell_onNoNetwork (zoneId As String) ' No network End Sub
Sub Tapsell_onError (zoneId As String, error As String) ' Encountered and error while connecting to tapsell End Sub
جدول ۱ روتین‌های مربوط به دریافت نتیجه درخواست تبلیغ هم‌نما
| تابع | توضیحات (زمان اجرا) |
|---|---|
| Tapsell_onError (String) | هنگامی که هر نوع خطایی در پروسه‌ی دریافت تبلیغ بوجود بیاید |
| Tapsell_onNativeVideoAdAvailable (String, String) | زمانی که تبلیغ دریافت شده و آماده‌ی نمایش باشد. |
| Tapsell_onNoNativeVideoAdAvailable (String) | در صورتی که تبلیغی برای نمایش وجود نداشته باشد. |
| Tapsell_onNoNetwork (String) | زمانی که دسترسی به شبکه موجود نباشد. |
tapsell.fillNativeVideoAd(adId,autoStartVideo,fullscreenOnClick,lblTitle,lblDescription,pVideoContainer,ivLogo,btnCallToAction,lblSponsored,adContainer)
ورودی adId شناسه تبلیغ است که در گام قبل و در روتین Tapsell_onNativeBannerAdAvailable به شما داده شده‌است. ورودی های autoStartVideo و fullscreenOnClick از نوع Boolean هستند. autoStartVideo مشخص کننده این است که ویدئو بعد از لود شدن در صفحه بصورت اتوماتیک اجرا شود یا خیر. همچنین fullscreenOnClick تعیین کننده این است که آیا زمان کلیک کردن کاربر روی ویدئو باید ویدئو بصورت تمام صفحه نمایش داده شود یا خیر. ورودی‌های بعدی از نوع ImageView، Label، Panel و یا Button هستند که به ترتیب نشانگر عنوان تبلیغ، توضیحات تبلیغ، پنل نمایش ویدئو، لوگو، دکمه دعوت از کاربر و نشانگر آگهی بودن می‌باشند. آخرین ورودی نیز Panel دربرگیرنده تبلیغ هست که اختیاری بوده و می‌تواند Null باشد.
برای نمایش تبلیغ حتما باید عنوان و یکی از دو مورد دکمه دعوت از کاربر و Panel دربرگیرنده به SDK ارسال شوند.
action داده شده در تابع requestAd، میتوانید از تابع زیر نیز برای چک کردن وجود تبلیغ دریافت شده استفاده کنید.
tapsell.isAdReadyToShow(zoneId As String)ورودی zoneId در این تابع، شناسه ناحیه نمایش تبلیغ است که از پنل تپسل دریافت نموده‌اید.
درصورتی که نیازمند به دانستن نسخه تپسل پیاده‌سازی شده در اپلیکیشن خود هستید، میتوانید با فراخوانی تابع زیر عنوان نسخه را دریافت نمایید.
tapsell.Version
همانطور که در بخش پیاده‌سازی SDK تپسل در اپلیکیشن گفته شد، از نسخه ۳ به بعد تپسل قابلیت نمایش ویدئو بصورت استریم و همینطور نمایش ویدئو بعد از دانلود فایل (کشینگ) را دارد. با این قابلیت، قبل از نمایش تبلیغ و در هنگامی که کاربر مشغول استفاده از اپلیکیشن است، ویدئو بطور کامل دریافت میشود و کاربر بدون هیچگونه مکثی می‌تواند ویدئو را تماشا کند.
از طرف دیگر، در اپلیکیشن‌ها و بازی‌های آنلاین، دریافت ویدئو در پس زمینه ممکن است در روند اصلی برنامه خلل ایجاد کند و آن را کند نماید.
جهت جلوگیری از اشغال پهنای باند زیاد توسط تپسل، شما میتوانید درصد مشخصی از کل پهنای باند موجود را به دانلود ویدئو اختصاص دهید. جهت انجام این عمل، تابع زیر را در آغاز برنامه و تابع initialize (قبل از درخواست تبلیغ) فراخوانی کنید.
tapsell.MaxAllowedBandwidthUsagePercentage = maxPercentage
که ورودی maxPercentage حداکثر درصدی از پهنای باند در دسترس اپلیکیشن است که SDK تپسل از آن برای دریافت ویدئو استفاده می‌کند. این پارامتر باید عددی بین 0 تا 100 باشد.
همچنین درصورتی که از سرعت دانلود واقعی کاربر در اپلیکیشن خود اطلاع دارید میتوانید به کمک تابع زیر، مقدار حداکثر پهنای باند قابل استفاده برای دانلود ویدئو را به کمک تابع زیر تنظیم کنید.
tapsell.MaxAllowedBandwidthUsage = maxBpsSpeed
ورودی دوم این تابع، میزان حداکثر سرعت دانلود ویدئو است که باید به واحد بایت بر ثانیه داده شود.
در صورتی که در بخشی از اپلیکیشن خود میخواهید تنظیمات مربوط به محدودیت سرعت دانلود را غیرفعال نمایید، از تابع زیر استفاده کنید.
tapsell.clearBandwidthUsageConstrains()
توضیحات بیشتر درباره کشینگ و استریمینگ در SDK تپسل را اینجا بخوانید.
از نسخه اندروید 6 و بالاتر، برخی دسترسی‌ها در اندروید در زمان اجرا باید از کاربر درخواست شوند. یکی از این دسترسی‌ها، دسترسی
READ_PHONE_STATE است که توسط تپسل استفاده میشود و بدون این دسترسی، SDK تپسل قابل استفاده نیست. برای سهولت پیاده‌سازی، SDK تپسل بصورت اتوماتیک دسترسی‌ها را از کاربر درخواست می‌کند و هربار درخواست تبلیغی ارسال شود، درصورتی که دسترسی مورد نیاز موجود نباشد، این دسترسی از کاربر خواسته می شود.
در صورتی که شما میخواهید درخواست دسترسی‌ها از کاربر را به نحو دیگری در اپلیکیشن خود پیاده‌سازی نمایید، میتوانید این ویژگی پیش‌فرض را در تپسل غیر فعال کنید. جهت انجام این عمل، کافیست از تابع زیر در زمان آغاز برنامه و بعد از تابع initialize استفاده کنید.
tapsell.AutoHandlePermissions = true
با این دستور، درخواست دسترسی توسط SDK تپسل به کاربر نشان داده نمی‌شود و میتوانید بصورت مطلوب خود آن را پیاده‌سازی نمایید.
در هنگام پیاده‌سازی SDK، ممکن است بدلیل عدم رعایت نکات گفته شده و یا خطاهای دیگر، تبلیغات قابل دریافت و نمایش نباشند. حالت دیباگ جهت تسهیل فرآیند عیب‌یابی در هنگام پیاده‌سازی تعبیه شده است. با فعالسازی این حالت، میتوانید گزارش‌های لاگ نمایش داده شده توسط SDK را در logcat مشاهده کنید. برای فعالسازی حالت دیباگ کافیست از تابع زیر در آغاز برنامه استفاده کنید.
tapsell.DebugMode =trueسپس با استفاده از نرم‌افزار Android Studio، از بخش Android Monitor، قسمت logcat را باز کرده و لاگ‌های نوشته شده را بررسی کنید. برای مشاهده لاگ‌های برنامه unity، در بخش فیلتر کلمه unity را وارد کنید.
