تثبيت حزمة تطوير البرامج "الجيل التالي من إعلانات 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 "نوجا" (المستوى 24 من واجهة برمجة التطبيقات) أو إصدار أحدث.

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

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

لتفعيل GMA Next-Gen SDK لعمليات إنشاء Android، اختَر مواد العرض > إعلانات Google على الأجهزة الجوّالة > الإعدادات في محرّر Unity:

داخل أداة فحص إعدادات GMA Next-Gen SDK، فعِّل كلاً من Switch Google Mobile Ads Android Architecture وGMA Next-Gen SDK.

الإصدارات من 10.6.0 إلى 11.0.0

لتفعيل GMA Next-Gen SDK لعمليات إنشاء Android، عدِّل ملف التبعية:

1. في مشروع Unity، انتقِل إلى الملف Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

   • إذا كنت تستخدم "إدارة حزم Unity"، انتقِل إلى الحزم > إعلانات Google على الأجهزة الجوّالة في Unity > GoogleMobileAds > المحرّر > 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.1">
     <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.1.1">
    <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>

عمليات التكامل مع التوسّط

إذا كنت تستخدم التوسّط، اتّبِع دليل نقل البيانات إلى Android لـ استبعاد وحدات com.google.android.gms في عمليات التكامل مع التوسّط لتجنُّب أخطاء الفئات المكرّرة.