نقل حزمة تطوير البرامج (SDK)

تتناول هذه الصفحة عمليات نقل البيانات للإصدارات الحالية والسابقة.

نقل البيانات من الإصدار 22 إلى الإصدار 23

الحد الأدنى لمستوى واجهة برمجة تطبيقات Android هو 21.

بدءًا من الإصدار 23.0.0، تتطلب حزمة SDK لإعلانات Google على الأجهزة الجوّالة أن تكون كل التطبيقات على المستوى 21 من واجهة برمجة تطبيقات Android كحد أدنى لتشغيله. لضبط مستوى واجهة برمجة التطبيقات، يمكنك تغيير minSdkVersion في ملف build.gradle على مستوى التطبيق إلى 21 أو أعلى.

يمكن ربط AdManagerAdRequest.Builder طريقة مكتسبة من الفئة الفائقة

في الإصدار 23.0.0، AdManagerAdRequest.Builder والموروثة من مصدرها الأصلي يمكن ربطها ببعضها البعض لإنشاء AdManagerAdRequest باستخدام مكالمة واحدة:

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
    .setContentUrl("https://www.example.com") // Method inherited from parent.
    .build(); // Builds an AdManagerAdRequest.

var request = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
  .setContentUrl("https://www.example.com") // Method inherited from parent.
  .build() // Builds an AdManagerAdRequest.

إزالة/استبدال الطرق التي تم إيقافها نهائيًا

نقل البيانات من الإصدار 21 إلى الإصدار 22

استخدام MobileAds.getVersion() للحصول على إصدار "SDK لإعلانات Google على الأجهزة الجوّالة"

تمت إزالة طريقة MobileAds.getVersionString() في الإصدار 22.0.0 لصالحه. من MobileAds.getVersion()

تُرجع الطريقة الجديدة رقم الإصدار الخارجي المتوقع — على سبيل المثال، 22.0.0 لمزيد من المعلومات حول هذا التغيير، راجع استخدام تطبيق Google للجوّال الجديد حزمة تطوير البرامج (SDK) للإعلانات getVersion() .

إزالة NativeCustomFormatAd.getVideoMediaView() المتوقّف نهائيًا

في الإصدار 21، قدّمت لك حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" طريقة NativeCustomFormatAd.getVideoMediaView() للحصول على مادة عرض الوسائط شكل الإعلان المدمج مع المحتوى.

بدءًا من الإصدار 22، ستنشئ "MediaView" وتضبط الوسائط الخاصة به. والمحتوى واستخدام MediaContent.getVideoController() للحصول على عناصر التحكّم في الفيديو

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the id media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    MediaContent mediaContent = ad.getMediaContent();
    if (mediaContent != null && mediaContent.hasVideoContent()) {
        // Create a MediaView and set its media content.
        MediaView mediaView = new MediaView(mediaPlaceholder.getContext());
        mediaView.setMediaContent(mediaContent);
        mediaPlaceholder.addView(mediaView);
    }
}

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the id media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    VideoController videoController = ad.getVideoController();
    if (videoController.hasVideoContent()) {
        // Add the media view provided by the native ad.
        mediaPlaceholder.addView(ad.getVideoMediaView());
    }
}

الاطلاع على الإعلان المدمج مع المحتوى الإعلان للحصول على المزيد من المعلومات.

الطرق التي تمت إزالتها أو استبدالها

يسرد الجدول التالي التغييرات المحددة في الإصدار 22.0.0.

نقل البيانات من الإصدار 20 إلى الإصدار 21

تحديث minSdkVersion إلى 19 أو إصدار أعلى

بدايةً من الإصدار 21.0.0، تتطلب حزمة SDK لإعلانات Google على الأجهزة الجوّالة أن تكون كل التطبيقات على الحد الأدنى من المستوى 19 لواجهة برمجة تطبيقات Android لضبط مستوى واجهة برمجة التطبيقات، يمكنك تغيير minSdkVersion في ملف الإصدار لتطبيقك إلى 19 أو أعلى.

فرض قابلية صارمة للقبول

في إطار الاستعداد لفرض قابلية صارمة للقبول، يتم استخدام تعليقات @NonNull التوضيحية: تمت إضافتها في جميع واجهات برمجة التطبيقات التي لم تحدد مسبقًا قابلية القيم الفارغة بشكل صريح.

