مرحله اول : اضافه کردن کتابخانه تپلیغ
در فایل gradle اصلی پروژه ریپازیتوری تپلیغ را به صورت زیر به لیست ریپازیتوریهای خود اضافه کنید:
در فایل gradle اصلی پروژه ریپازیتوری تپلیغ را به صورت زیر به لیست ریپازیتوریهای خود اضافه کنید:
maven { url "https://dl.bintray.com/tapligh/Tapligh-SDK" }
خروجی نهایی فایل باید به صورت شکل زیر باشد.
در مرحله بعد دیپندنسی تپلیغ را به صورت زیر به لیست دیپندنسی های ماژول اپ خود اضافه کنید:
// for gradle 3.0 and above implementation 'com.tapligh.sdk:rewarded-sdk:3.+' // for gradle before version 3.0 compile 'com.tapligh.sdk:rewarded-sdk:3.+'
موارد پیشرفتهتر:
در صورتیکه از proguard در پروژه خود استفاده میکنید، خطوط زیر را به تنظیمات proguard خود اضافه کنید.
-keepattributes Signature -keepattributes *Annotation* -keep public class com.tapligh.sdk.**{ * ; } -keep public interface com.tapligh.sdk.**{ * ; } -keepclassmembers class * extends java.lang.Enum { <fields>; public static **[] values(); public static ** valueOf(java.lang.String); }
برای نمایش تبلیغات با استفاده از کتابخانه تپلیغ بایستی ابتدا یک نمونه از کلاس Tapligh آن ایجاد کنید سپس با فراخوانی متد مناسب نمایش تپلیغ، آن را در زمان مناسب به کاربر خود نشان دهید. در ادامه به صورت کامل درباره نحوه انجام این کار توضیح خواهیم داد.
ابتدا بایستی در صفحه ای که میخواهید تپلیغ نمایش دهید، نمونه ای از کلاس Tapligh بسازید. برای این کار خط زیر را کپی کنید:
Tapligh tapligh = Tapligh.newInstance(Your-Activity);
توجه داشته باشید که بایستی در اولین صفحه از برنامه خود حتما توکن برنامه خود را به کتابخانه تپلیغ معرفی نمایید. برای این منظور از خط زیر میتوانید استفاده کنید:
tapligh.setToken("YOUR-TOKEN", boolean);
در این کد عبارت YOUR-TOKEN توکنی است که شما پس از ثبت برنامه خود در پنل تپلیغ آن را دریافت میکنید.
tapligh.loadAd("UNIT-CODE" , newAdLoadListener() { @Override public void onAdReady(String unitCode, String token) { } @Override public void onLoadError(String unitCode, LoadErrorStatus loadErrorStatus) { } });
با استفاده از ورودی دوم میتوانید نتیجه درخواست آماده سازی تپلیغ را دریافت کنید. در صورتیکه تبلیغ آماده باشد متد onAdReady صدا زده میشود. ورودی این متد توکن تبلیغی است که آماده نمایش است ورودی های این متد کد واحد تپلیغ درخواست شده و توکن تبلیغی است که آماده نمایش است،، در غیر اینصورت متد onLoadError صدا میشود.ورودی اول این متد کد واحد تپلیغی است که درخواست آماده سازی بر روی آن اجرا شده و ورودی دوم از نوع کلاس LoadErrorStatus بوده و مقادیری که میتوانند دریافت کنند به صورت زیر هستند:
پس از آنکه متد onAdReady اجرا شد، به این معنی است که تبلیغ آماده نمایش است. بنابراین برای نمایش تبلیغ از متد زیر استفاده نمایید:
tapligh.showAd("UNIT-CODE" , new ADResultListener () { @Override public void onAdResult(ADResult adResult, String token) { } @Override public void onRewardReady(String reward) { } });
با استفاده از این ورودی که در هنگام نمایش تبلیغ تعیین میکنید، میتوانید نتیجه درخواست نمایش آن را دریافت کنید. در صورتی که نمایش به صورت کامل انجام شده باشد، میتوانید میزان جایزه تعیین شده را نیز دریافت کنید.
این interface دو تابع به نامهای onAdResult و onRewardReady دارد. در تابع onAdResult دو مقدار قرار میگیرد که مقدار اول نتیجه نمایش تپلیغ بوده و مقدار دوم توکنی است که برای این تپلیغ تعیین شده است. این توکن برای هر فرایند نمایش تپلیغ به صورت منحصر به فرد تعیین شده و میتوانید از طریق تابع دیگری از صحت این توکن اطمینان حاصل کنید. توضیحات کامتر مربوط به توکن در ادامه داده خواهد شد.
@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); }
مقادیر مربوط به نتیجه تپلیغ به صورت زیر هستند:
نکته مهم: در صورتیکه پیش از اجرای متد loadAd متد showAd را فراخوانی کنید حتما در متد onAdResult با پاسخ noAdReady مواجه خواهید شد.
تمامی این مقادیر در کلاس AdResult قرار داده شدهاند و شما میتوانید آنها را مشاهده کنید.
لطفا نظرات خود را در زمینه تجربه استفاده از SDK از طریق developers@tapligh.com ، شماره ۴۲۵۷۰۰۰۰-۰۲۱ داخلی 481و یا تلگرام با ما در میان بگذارید.
tapligh.verifyToken(“TOKEN”, new VerifyTokenListener(){ @Override public void onTokenVerified(TokenResult result) { if(TokenResult.SUCCESS.equals(result)) { //TODO write your code } else if (TokenResult.TOKEN_EXPIRED.equals(result)) { //TODO write your code } else if(TokenResult.NOT_USED.equals(result)) { //TODO write your code } else if(TokenResult.TOKEN_NOT_FOUND.equals(result)) { //TODO write your code } else if(TokenResult.INTERNAL_ERROR.equals(result)) { //TODO write your code } } });
۵ حالت برای توکن میتواند رخ داده باشد. شما میتوانید تمامی این مقادیر در کلاس TokenResult مشاهده نمایید:
لطفا نظرات خود را در زمینه تجربه استفاده از SDK از طریق developers@tapligh.com ، شماره ۴۲۵۷۰۰۰۰-۰۲۱ داخلی ۴۴۴ و یا تلگرام با ما در میان بگذارید.
جهت تست پروژه خود ترجیحا از Emulator ها استفاده ننمایید.
تهران، هفتتیر، خیابان کریمخان، خیابان خردمند جنوبی، کوچهی ملکیان، پلاک یک
۴۲۵۷۰۰۰۰ – ۰۲۱
داخلی ۴۸۱
info@tapligh.com