نصب GMA Next-Gen SDK

To adopt Android latency and stability improvements, use GMA Next-Gen SDK . This guide covers configuring Google Mobile Ads Unity Plugin to use GMA Next-Gen SDK for Android.

پیش‌نیازها

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

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

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

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

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

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

برای فعال کردن 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.0">
     <repositories>
       <repository>https://maven.google.com/</repository>
     </repositories>
   </androidPackage>
   

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

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

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

ادغام‌های میانجیگری

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

مشاهده مثال کامل

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

<dependencies>
  <androidPackages>
    <androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.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>