قد يؤدي هذا التغيير إلى إيقاف تطبيقات Kotlin والتطبيقات التي تستخدم التحقّق من القيم الفارغة في Java. إطار العمل إذا كان هناك انتهاكات لأمان فارغة ولم يتم التعامل معها مسبقًا قيم null بطريقة آمنة (راجِع وثائق Kotlin على إعدادات خالية من الأمان ).

إزالة طريقة addNetworkExtras()

طريقة addNetworkExtras() التي تمرر معلَمات إضافية باعتبارها تم إيقاف مثيل NetworkExtras لمحوِّل شبكة إعلانات معيَّن نهائيًا في حزمة تطوير البرامج (SDK). الإصدار 20.3.0 وستتم إزالته في الإصدار 21.0.0. يمكنك استخدام addNetworkExtrasBundle() من نفس الفئة AdRequest.Builder بدلاً من ذلك.

إزالة طرق تحديد الموقع الجغرافي

في الإصدار 21.0.0، ستتم إزالة طرق المواقع الجغرافية التالية:

• الطريقة setLocation(Location location) في الفئة AdRequest.Builder التي تضبط موقع المستخدِم الجغرافي لأغراض استهداف التوسّط.
• الطريقة getLocation() في الفئة AdRequest التي تعرض سلوك المستخدم معلومات الموقع الجغرافي المستهدف التي تم تمريرها سابقًا إلى طريقة setLocation(Location location).
• تُستخدم الطريقة getLocation() في الفئة MediationAdConfiguration تعرض موقع المستخدم الجغرافي، إذا تم تحديده من خلال AdRequest.

ولا تستخدم Google بيانات الموقع الجغرافي لاستهداف الإعلانات. يجب عليك استخدام واجهات برمجة التطبيقات التابعة لجهات خارجية لتوفير المعلومات إلى شبكات الإعلانات التابعة لجهات خارجية إذا مطلوبة.

إيقاف واجهات الأحداث المخصّصة نهائيًا

تمكّن الأحداث المخصّصة الناشرين الذين يستخدمون التوسّط لإعداد مصدر إعلانات للعرض بدون انقطاع واحد من Ad Manager مصادر الإعلانات المتوافقة

جميع العناصر المخصصة فعالية يتم إيقاف الواجهات لصالح Adapter الفئة MediationAdLoadCallback من واجهة pyplot.

يسرد الجدول أدناه الفئة أو الواجهة المقابلة التي يجب استخدامها لكل واجهة حدث مخصّص بدءًا من الإصدار 21.0.0:

نقل البيانات من الإصدار 19 إلى الإصدار 20

هناك العديد من التغييرات التي قد تؤدي إلى أعطال في الإصدار 20.0.0. طرح الإصدار 19.7.0 والعديد من واجهات برمجة التطبيقات الجديدة، كما تم إيقاف العمل بالعديد من الفئات أو إعادة تسميتها استعدادًا للإصدار 20.0.0. يسلط هذا الدليل الضوء على التغييرات الرئيسية في الإصدار 20.0.0.

تحديثات واجهة برمجة التطبيقات لتنسيق ملء الشاشة

بدءًا من الإصدار 20.0.0، والإعلانات البينية والإعلانات التي تضم مكافأة، والإعلانات البينية التي تضم مكافأة يتم توحيد أشكال الإعلانات على شاشة فتح التطبيق لاتّباع تصميم متناسق لواجهة برمجة التطبيقات.

تستخدم جميع واجهات برمجة التطبيقات لتنسيق ملء الشاشة المبادئ التالية:

• طريقة التحميل الثابتة
• آلية مشابهة لرد الاتصال أو معالج التحميل
• الاعتماد على FullScreenContentCallback فئة استدعاءات العرض التقديمي

إزالة واجهة برمجة التطبيقات لإعلانات ودافيا من خلال الإعلانات القديمة

الأحدث RewardedAd تمّ طرح واجهة برمجة التطبيقات للمرة الأولى في آذار (مارس) 2019، فكانت الأفضل من حيث عدد الإعلانات بمكافأة. واجهة برمجة التطبيقات لأكثر من 18 شهرًا. تحتوي على مزيد من التحسينات مقارنةً بالقديمة واجهة برمجة تطبيقات RewardedVideoAd، بما في ذلك إمكانية تحميل أكثر من إعلان واحد يضم مكافأة في كل مرة.

