مرحله اول : اضافه کردن کتابخانه تپلیغ
در فولدر پروژه خود با استفاده از ابزارهای Command-Line دستور زیر را وارد نمایید:
در فولدر پروژه خود با استفاده از ابزارهای Command-Line دستور زیر را وارد نمایید:
npm install --save tapligh-react-native
سپس با استفاده از دستور زیر بسته تپلیغ را به پروژه خود متصل نمایید:
react-native link tapligh-react-native
اکنون میتوانید از SDK این سرویس در برنامه خود استفاده نمایید.
توجه: این کتابخانه تنها قابلیت استفاده در Android را دارد.
برای نمایش تبلیغات با استفاده از کتابخانه تپلیغ بایستی ابتدا ماژول Tapligh را در کد خود اضافه کنید سپس با فراخوانی متد مناسب نمایش تپلیغ، آن را در زمان مناسب به کاربر خود نشان دهید. در ادامه به صورت کامل درباره نحوه انجام این کار توضیح خواهیم داد.
ابتدا بایستی در صفحه ای که میخواهید تپلیغ نمایش دهید، ماژول Tapligh را وارد کنید. برای این کار خط زیر را کپی کرده و در بالا کد خود قرار دهید:
import Tapligh from 'tapligh-react-native';
توجه داشته باشید که بایستی در اولین صفحه از برنامه خود حتما توکن برنامه خود را به کتابخانه تپلیغ معرفی نمایید. برای این منظور از خط زیر میتوانید استفاده کنید:
Tapligh.initialize(); Tapligh.setToken(YOUR-TOKEN, false);
در این کد عبارت YOUR-TOKEN توکنی است که شما پس از ثبت برنامه خود در پنل تپلیغ آن را دریافت میکنید.
var onAdReady = function(UNIT_CODE, AD_TOKEN) { // Handle showing ad when it's ready. } var onLoadError = function(UNIT_CODE, LOAD_ERROR) { // Handle error if the loadAd was not successful. } Tapligh.loadAd("UNIT-CODE", onAdReady, onLoadError);
با استفاده از ورودی دوم و سوم میتوانید نتیجه درخواست آماده سازی تپلیغ را دریافت کنید. در صورتیکه تبلیغ آماده باشد متد onAdReady صدا زده میشود. ورودی این متد توکن تبلیغی است که آماده نمایش است ورودی های این متد کد واحد تپلیغ درخواست شده و توکن تبلیغی است که آماده نمایش است،، در غیر اینصورت متد onLoadError صدا میشود.ورودی اول این متد کد واحد تپلیغی است که درخواست آماده سازی بر روی آن اجرا شده و ورودی دوم از نوع کلاس LoadErrorStatus بوده و مقادیری که میتوانند دریافت کنند به صورت زیر هستند:
پس از آنکه متد onAdReady اجرا شد، به این معنی است که تبلیغ آماده نمایش است. بنابراین برای نمایش تبلیغ از متد زیر استفاده نمایید:
var onAdResult = function(AD_RESULT, AD_TOKEN) { // Handle function for Ad result callback; } var onRewardReady = function(REWARD) { // Handle function for Ads with type of rewarded with amount of reward specified in application panel } Tapligh.showAd("UNIT-CODE", onAdResult, onRewardReady);
با استفاده از این ورودی که در هنگام نمایش تبلیغ تعیین میکنید، میتوانید نتیجه درخواست نمایش آن را دریافت کنید. در صورتی که نمایش به صورت کامل انجام شده باشد، میتوانید میزان جایزه تعیین شده را نیز دریافت کنید.
این interface دو تابع به نامهای onAdResult و onRewardReady دارد. در تابع onAdResult دو مقدار قرار میگیرد که مقدار اول نتیجه نمایش تپلیغ بوده و مقدار دوم توکنی است که برای این تپلیغ تعیین شده است. این توکن برای هر فرایند نمایش تپلیغ به صورت منحصر به فرد تعیین شده و میتوانید از طریق تابع دیگری از صحت این توکن اطمینان حاصل کنید. توضیحات کاملتر مربوط به توکن در ادامه داده خواهد شد.
var onAdResult = function(adResult, token) { console.log("Tapligh" , "token->" + token); switch (adResult){ case "tokenExpired"": console.log("Tapligh", "tokenExpired"); break; case "adVideoClosedOnView": console.log("Tapligh", "adVideoClosedOnView"); break; case "adViewCompletely": console.log("Tapligh", "adViewCompletely"); break; case "adClicked": console.log("Tapligh", "adClicked"); break; case "adVideoClosedAfterFulView": console.log("Tapligh" , "adVideoClosedAfterFulView"); break; case "skipAndClicked": console.log("Tapligh", "skipAndClicked"); break; case "skipAndClosed": console.log("Tapligh", "skipAndClosed"); break; // used for image ad case "adImageClosed": console.log("Tapligh", "adImageClosed");break; } } var onRewardReady = function(reward) { console.log("Tapligh" , "reward->" + reward); }
مقادیر مربوط به نتیجه تپلیغ به صورت زیر هستند:
نکته مهم: در صورتیکه پیش از اجرای متد loadAd متد showAd را فراخوانی کنید حتما در متد onAdResult با پاسخ noAdReady مواجه خواهید شد.
تمامی این مقادیر در کلاس AdResult قرار داده شدهاند و شما میتوانید آنها را مشاهده کنید.
لطفا نظرات خود را در زمینه تجربه استفاده از SDK از طریق developers@tapligh.com ، شماره ۴۲۵۷۰۰۰۰-۰۲۱ داخلی ۴۴۴ و یا تلگرام با ما در میان بگذارید.
var onTokenVerified = function(TOKEN_RESULT) { if(TOKEN_RESULT == "SUCCESS") { //TODO write your code } else if (TOKEN_RESULT == "TOKEN_EXPIRED") { //TODO write your code } else if(TOKEN_RESULT == "NOT_USED") { //TODO write your code } else if(TOKEN_RESULT == "TOKEN_NOT_FOUND") { //TODO write your code } else if(TOKEN_RESULT == "INTERNAL_ERROR") { //TODO write your code } } Tapligh.verifyToken(“TOKEN”, onTokenVerified);
۵ حالت برای توکن میتواند رخ داده باشد. شما میتوانید تمامی این مقادیر در کلاس TokenResult مشاهده نمایید:
لطفا نظرات خود را در زمینه تجربه استفاده از SDK از طریق developers@tapligh.com ، شماره ۴۲۵۷۰۰۰۰-۰۲۱ داخلی ۴۴۴ و یا تلگرام با ما در میان بگذارید.
جهت تست پروژه خود ترجیحا از Emulator ها استفاده ننمایید.
تهران، هفتتیر، خیابان کریمخان، خیابان خردمند جنوبی، کوچهی ملکیان، پلاک یک
۴۲۵۷۰۰۰۰ – ۰۲۱
داخلی ۴۸۱
info@tapligh.com