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