تمت إزالة واجهة برمجة التطبيقات RewardedVideoAd القديمة في الإصدار 20.0.0 من حزمة تطوير البرامج (SDK).

إيقاف البانر الذكي نهائيًا لصالح إعلان البانر التكيُّفي

تم إيقاف إعلانات البانر الذكية نهائيًا. لصالح بانر تكيُّفي الإعلانات. توفّر إعلانات البانر التكيُّفية أداءً فائقًا ومرونة أكبر في تعيين عرض الإعلان. إذا كنت تفضّل مواصلة استخدام إعلانات بانر ذات العرض الكامل، يمكن باستخدام إعلان بانر تكيُّفي، كما هو موضّح في مقتطف الرمز التالي:

public class MyActivity extends AppCompatActivity {
  ...
  private AdSize getFullWidthAdaptiveSize() {
    Display display = getWindowManager().getDefaultDisplay();
    DisplayMetrics outMetrics = new DisplayMetrics();
    display.getMetrics(outMetrics);

    float widthPixels = outMetrics.widthPixels;
    float density = outMetrics.density;

    int adWidth = (int) (widthPixels / density);
    return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth);
  }
}

class MyActivity : AppCompatActivity() {
  ...
  private val adaptiveAdSize: AdSize
    get() {
      val display = windowManager.defaultDisplay
      val outMetrics = DisplayMetrics()
      display.getMetrics(outMetrics)

      val density = outMetrics.density

      var adWidthPixels = ad_view_container.width.toFloat()
      if (adWidthPixels == 0f) {
        adWidthPixels = outMetrics.widthPixels.toFloat()
      }

      val adWidth = (adWidthPixels / density).toInt()
      return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth)
    }
}

مغادرة إزالة معاودة الاتصال بالتطبيق

تمت إزالة استدعاء onAdLeftApplication لجميع أشكال الإعلانات لصالحه من ProcessLifecycleOwner من خلال استخدام واجهة برمجة تطبيقات على مستوى نظام التشغيل، يتم إرسال إشعار إليك كلما غادر المستخدمون تطبيقك، بغض النظر عن سواء كان ذلك بسبب تفاعل مع الإعلان أم لا.

يُرجى العلم أنّ معاودة الاتصال onAdLeftApplication لم يكن الغرض منها أبدًا أن تكون إعلانًا. لم معالج النقرات، ولم ينتج عن الاعتماد على هذا الاستدعاء هذا للإبلاغ عن النقرات مقياس دقيق. على سبيل المثال، يؤدي النقر على رمز "خيارات الإعلان" إلى تشغيل متصفح خارجي استدعى معاودة الاتصال، ولكن لم يتم احتسابه كنقرة.

عمليات إعادة تسمية الصف

يسرد الجدول الوارد أدناه أسماء الفئات المحدّدة التي تم تغييرها أو إزالتها. ضِمن الملخص:

• تمت إعادة تسمية معظم الصفوف ذات الصلة بـ "UnifiedNativeAd" إلى "NativeAd".
• MobileAds.Settings وNativeExpressAdView وNativeAppInstallAd تمّت إزالة NativeContentAd وInstreamAd من الصفوف والمشاهدات.
• تم استبدال كل الصفوف التي تبدأ بالبادئة Publisher بسمة بادئة AdManager.
• تم تغيير اسم حزمة InterstitialAd.

تمت إزالة أو استبدال الطرق.

يسرد الجدول التالي التغييرات المحددة في الإصدار 20.0.0. باختصار:

• تمت إزالة طرق الإعداد القديمة من فئة إعلانات الأجهزة الجوّالة.
• تمّت إزالة بعض الطرق من الفئة AdRequest.Builder(). أو نقله إلى الصف RequestConfiguration.
• تم تعديل واجهات برمجة التطبيقات للإعلانات التي تضم مكافآت والإعلانات البينية لتتوافق مع جميع بتنسيقات ملء الشاشة.
• تمت إزالة الميزات الارتباطية.