برای استفاده از این کتابخانه باید از build system گردل استفاده کنید. همچنین سعی کنید از آخرین نسخه unity استفاده کنید.
نسخه 0.1.3.0
ابتدا unity package تپسل را دانلود کنید و به پروژه اضافه کنید.
از player settings قسمت publishing settings تیک custom gradle template رو بزارید.
خطوط زیر را در بخش dependencies فایل mainTemplate.gradle در مسیر Assets/Plugins/Android اضافه کنید.
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'com.google.code.gson:gson:2.8.5'
implementation 'com.squareup.retrofit2:retrofit:2.5.0'
implementation 'com.squareup.retrofit2:converter-gson:2.5.0'
implementation 'com.squareup.okhttp3:logging-interceptor:3.12.1'
implementation 'ir.tapsell.sdk:tapsell-sdk-android:4.1.5'
implementation 'com.unity3d.ads:unity-ads:3.0.0'
implementation 'com.google.android.gms:play-services-ads:17.1.3'
implementation 'com.google.android.gms:play-services-basement:16.2.0'
implementation 'com.google.android.gms:play-services-ads-identifier:16.0.0'
implementation 'com.google.android.gms:play-services-location:16.0.0'
}هر یک از خطوط زیر که در بخش allprojects -> repositories فایل mainTemplate.gradle وجود ندارد اضافه کنید.
allprojects {
repositories {
google()
jcenter()
flatDir {
dirs 'libs'
}
maven {
url 'https://dl.bintray.com/tapsellorg/maven'
}
}
}
خطوط زیر را در بخش android فایل mainTemplate.gradle در صورتی که وجود ندارد اضافه کنید.
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}تنظیمات پروگوارد را از این فایل دریافت کنید
تابع زیر را در یکی از اسکریپت‌های ابتدایی برنامه بزارید.
void Start () {
TapsellPlus.initialize (TAPSELL_KEY);
}ابتدا از پنل یک تبلیغگاه (zone) ویدیو جایزه‌ای بسازید و zoneId رو زمان درخواست و نمایش تبلیغ استفاده کنید
مطابق کد زیر درخواست تبلیغ دهید
public void Request () {
TapsellPlus.requestRewardedVideo (ZONE_ID,
(string zoneId) => {
Debug.Log ("on response " + zoneId);
},
(TapsellError error) => {
Debug.Log ("Error " + error.message);
}
);
}بعد از اجرای متد response تبلیغ آماده نمایش است و میتوانید مطابق روش زیر نمایش دهید
public void Show () {
TapsellPlus.showAd (ZONE_ID,
(string zoneId) => {
Debug.Log ("onOpenAd " + zoneId);
},
(string zoneId) => {
Debug.Log ("onCloseAd " + zoneId);
},
(string zoneId) => {
Debug.Log ("onReward " + zoneId);
},
(TapsellError error) => {
Debug.Log ("onError " + error.message);
}
);
}مطابق تبلیغات جایزه‌ای پیش برید فقط زمان درخواست تبلیغ از متد TapsellPlus.requestInterstitial استفاده کنید
مطابق کد زیر میتونید بنر استاندارد نمایش دهید
TapsellPlus.showBannerAd (ZONE_ID, BANNER_TYPE, VERTICAL_GRAVITY, HORIZONTAL_GRAVITY,
(string zoneId) => {
Debug.Log ("on response " + zoneId);
},
(TapsellError error) => {
Debug.Log ("Error " + error.message);
});BANNER_TYPE سایز نمایش بنر هست و میتواند مقادیر زیر باشد
| keyword | size |
|---|---|
| BANNER_320x50 | 320x50 |
| BANNER_320x100 | 320x100 |
| BANNER_250x250 | 250x250 |
| BANNER_300x250 | 300x250 |
| BANNER_468x60 | 468x60 |
| BANNER_728x90 | 728x90 |
VERTICAL_GRAVITY و HORIZONTAL_GRAVITY موقعیت قرار گیری بنر در صفحه هست و میتواند مقادیر زیر باشد
Gravity.TOP - Gravity.BOTTOM - Gravity.LEFT - Gravity.RIGHT - Gravity.CENTER
به عنوان مثال میتونید به این شکل درخواست تبلیغ دهید
TapsellPlus.showBannerAd (ZONE_ID, BannerType.BANNER_300x250, Gravity.BOTTOM, Gravity.CENTER,
(string zoneId) => {
Debug.Log ("on response " + zoneId);
},
(TapsellError error) => {
Debug.Log ("Error " + error.message);
});با این کد میتوانید تبلیغ بنر استاندارد را مخفی کنید
TapsellPlus.hideBanner ();مطابق کد زیر درخواست تبلیغ دهید
public void Request () {
TapsellPlus.requestNativeBanner (this, ZONE_ID,
(TapsellNativeBannerAd result) => {
Debug.Log ("on response");
//show ad
},
(TapsellError error) => {
Debug.Log ("Error " + error.message);
}
);
}متغیر برگردانده شده در on response محتویات تبلیغ هست و برای نمایش تبلیغ باید مطابق جدول زیر ازش استفاده کنید
| function | usage |
|---|---|
| getTitle () | عنوان |
| getDescription () | توضیحات |
| getIcon () | آیکن |
| getLandscapeBannerImage () | تصویر افقی |
| getPortraitBannerImage () | تصویر عمودی |
| getCallToAction (), | متن دکمه کلیک |
برای باز کردن تبلیغ زمان کلیک کاربر میتونید از این متد استفاده کنید
nativeAd.clicked ();برای دیدن یک نمونه پیاده سازی شده میتونید همین پروژه در گیت‌هاب را بررسی کنید