تثبيت حزمة تطوير البرامج "الجيل التالي من إعلانات Google على الأجهزة الجوّالة"

للاستفادة من تحسينات وقت الاستجابة والثبات في Android، يُرجى استخدام GMA Next-Gen SDK. يتناول هذا الدليل كيفية ضبط Google Mobile Ads Unity Plugin لاستخدام GMA Next-Gen SDK لأجهزة Android.

المتطلبات الأساسية

قبل المتابعة، عليك تنفيذ ما يلي:

• ثبِّت الإصدار 10.6.0 أو إصدارًا أحدث من Google Mobile Ads Unity Plugin.
• استخدِم الإصدار 2019.4 من Unity أو إصدارًا أحدث.
• إعداد Google Mobile Ads Unity Plugin
• أن يكون لديك مشروع Unity

تحديث الحد الأدنى لمستوى واجهة برمجة التطبيقات إلى 24

يتطلّب تطبيق "GMA Next-Gen SDK" المستوى 24 من واجهة برمجة التطبيقات كحدّ أدنى. لتعديل الحد الأدنى لمستوى واجهة برمجة التطبيقات، يُرجى اتّباع الخطوات التالية:

1. من شريط القوائم، انقر على ملف > إنشاء ملفات تعريف > إعدادات المشغّل > Android > إعدادات أخرى > التعريف.
2. اضبط الحدّ الأدنى لمستوى واجهة برمجة التطبيقات على الإصدار 7.0 من نظام التشغيل Android‏ (Nougat) (المستوى 24 من واجهة برمجة التطبيقات) أو إصدار أحدث.

تعديل ملف التبعية

الإصدار 11.1.0 أو الأحدث

لتفعيل GMA Next-Gen SDK لإصدارات Android، اختَر Assets > Google Mobile Ads > Settings في محرِّر 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.6.0">
     <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.6.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 في عمليات دمج التوسّط لتجنُّب أخطاء الفئات المكرّرة.