راه اندازی تپسل پلاس در یونیتی (Android)

اضافه کردن Unity Package تپسل پلاس

برای اضافه کردن کتابخانه‌های مورد نیاز ۲ روش وجود دارد از هرکدام که مایل هستید استفاده کنید.

۱. استفاده از Gradle

۱. ابتدا unitypackage تپسل پلاس را از این لینک دریافت نمایید. ۲. از طریق منوی زیر unitypackage تپسل پلاس را به پروژه‌ی خود اضافه نمایید. (اگر فولدر TapsellPlus از قبل در پروژه‌ی شما وجود دارد لطفا آن را پاک کنید)

Assets > Import Package > Custom Package...

۳. از طریق منوهای زیر، تیک‌های مربوط به ایجاد فایل‌های Custom Gradle را بزنید:

Edit > Project Setting... > Player > Publishing Settings > Custom Launcher Gradle Template
Edit > Project Setting... > Player > Publishing Settings > Custom Main Gradle Template
Edit > Project Setting... > Player > Publishing Settings > Custom Base Gradle Template

۴. به آدرس ‍‍Assets\Plugins\Android\mainTemplate.gradle بروید و :خط کامنت شده‌ی بالای فایل را حذف نمایید

// GENERATED BY UNITY. REMOVE THIS COMMENT TO PREVENT OVERWRITING WHEN EXPORTING AGAIN

سپس در بخش dependencies خط زیر را اضافه نمایید:

dependencies {
    ...
    implementation 'ir.tapsell.plus:tapsell-plus-sdk-unity:2.1.3'
    ...
**DEPS**}

اگر تکه کد زیر نیز در فایل وجود نداشت آن را اضافه نمایید:

android {
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
  }
}

۵. به آدرس Assets\Plugins\Android\baseProjectTemplate.gradle بروید و عبارت mavenCentral() را به هر دو بخش repositories اضافه نمایید. سپس ورژن com.android.tools.build:gradle را به ۳.۶.۰ تغییر دهید.

دقت داشته باشید که استفاده از ورژن ۳.۶.۰ برای Android Gradle Plugin الزامی است. زیرا برای پشتیبانی از اندروید یازده می‌بایستی حداقل از این ورژن در پروژه پشتیبانی شود. برای اضافه کردن نسخه‌ای از Gradle که قابلیت پشتیبانی از اندروید یازده را دارد، می‌توانید از این لینک کمک بگیرید.

۶. بعد از اضافه کردن تپسل پلاس و شبکه‌های تبلیغاتی دیگر احتمالا به دلیل بالا رفتن حجم کد و جلوگیری از وقوع خطای زیر می‌بایستی MultiDex را فعال نمایید.

D8: Cannot fit requested classes in a single dex file (# methods: 68109 > 65536)

نحوه‌ی فعال‌سازی MultiDex به این ترتیب است که به آدرس Assets\Plugins\Android\launcherTemplate.gradle بروید و تکه کد زیر را به آن اضافه نمایید:

android {
  ...
  defaultConfig {
    ...
    multiDexEnabled true
  }
  ...
}

۲. استفاده از Resolver

۱. ابتدا فایل unitypackage resolver را دانلود کنید. سپس مطابق توضیحات لینک زیر آن را به پروژه‌ی خود اضافه نمایید:

مستندات گوگل

۲. از طریق منوهای زیر، تیک مربوط به Jetifier و Auto Resolution را بزنید. (تیک مربوط به Auto Resolution اجباری نیست اما برای آن که هر بار مجبور نباشید کتابخانه‌ها را به شکل دستی Resolve کنید بهتر است آن را فعال کنید)

Assets > External Dependency Manager > Android Resolver > Settings > Use Jetifier
Assets > External Dependency Manager > Android Resolver > Settings > Enable Auto-Resolution

۳. ابتدا unitypackage تپسل پلاس را از این لینک دریافت نمایید.

۴. از طریق منوی زیر unitypackage تپسل پلاس را به پروژه‌ی خود اضافه نمایید. (اگر فولدر TapsellPlus از قبل در پروژه‌ی شما وجود دارد لطفا آن را پاک کنید)

Assets > Import Package > Custom Package...

۵. برای اطمینان از اضافه شدن پلاگین تپسل پلاس از طریق منوی زیر اقدام به Resolve کردن کتابخانه‌ها کنید:

Assets > External Dependency Manager > Android Resolver > Force Resolve

۶. از طریق منوهای زیر، تیک‌های مربوط به ایجاد فایل‌های Custom Gradle را بزنید:

Edit > Project Setting... > Player > Publishing Settings > Custom Launcher Gradle Template
Edit > Project Setting... > Player > Publishing Settings > Custom Base Gradle Template

۴. اگر تکه کد زیر در آدرس Assets\Plugins\Android\launcherTemplate.gradle وجود نداشت آن را اضافه نمایید:

android {
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
  }
}

