1. خانه
  2. تنظیمات پروژه Android Studio

تنظیمات پروژه Android Studio

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

 

توجه

مستندات این بخش برای پیاده‌سازی تپسل در نرم‌افزار Android Studio (نسخه ۲) نوشته شده‌ و برای مدیریت کتابخانه‌ها و ساخت پروژه از ابزار Gradle استفاده شده‌است که بصورت پیش‌فرض در Android Studio  موجود است. برای مشاهده مستندات پیاده‌سازی در Eclipse به اینجا مراجعه کنید.

 

گام 1: تنظیمات ProGuard

در صورتی که در اپلیکیشن خود از ProGuard استفاده می‌کنید، تنظیمات زیر را در فایل proguard-rules وارد نمایید.


-keepattributes Signature
-keepattributes *Annotation*
-keepattributes EnclosingMethod
-keepattributes InnerClasses
-keep class sun.misc.Unsafe { *; }
-keep class ir.tapsell.sdk.gson.stream.** { *; }
-keep class ir.tapsell.sdk.gson.** { *; }
-keepclassmembers enum * { *; }
-keep class **.R$* { *; }
-keep interface ir.tapsell.sdk.NoProguard
-keep class * implements ir.tapsell.sdk.NoProguard { *; }
-keep interface * extends ir.tapsell.sdk.NoProguard { *; }
-keep class ir.tapsell.sdk.** implements java.io.Serializable { *; }

گام 2: آپدیت فایل Manifest

دسترسی‌های زیر را به فایل AndroidManifest.xml اضافه کنید.

<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" /><!--optional-->
<uses-permission android:name="android.permission.VIBRATE" /><!--optional-->

همانطور  که در کد فوق مشخص شده‌است، دسترسی‌های وضعیت تماس (READ_PHONE_STATE) و لرزش دستگاه (VIBRATE) اختیاری هستند اما درصورتیکه این دسترسی‌ها را نیز در برنامه خود قرار دهید، تبلیغات نشان‌داده‌شده به کاربر از کیفیت بالاتری برخوردار خواهد بود و تبع درآمد بیشتری از طریق eCPM عاید شما خواهد شد.

در بخش application از فایل منیفست برنامه، activity زیر را اضافه کنید.

<manifest>
…
<application>
…
<activity android:name="ir.tapsell.sdk.TapsellAdActivity" 
          android:configChanges="keyboardHidden|orientation|screenSize" >
</activity>
</application>
…
</manifest>

 

 

گام 3: دانلود و اضافه کردن کتابخانه تپسل به پروژه

برای این کار دو روش وجود دارد:

 

روش اول:

ابتدا خطوط زیر را به فایل build.gradle مربوط به کل پروژه (Project) اضافه کنید:

maven {
    url 'https://dl.bintray.com/tapsell/maven'
}

به این صورت:

 

حالا خط زیر را به بخش dependencies فایل build.gradle مربوط به اپلیکیشن خود اضافه کنید:

// Android Studio 3.0 and above
implementation 'ir.tapsell.sdk:tapsell-sdk-android:3.1.4'

// Older Android Studio
compile 'ir.tapsell.sdk:tapsell-sdk-android:3.1.4'

به این صورت:

به دلیل تحریم هایی که برای کاربران ایران در نظر گرفته شده ابتدا IP خودتان را تغییر داده سپس Sync Now را انتخاب کنید و سپس صبر کنید تا کتابخانه تپسل به صورت خودکار دانلود و به پروژه تا اضافه شود.

 

روش دوم:

ابتدا فایل aar مربوط به SDK تپسل را از آدرس زیر دانلود کنید.

فایل دانلود شده را در پوشه libs پروژه خود کپی کنید و خط زیر را به تنظیمات gradle ماژول اصلی پروژه خود اضافه کنید.

dependencies {
    compile(name:'tapsell-sdk-android', ext:'aar')
    /** Other dependencies here **/
}

همچنین در فایل gradle مربوط به همه پروژه ها، در بخش repositories عبارت زیر را اضافه کنید.

allprojects {
    repositories {
        jcenter()
        flatDir {
            dirs 'libs'
        }
    }
}

 

گام 4: دریافت کلید تپسل و شناسه تبلیغ گاه

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

در صفحه اپلیکیشن ایجاد شده، در قسمت تبلیغ‌گاه ها یک تبلیغ‌گاه برای نمایش تبلیغات در اپلیکیشن خود ایجاد کنید و یا از تبلیغ‌گاه ساخته شده بصورت پیش‌فرض استفاده کنید. با توجه به نوع تبلیغ مورد نظر در اپلیکیشن (ویدئویی جایزه‌دار، ویدئویی بینابینی و بنری بینابینی تمام صفحه و…) نوع تبلیغ‌گاه خود را تعیین کنید. از شناسه تبلیغ‌گاه ای که به شما اختصاص داده میشود برای نمایش تبلیغ در اپلیکیشن خود استفاده کنید.

 

گام 5: شروع کار با SDK تپسل

کتابخانه تپسل برای شروع کار نیاز به  initialize شدن در ابتدای برنامه و قبل از همه Activity ها دارد. برای اینکار باید از کلاس Application استفاده کنید.

کلاس Application

اگر با کلاس Application آشنایی ندارید این لینک را مطالعه بفرمایید.

کلاس‌های مربوط به SDK تپسل را import کنید:

import ir.tapsell.sdk.*;

خط زیر را در تابع onCreate مربوط به کلاس Application خود فراخوانی کنید:

Tapsell.initialize(thisApplication, appKey);

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

 

 

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

 

مرحله بعد: پیاده‌سازی تبلیغات ویدئویی (Interstitial/Rewarded Video) و بنری تمام صفحه (Interstitial Banner) در پروژه اندروید

آیا این این آموزش مفید بود؟