نصب GMA Next-Gen SDK

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

پیش‌نیازها

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

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

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

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

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

فایل وابستگی را تغییر دهید

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

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

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

۱۱.۰.۰ - ۱۰.۶.۰

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

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

   • اگر از Unity Package Manager استفاده می‌کنید، به 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.1.1">
     <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.1.1">
    <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 را در ادغام‌های میانجی‌گری حذف کنید

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