کتابخانه تپلیغ برای برنامه نویسان با B4A00 نظر

کتابخانه تپلیغ برای برنامه نویسان با B4A

به تازگی با آشنایی با سیستم تبلیغاتی تپلیغ تصمیم گرفتم که یک کتابخانه مخصوص B4A کد نویسی کنم و برای شما عزیزان به اشتراک بگذارم .

پس آموزشی که در پایین قرار داده ام در صورتی امکان پذیر است که در وب سایت تپلیغ به نشانی : http://tapligh.com/ ثبت نام کرده باشید.

راهنمای استفاده از کتابخانه تپلیغ

جهت راه اندازی تبلیغات تپلیغ در اپلیکیشن شما، ابتدا باید مراحل  زیر را در پروژه خود انجام دهید.

فایل حاوی SDK تپلیغ را از آدرس زیر دریافت کنید و محتویات آن را در پوشه‌ای ذخیره کنید.

dl

 

افزودن SDK تپلیغ به کتابخانه های B4A

فایل های موجود در پوشه Library فایل دانلود شده را به پوشه‌ی Additional Libraries اضافه کنید. پروژه B4A خود را باز کنید و در بخش  Libraries Manager کلیک راست کرده و گزینه Refresh را انتخاب کنید تا فهرست به‌روزرسانی شود. سپس کتابخانه‌ی تپلیغ را از لیست پیدا کرده و آن را به پروژه خود اضافه کنید.

 

آپدیت فایل Manifest

از منو Project گزینه Manifest Editor را انتخاب کرده و خطوط زیر را به manifest برنامه خود اضافه کنید.

AddPermission(android.permission.INTERNET)
AddPermission(android.permission.ACCESS_NETWORK_STATE)
AddPermission(android.permission.ACCESS_COARSE_LOCATION)

AddApplicationText(<activity
android:name="com.tapligh.sdk.ADView.ADView"
android:configChanges="orientation|screenSize|screenLayout|keyboardHidden|uiMode"
android:theme="@android:style/Theme.Translucent.NoTitleBar" />
<receiver android:name="com.tapligh.sdk.ADView.ADsReceiver">
<intent-filter android:priority="999">
<action android:name="android.intent.action.PACKAGE_INSTALL" />
<action android:name="android.intent.action.PACKAGE_ADDED" />
<action android:name="android.intent.action.PACKAGE_REMOVED" />
<data android:scheme="package" />
</intent-filter>
</receiver>)

در کد فوق دسترسی‌ موقعیت (ACCESS_COARSE_LOCATION) اختیاری است اما درصورتیکه این دسترسی را نیز در برنامه خود قرار دهید، تبلیغات نشان‌داده‌شده به کاربر از کیفیت بالاتری برخوردار خواهد بود.

 2

دریافت توکن تپلیغ

ابتدا وارد پنل مدیریت تپلیغ شده و با تعریف یک اپلیکیشن جدید با عنوان پکیج اپلیکیشن اندرویدی خود، یک توکن دریافت کنید.

 

شروع کار با کتابخانه

برای ارتباط با کتابخانه‌ی تپلیغ باید از کلاس TaplighAd استفاده کنید. کافیست یک شیء از آن داشته باشید. این دسترسی با نوشتن خط زیر در بخش Globals قابل انجام است:


Sub Globals

   Dim Tapligh As TaplighAd

End Sub

 

سپس در activity اصلی برنامه‌ی خود در قسمت Activity_Create خط زیر را اضافه کنید:

Tapligh.Initialize("Tapligh",Token)

ورودی Token کدی است که در گام قبل از پنل تپلیغ دریافت کردید.

 

نمایش مستقیم تبلیغات

هرکجا که نیاز دارید در همان لحظه تپلیغ به کاربر نمایش داده شود، از کد زیر استفاده کنید. این کد معمولا مناسب موقعیتهایی است که از دکمه نمایش تپلیغ استفاده میکنید و میخواهید به کاربر در ازای نمایش تپلیغ امتیاز دهید:

Tapligh.ShowAd(AdType,IsCloseEnabled)

ورودی AdType: نوع تبلیغی که می خواهید نمایش یابد. مقادیری که این روش می تواند بگیرد:

Tapligh.IMAGE
Tapligh.VIDEO