۵. به آدرس Assets\Plugins\Android\baseProjectTemplate.gradle بروید و عبارت mavenCentral() را به هر دو بخش repositories اضافه نمایید. سپس ورژن com.android.tools.build:gradle را به ۳.۶.۰ تغییر دهید.

دقت داشته باشید که استفاده از ورژن ۳.۶.۰ برای Android Gradle Plugin الزامی است. زیرا برای پشتیبانی از اندروید یازده می‌بایستی حداقل از این ورژن در پروژه پشتیبانی شود. برای اضافه کردن نسخه‌ای از Gradle که قابلیت پشتیبانی از اندروید یازده را دارد، می‌توانید از این لینک کمک بگیرید.

۶. بعد از اضافه کردن تپسل پلاس و شبکه‌های تبلیغاتی دیگر احتمالا به دلیل بالا رفتن حجم کد و جلوگیری از وقوع خطای زیر می‌بایستی MultiDex را فعال نمایید.

D8: Cannot fit requested classes in a single dex file (# methods: 68109 > 65536)

نحوه‌ی فعال‌سازی MultiDex به این ترتیب است که به آدرس Assets\Plugins\Android\launcherTemplate.gradle بروید و تکه کد زیر را به آن اضافه نمایید:

android {
  ...
  defaultConfig {
    ...
    multiDexEnabled true
  }
  ...
}

مقداردهی اولیه

ابتدا برای دسترسی به کدهای تپسل از تکه کد زیر استفاده کنید.

using TapsellPlusSDK;

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

TapsellPlus.Initialize(TAPSELLPLUS_KEY,
            adNetworkName => Debug.Log(adNetworkName + " Initialized Successfully."),
            error => Debug.Log(error.ToString()));

TAPSELLPLUS_KEY کلید تپسل پلاس هست و برای هر اپلیکیشنی که می‌سازید در پنل تپسل ساخته می‌شود و می‌توانید از پنل کپی کنید.

اکنون می‌توانید با توجه به نیاز خود و توضیحات به هر نوع تبلیغ، تبلیغ مورد نظر را نمایش دهید.

تنظیمات مربوط به GDPR

از آن‌جا که کتابخانه‌ی تپسل پلاس قوانین GDPR را در خصوص نمایش تبلیغات شخصی‌سازی شده رعایت می‌کند، به طور پیش فرض اگر کاربر با IP یکی از کشورهای مشمول این قانون از اپلیکیشن شما استفاده کند، دیالوگی در این خصوص به کاربر نمایش می‌دهد. اگر تمایل دارید تا به جای تصمیم کاربر، خودتان دسترسی لازم را تعیین کنید می‌توانید از تکه کد زیر استفاده نمایید. توجه داشته باشید که این تکه کد می‌بایستی پس از Initialize شدن تپسل پلاس و پیش از درخواست تبلیغ صدا زده شود تا نتیجه‌ی آن در درخواست شما اعمال شده باشد. مقدار true‌ به این معنی است که شما حق استفاده از اطلاعات جهت نمایش تبلیغ شخصی‌سازی شده را به شبکه‌های تبلیغاتی داده‌اید.

TapsellPlus.SetGdprConsent(true);

پروژه‌ی نمونه

برای راهنمایی بیش‌تر می‌توانید از پروژه‌های نمونه‌ی ما بر روی Github استفاده نمایید.