تثبيت حزمة تطوير البرامج "الجيل التالي من إعلانات 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.2.1">
  <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.2.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>

استبعاد وحدات com.google.android.gms في عمليات دمج التوسّط

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