تثبيت حزمة تطوير البرامج "الجيل التالي من إعلانات 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 في عمليات دمج التوسّط لتجنُّب أخطاء الفئات المكرّرة.