مرحله اول : اضافه کردن کتابخانه تپلیغ
فقط کافیست کتابخانه Tapligh را از تب Libraries Manager بیسیک 4 اندروید تیک بزنید.
فقط کافیست کتابخانه Tapligh را از تب Libraries Manager بیسیک 4 اندروید تیک بزنید.
کد زیر را به منیفست اضافه کنید:
Tapligh SDK AddApplicationText( <activity android:name="com.tapligh.sdk.adview.ADView" android:theme="@android:style/Theme.Light.NoTitleBar" android:configChanges="orientation|screenSize|keyboardHidden"/> <receiver android:name="com.tapligh.sdk.adview.ADsReceiver"> <intent-filter android:priority="999"> <action android:name="android.intent.action.PACKAGE_ADDED"/> <action android:name="android.intent.action.PACKAGE_REMOVED"/> <data android:scheme="package"/> </intent-filter> </receiver>)
برای نمایش تبلیغات با استفاده از کتابخانه تپلیغ بایستی ابتدا یک نمونه از کلاس Tapligh آن ایجاد کنید سپس با فراخوانی متد مناسب نمایش تپلیغ، آن را در زمان مناسب به کاربر خود نشان دهید. در ادامه به صورت کامل درباره نحوه انجام این کار توضیح خواهیم داد.
ابتدا بایستی در صفحه ای که میخواهید تپلیغ نمایش دهید، نمونه ای از کلاس Tapligh بسازید (Sub Globals) . برای این کار خط زیر را کپی کنید:
Dim Tapligh As Tapligh
توجه داشته باشید که بایستی در اولین صفحه از برنامه خود حتما تپلیغ را اینیشتیالایز و توکن برنامه خود را به کتابخانه تپلیغ معرفی نمایید. (Sub Activity_Resume) برای این منظور از خط زیر میتوانید استفاده کنید:
If Tapligh.IsInitializeDone=False Then Tapligh.Initialize("Tapligh") Tapligh.SetToken("YOUR-TOKEN",False) End If
در این کد عبارت YOUR-TOKEN توکنی است که شما پس از ثبت برنامه خود در پنل تپلیغ آن را دریافت میکنید.
در صورتیکه مقدار ورودی دوم این متد را true قرار دهید تبلیغات تست سیستم به شما نمایش داده میشود. این حالت برای زمانی مفید است که شما در حال آزمایش هستید تا بهترین جای نمایش تپلیغ را برای برنامه خود پیدا کنید.
حال برای نمایش تبلیغ ابتدا بایستی تپلیغ را دریافت نمایید. به این منظور کد زیر را در جای مورد نظر کد خود قرار دهید:
Tapligh.LoadAd("UNIT-CODE")
برای استفاده از این متد یک ورودی لازم است. کد رشته مربوط به واحد تپلیغ است که در پنل برنامه خود ایجاد نموده اید.
با استفاده از ایونت ها میتوانید نتیجه درخواست آماده سازی تپلیغ را دریافت کنید. در صورتیکه تبلیغ آماده باشد ایونت onAdReady صدا زده میشود. ورودی این متد توکن تبلیغی است که آماده نمایش است ورودی های این متد کد واحد تپلیغ درخواست شده و توکن تبلیغی است که آماده نمایش است، در غیر اینصورت ایونت onLoadError صدا میشود.
Private Sub Tapligh_onAdReady (unitCode As String,token As String) Log("Tapligh : onAdReady -> "&unitCode) Tapligh.ShowAd(unitCode) ' نمایش تبلیغ End Sub Private Sub Tapligh_onLoadError (unitCode As String,LoadErrorStatus As Object) Log("Tapligh : onLoadError -> "&unitCode) Select LoadErrorStatus Case Tapligh.LoadErrorStatus.NoInternetAccess : Log("Tapligh : noInternetAccess") Case Tapligh.LoadErrorStatus.adUnitDisabled : Log("Tapligh : adUnitDisabled") Case Tapligh.LoadErrorStatus.adUnitNotReady : Log("Tapligh : adUnitNotReady") Case Tapligh.LoadErrorStatus.appNotFound : Log("Tapligh : appNotFound") Case Tapligh.LoadErrorStatus.InternalError : Log("Tapligh : internalError") Case Tapligh.LoadErrorStatus.NoAdReady : Log("Tapligh : noAdReady") End Select End Sub
درصورتی که ایونت ارور اجرا شد : ورودی اول این متد کد واحد تپلیغی است که درخواست آماده سازی بر روی آن اجرا شده و ورودی دوم از نوع کلاس LoadErrorStatus بوده و مقادیری که میتوانند دریافت کنند به صورت زیر هستند:
پس از آنکه متد onAdReady اجرا شد، به این معنی است که تبلیغ آماده نمایش است. بنابراین برای نمایش تبلیغ از متد زیر استفاده نمایید:
tapligh.showAd("UNIT-CODE" , new ADResultListener () { @Override public void onAdResult(ADResult adResult, String token) { } @Override public void onRewardReady(String reward) { } });
tapligh.showAd("UNIT-CODE" , new ADResultListener () { @Override public void onAdResult(ADResult adResult, String token) { } @Override public void onRewardReady(String reward) { } });
تبلیغ را در ایونت onAdReady با استفاده از کد زیر نمایش دادیم:
Tapligh.ShowAd(unitCode)
حالا برای دریافت نتیجه از دو ایونت onAdResult و onRewardReady باید استفاده کنیم
در ایونت onAdResult دو مقدار قرار میگیرد که مقدار اول نتیجه نمایش تپلیغ بوده و مقدار دوم توکنی است که برای این تپلیغ تعیین شده است. این توکن برای هر فرایند نمایش تپلیغ به صورت منحصر به فرد تعیین شده و میتوانید از طریق تابع دیگری از صحت این توکن اطمینان حاصل کنید. توضیحات کامتر مربوط به توکن در ادامه داده خواهد شد…
geClosed") Case Tapligh.ADResult.skipAndClicked : Log("Tapligh : skipAndClicked") Case Tapligh.ADResult.skipAndClosed : Log("Tapligh : skipAndClosed") Case Tapligh.ADResult.tokenExpired : Log("Tapligh : tokenExpired") End Select End Sub Private Sub Tapligh_onRewardReady (reward As String) Log("Tapligh : reward -> "&reward) End Sub
@Override public void onAdResult(ADResult adResult, String token) { Log.i("Tapligh" , "token->" + token); switch (adResult){ case tokenExpired: Log.i("Tapligh", "tokenExpired"); break; case adVideoClosedOnView: Log.i("Tapligh", "adVideoClosedOnView"); break; case adViewCompletely: Log.i("Tapligh", "adViewCompletely"); break; case adClicked: Log.i("Tapligh", "adClicked"); break; case adVideoClosedAfterFulView: Log.i("Tapligh" , "adVideoClosedAfterFulView"); break; case skipAndClicked: Log.i("Tapligh", "skipAndClicked"); break; case skipAndClosed: Log.i("Tapligh", "skipAndClosed"); break; // used for image ad case adImageClosed: Log.i("Tapligh", "adImageClosed");break; } } @Override public void onRewardReady(String reward) { Log.i("Tapligh" , "reward->" + reward); }
مقادیر مربوط به نتیجه تپلیغ به صورت زیر هستند:
نکته مهم:
Tapligh.VerifyToken("TOKEN") Private Sub Tapligh_onTokenVerified (TokenResult As Object) Select TokenResult Case Tapligh.TokenResult.INTERNAL_ERROR Case Tapligh.TokenResult.NOT_USED Case Tapligh.TokenResult.SUCCESS Case Tapligh.TokenResult.TOKEN_EXPIRED Case Tapligh.TokenResult.TOKEN_NOT_FOUND End Select End Sub
۵ حالت برای توکن میتواند رخ داده باشد. شما میتوانید تمامی این مقادیر در کلاس TokenResult مشاهده نمایید:
لطفا نظرات خود را در زمینه تجربه استفاده از SDK از طریق developers@tapligh.com ، شماره ۴۲۵۷۰۰۰۰-۰۲۱ داخلی ۴۴۴ و یا تلگرام با ما در میان بگذارید.
جهت تست پروژه خود ترجیحا از Emulator ها استفاده ننمایید.
لطفا نظرات خود را در زمینه تجربه استفاده از SDK از طریق developers@tapligh.com ، شماره ۴۲۵۷۰۰۰۰-۰۲۱ داخلی 481و یا تلگرام با ما در میان بگذارید.
تهران، هفتتیر، خیابان کریمخان، خیابان خردمند جنوبی، کوچهی ملکیان، پلاک یک
۴۲۵۷۰۰۰۰ – ۰۲۱
داخلی ۴۸۱
info@tapligh.com