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

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

پیش‌نیازها

پیش‌از ادامه دادن، کارهای زیر را انجام دهید:

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

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

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

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

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

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

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

11.0.0 - 10.6.0

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

  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.5.0">
      <repositories>
        <repository>https://maven.google.com/</repository>
      </repositories>
    </androidPackage>
    
  4. فایل را ذخیره کنید.

درطول فرایند ساخت، Google Mobile Ads Unity Plugin وجود 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 را مستثنی کنید در ادغام‌های میانجی‌گری خود برای جلوگیری از خطاهای کلاس تکراری.