ورودی IsCloseEnabled: شما میتوانید مشخص کنید که ویدیوی تپلیغ در حین نمایش قابلیت بسته شدن داشته باشد یا خیر. از این قابلیت برای ویدیوهای جایزهای میتوانید استفاده کنید و در صورت فعالسازی این ورودی کاربر را ملزم به مشاهده ویدیو تا انتها نمایید. این ورودی مقدار True یا False می گیرد.

 

نمایش تبلیغات بینابینی (غیرمستقیم)

گاهی اتفاق میافتد که نیاز دارید تا نمایش یک تپلیغ به صورت مرتب با اجرای یک صفحه یا کلیک بر روی یک عملیات انجام نشود. در این صورت میتوانید از کد زیر استفاده کنید:

Tapligh. ShowInterstitialAd(AdType,IsCloseEnabled)

 

در این حالت نمایش تپلیغ به صورت غیر مستقیم انجام میشود؛ به این صورت که به صورت پیش فرض بعد از هر 4 بار اجرای این متد در دفعه پنجم نمایش تپلیغ صورت میگیرد. این متد مورد استفاده بازی ها و برنامه هایی است که قصد نمایش تپلیغ به صورت نامنظم دارند. به طور مثال توسعه دهنده های بازی میتوانند در فاصله بین مراحل بازی خود این کار را انجام دهند. در این حالت با فاصله هر 5 باری که کاربر یک دور از بازی را انجام میدهد نمایش تپلیغ به وی صورت میپذیرد. توسعه دهنده های برنامه های کاربردی نیز میتوانند در ازای کلیک بر روی یکی از اجزای برنامه ای

Tapligh.SetAdShowInterval(3)

ن نمایش را پیاده سازی کنند.

تمامی ورودی های این متد همانند متد ShowAd بوده و تغییری از این بابت ندارد.

همانطور که در بالاتر عنوان شد این متد به صورت پیشفرض با فاصله هر 5 بار تکرار از دفعات اجرا شدن اقدام به نمایش تپلیغ میکند. در صورتیکه بخواهید این عدد را تغییر دهید از متد زیر استفاده کنید.

 

چک کردن وجود تپلیغ پیش از نمایش

شما میتوانید پیش از آنکه تپلیغ را نمایش دهید از کد زیر استفاده کرده و با استفاده از پاسخ آن از وجود یا عدم وجود تپلیغ اطلاع کسب کنید.

Tapligh.hasAvailableAd(AdType)

ورودی AdType نوع تبلیغ می باشد.

 

استفاده از لیسنرها

برای مشاهده Listener ها در یک فضای خالی Sub را تایپ کرده سپس یک Space زده و Tab را فشار دهید تا لیست Event ها به نمایش دربیاید. اکنون TaplighAd را انتخاب کنید :

 3

 

امکانات دیگر

برای فعال یا غیرفعال سازی حالت تست از کد زیر استفاده کنید:

Tapligh.SetTestEnable(True)

برای فعال یا غیرفعال سازی حالت دیباگ از کد زیر استفاده کنید:

Tapligh.Debug=True

حتما پروژه را در حالت Release تست کنید.

فایل نمونه استفاده در پوشه Sample از فایل دریافتی قرار دارد.

 

کد نویسی توسط : miladesign.ir



نسخه PDF این مطلب را دانلود کنید





حق نشر مطالب اوکسو :

 

 

قابل توجه علاقه مندان و کپی کنندگان گرامی ، تمامی مطالب این وب سایت تحت مجوز خالق

(Creative Commons)  می باشد و اجازه کپی کردن ، استفاده تجاری مطالب بدون اجازه

صاحب اثر مجاز نمی باشد و طبق مجوز اثر پیگرد قانونی به همراه خواهد داشت.

مجوز کریتیو کامنز
این کار مجوز دارد تحت مجوز کریتیو کامنز نسبت‌دادن-غیرتجاری-بدون انشقاق ۴٫۰ بین‌المللی.

این مطلب پایان یافت و امیدواریم به نتیجه دلخواهتان رسیده باشید . اگر به نتیجه

دلخواهتان هنوز دست نیافته اید , میتوانید برای رفع مشکل به تالار گفتمان اوکسوف

مراجعه کنید و سوال خود را مطرح کنید.

 

تالار گفتمان اوکسوف

 

 

همچنین میتوانید ما را در شبکه های اجتماعی نیز دنبال کنید و از جدید ترین اخبار ما با خبر شوید :

 

 

3491498_823


نظر شما

مطالب مرتبط