نصب کیت توسعه نرم‌افزار نسل بعدی GMA

برای استفاده از بهبودهای پایداری و تأخیر Android، از GMA Next-Gen SDK استفاده کنید. این راهنما پیکربندی Google Mobile Ads Unity Plugin برای استفاده از GMA Next-Gen SDK در Android را پوشش می‌دهد.

پیش‌نیازها

قبل‌از ادامه دادن، موارد زیر را انجام دهید:

• ‫Google Mobile Ads Unity Plugin نسخه ۱۰.۶.۰ یا بالاتر را نصب کنید.
• از Unity نسخه ۲۰۱۹.۴ یا بالاتر استفاده کنید.
• ‫Google Mobile Ads Unity Plugin را راه‌اندازی کنید.
• پروژه Unity داشته باشید.

حداقل سطح میانای برنامه کاربردی را به ۲۴ به‌روز کنید

‫GMA Next-Gen SDK به حداقل سطح میانای برنامه‌سازی کاربردی ۲۴ نیاز دارد. برای به‌روزرسانی حداقل سطح میانای برنامه کاربردی، این کارها را انجام دهید:

1. از نوار منو، روی فایل > ساختن نمایه‌ها > تنظیمات پخش‌کننده > Android > تنظیمات دیگر > شناسایی کلیک کنید.
2. حداقل سطح میانای برنامه کاربردی را روی Android 7.0 «نوقا» (سطح میانای برنامه کاربردی ۲۴) یا بالاتر تنظیم کنید.

اصلاح فایل وابستگی

‫۱۱.۱.۰ و بالاتر

برای فعال کردن GMA Next-Gen SDK برای ساخت‌های Android، در ویرایشگر Unity، دارایی‌ها > Google Mobile Ads > تنظیمات را انتخاب کنید:

در بازرس تنظیمات GMA Next-Gen SDK، هر دو Switch Google Mobile Ads Android Architecture و GMA Next-Gen SDK را فعال کنید.

‫۱۱.۰.۰ -‏ ۱۰.۶.۰

برای فعال کردن GMA Next-Gen SDK برای ساخت‌های Android، فایل وابستگی را اصلاح کنید:

1. در پروژه Unity خود، به فایل Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml بروید.

   • اگر از «مدیر بسته Unity» استفاده می‌کنید، به Packages > Google Mobile Ads for Unity > GoogleMobileAds > Editor > GoogleMobileAdsDependencies.xml پیمایش کنید.

2. عنصر <androidPackage> را با مشخصات com.google.android.gms:play-services-ads پیدا کنید.

3. عنصر را با جدیدترین نسخه دردسترس com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk جایگزین کنید:

   <androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0">
     <repositories>
       <repository>https://maven.google.com/</repository>
     </repositories>
   </androidPackage>
   

4. فایل را ذخیره کنید.

درطول فرایند ساخت، Google Mobile Ads Unity Plugin حضور GMA Next-Gen SDK را تشخیص می‌دهد و از پیاده‌سازی شما استفاده می‌کند.

هشدار: به‌روزرسانی بسته GMA Next-Gen SDK فایل وابستگی شما را بازنویسی می‌کند. اگر بسته‌تان را به‌روزرسانی کردید، مراحل قبلی را تکرار کنید.

مثال زیر فایل GoogleMobileAdsDependencies.xml به‌روزشده را نشان می‌دهد:

<dependencies>
<androidPackages>
  <androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0">
    <repositories>
      <repository>https://maven.google.com/</repository>
    </repositories>
  </androidPackage>
  <androidPackage spec="androidx.constraintlayout:constraintlayout:2.1.4">
    <repositories>
      <repository>https://maven.google.com/</repository>
    </repositories>
  </androidPackage>
  <androidPackage spec="androidx.lifecycle:lifecycle-process:2.6.2">
      <repositories>
          <repository>https://maven.google.com/</repository>
      </repositories>
  </androidPackage>
</androidPackages>

<iosPods>
  <iosPod name="Google-Mobile-Ads-SDK" version="~> 12.11.0">
    <sources>
      <source>https://github.com/CocoaPods/Specs</source>
    </sources>
  </iosPod>
</iosPods>
</dependencies>

مستثنی کردن com.google.android.gms واحد در یکپارچه‌سازی‌های میانجی‌گری

اگر از میانجی‌گری استفاده می‌کنید، راهنمای انتقال Android را دنبال کنید تا واحدهای com.google.android.gms را حذف کنید در یکپارچه‌سازی‌های میانجی‌گری‌تان از خطاهای کلاس تکراری جلوگیری کنید.