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

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

لتفعيل 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.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>