نصب 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 برای نسخه‌های اندروید خود، مراحل زیر را انجام دهید:

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:0.24.0-beta01">
     <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:0.24.0-beta01">
      <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>