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

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

لتفعيل GMA Next-Gen SDK لإنشاءات Android، يُرجى اتّباع الخطوات التالية:

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

    • إذا كنت تستخدم Unity Package Manager، انتقِل إلى الحِزم > إعلانات 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.0">
  <repositories>
    <repository>https://maven.google.com/</repository>
  </repositories>
</androidPackage>

  4. احفظ الملف.

أثناء عملية الإنشاء، يرصد Google Mobile Ads Unity Plugin وجود GMA Next-Gen SDK ويستخدم عملية التنفيذ.

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

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

الاطّلاع على المثال الكامل

يوضِّح المثال التالي ملف GoogleMobileAdsDependencies.xml المعدَّل:

<dependencies>
  <androidPackages>
    <androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.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>