نصب 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 را در ادغام‌های میانجیگری خود حذف کنید .