تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

نقل البيانات من الإصدار 10 إلى الإصدار 11

الحد الأدنى لهدف النشر

تمت زيادة الحد الأدنى لهدف النشر إلى الإصدار 12 من نظام التشغيل iOS.

الحد الأدنى لإصدار Xcode

وتمت زيادة الحد الأدنى لإصدار Xcode المتوافق إلى 15.1.

إيقاف عرض الإعلانات على نظام التشغيل iOS 12

لا يعرض الإصدار 11.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الإعلانات إلا على الأجهزة التي تعمل بنظام التشغيل iOS 13. وأعلى.

تمت إزالة الاعتمادية على GoogleAppMeasurement.

وفي الإصدار 11.0.0، تُعد التبعية تم GoogleAppMeasurement تمت إزالته. ستكون هذه الاعتمادية التي ساهمت في تبديل مقاييس سلوك المستخدِمين في AdMob هي متوقّفة نهائيًا في أوائل عام 2024. إلى مواصلة جمع مقاييس سلوك المستخدِمين في AdMob ربط تطبيقك على AdMob بمنصّة Firebase دمج حزمة تطوير البرامج (SDK) لإحصاءات Google لبرنامج Firebase في تطبيقك.

تغييرات في طريقة عرض الإعلان بملء الشاشة

تؤثّر التغييرات التالية في أشكال الإعلانات المختلفة:

إعلان على شاشة فتح التطبيق
إعلان بيني
تم منح المكافأة
إعلان بيني يضم مكافأة

معلمة وحدة التحكم في العرض في -canPresentFromRootViewController:error: و -presentFromRootViewController: قابل للقيم الفارغة. إذا لم يتم تجاوز القيمة، يصبح الإعلان المقدمة من أعلى وحدة تحكم في العرض في التسلسل الهرمي لوحدة التحكم في العرض.

تمت إزالة الطرق

تتم إزالة الطرق التالية.

نوع الإصدار 11.0.0	الطريقة	ملاحظات
GADAppOpenAd	`load(withAdUnitID adUnitID: String, request: GADRequest?, orientation: UIInterfaceOrientation)`	يمكنك استخدام `load(withAdUnitID adUnitID: String, request: GADRequest?)` بدلاً من ذلك.
GADMediationBannerAdEventDelegate	`willBackgroundApplication()`	لا يوجد بديل.
GADMediationInterstitialAdEventDelegate	`willBackgroundApplication()`	لا يوجد بديل.
GADMediationNativeAdEventDelegate	`willBackgroundApplication()`	لا يوجد بديل.
GADMediationRewardedAdEventDelegate	`didRewardUser(with reward: GADAdReward)`	يمكنك استخدام `didRewardUser()` بدلاً من ذلك.
GADMediatedUnifiedNativeAdNotificationSource	`mediatedNativeAdWillLeaveApplication(_ mediatedNativeAd: GADMediatedUnifiedNativeAd)`	لا يوجد بديل.
GADRequestConfiguration	`setSameAppKeyEnabled(_ enabled: Bool)`	يمكنك استخدام `setPublisherFirstPartyIDEnabled(_ enabled: Bool)` كبديل.
	`tagForUnderAge(ofConsent underAgeOfConsent: Bool)`	استخدِم السمة `tagForUnderAgeOfConsent` بدلاً من ذلك.
	`tag(forChildDirectedTreatment childDirectedTreatment: Bool)`	استخدِم السمة `tagForChildDirectedTreatment` بدلاً من ذلك.

تمت إزالة المواقع

تمت إزالة السمات التالية.

فئة الإصدار 11.0.0	الموقع	ملاحظات
GADMediationAdConfiguration	hasUserLocation	لا يوجد بديل.
	userLatitude
	userLongitude
	userLocationAccuracyInMeters
	childDirectedTreatment	يمكنك استخدام `GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment` بدلاً من ذلك.
GADResponseInfo	adNetworkClassName	يمكنك استخدام `adNetworkClassName` من `loadedAdNetworkResponseInfo` بدلاً من ذلك.

تمت إزالة GADAdFormatUnknown

تمت إزالة "GADAdFormatUnknown" بدون بديل.

تغييرات على تسجيل إصدار حزمة تطوير البرامج (SDK)

يزيل الإصدار 11.0.0 sdkVersion. لتسجيل إصدار "SDK لإعلانات Google على الأجهزة الجوّالة"، استخدام versionNumber بدلاً من ذلك.

الإصدار 10.0.0

GADMobileAds.sharedInstance().sdkVersion

الإصدار 11.0.0

GADGetStringFromVersionNumber(GADMobileAds.sharedInstance().versionNumber)

تغييرات على معالجة أخطاء GADAdLoader

بدءًا من الإصدار 11.0.0، لن يقدّم GADAdLoader طلب إعلان إذا كان delegate لا تتوافق مع أنواع الإعلانات المطلوبة والبروتوكول المفوَّض. في السابق، فشلت بعد تقديم طلب الإعلان.

التغييرات على سلوك الاختبار

اطّلِع على الجدول الذي يعرض الشروط المعدَّلة في الحالات التالية: الخصائص التي تعرض true.

دورات تدريبية	الموقع
GADMediationAdConfiguration	`isTestRequest`
GADCustomEventRequest	`isTesting`
v10.0.0	v11.0.0
تم الإعلان عن الجهاز صراحةً على أنّه جهاز اختبار في `testDeviceIdentifiers`.	تم الإعلان عن الجهاز صراحةً على أنّه جهاز اختبار في `testDeviceIdentifiers`. الجهاز هو محاكي. تم الإعلان عن الجهاز صراحةً على أنّه جهاز اختبار في واجهة المستخدم Ad Manager .

نقل البيانات من الإصدار 9 إلى الإصدار 10

توقّف عرض الإعلانات على نظام التشغيل iOS 11

يعرض الإصدار 10.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" الإعلانات فقط على الأجهزة التي تعمل بنظام التشغيل iOS 12 والإصدارات الأحدث.

لن تؤدي الترقية إلى الإصدار 10.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى تعطُّل تطبيقك على الأجهزة التي تعمل بنظامَي التشغيل iOS 11 وiOS 10، ومع ذلك، لن يتمّ عرض أيّ إعلانات على تلك الأجهزة.

متطلبات رقم تعريف تطبيق "مدير الإعلانات"

رقم تعريف تطبيق "مدير الإعلانات" مطلوب الآن في Info.plist لجميع تطبيقات "مدير الإعلانات" ويتطلب التنسيق ca-app-pub-################~##########. يمكنك مراجعة تعديل Info.plist للحصول على مزيد من التفاصيل.

متطلبات GoogleAppMeasurement.xcframework

أصبح GoogleAppMeasurement.xcframework مطلوبًا الآن لجميع تطبيقات "مدير الإعلانات". في حال تثبيت حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" من خلال Cocoapods أو Swift Package Manager، لن يكون عليك اتخاذ أي إجراء إضافي. في حال تثبيت أُطر العمل يدويًا، يُرجى الاطّلاع على التنزيل اليدوي للحصول على مزيد من التفاصيل.

لم يعُد من الممكن استخدام ميزة "إنشاء البيانات باستخدام رمز بت"

أصبح إيقاف رمز بت في التطبيقات المتوافقة مع الأجهزة الجوّالة مطلوبًا الآن لدمج حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

تمت إزالة الأنواع.

Type	Notes
GADGender	لا يوجد بديل.
GADMRewardBasedVideoAdNetworkAdapterProtocol	لقد توقّفت جميع محوِّلات التوسّط بمكافأة المدرَجة في قائمة Select Networks عن استخدام هذه البروتوكولات لمدة تزيد عن سنة. استخدِم GADMediationAdapter للتوسّط والأحداث المخصّصة.
GADMRewardBasedVideoAdNetworkConnectorProtocol

تمت إزالة المواقع

تمت إزالة السمات التالية بدون بديل.

الفئة v10.0.0	الموقع
GADMediationAdRequest	userBirthday
	userGender
	userHasLocation
	userLatitude
	userLongitude
	userLocationAccuracyInMeters
	userLocationDescription
GADCustomEventRequest	userHasLocation
	userLatitude
	userLongitude
	userLocationAccuracyInMeters
	userLocationDescription

نقل البيانات من الإصدار 8 إلى الإصدار 9

توقّف عرض الإعلانات على نظام التشغيل iOS 10

الحد الأدنى لإصدار نظام التشغيل iOS الذي يتوافق مع الإصدار 9.0.0 من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة هو iOS 11.

لن تؤدي الترقية إلى الإصدار 9.0.0 من حزمة SDK لإعلانات Google على الأجهزة الجوّالة إلى تعطُّل تطبيقك على الأجهزة التي تعمل بنظام التشغيل iOS 10، ومع ذلك، لن يتم عرض أي إعلانات على تلك الأجهزة.

تنفيذ أكثر صرامة لعناصر التحكم في شريط الحالة

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

بناءً على التخطيط المحدد لوحدات التحكم في طريقة العرض في تطبيقك، قد لا تحتاج إلى إجراء أي تغييرات لضمان ذلك. فكّر في ما إذا كنت بحاجة إلى ضبط السمة childViewControllerForStatusBarHidden على rootViewController لإعلانك.

إعادة تسمية adDidPresentFullscreenContent: إلى adwillPresentFullscreenContent:

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

إزالة واجهة برمجة تطبيقات إعداد الموقع الجغرافي على GADRequest

تم حذف - (void)setLocationWithLatitude:longitude:accuracy: من GADRequest نظرًا لأن Google لا تستخدم بيانات الموقع الجغرافي لاستهداف الإعلانات. استخدِم واجهات برمجة التطبيقات التابعة لجهات خارجية لتوفير المعلومات لشبكات المواقع الإعلانية التابعة لجهات خارجية إذا لزم الأمر.

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

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

تم إيقاف جميع بروتوكولات الأحداث المخصّصة نهائيًا. بدلاً من ذلك، استخدِم البروتوكولَين الحاليَين GADMediationAdapter وGADMediationAdEventDelegate لتحقيق الوظائف نفسها. يساعد هذا التغيير في زيادة الوضوح ويتيح لك إنشاء أحداث مخصّصة للإعلانات التي تضم مكافآت والإعلانات البينية التي لم تكن متوفّرة في السابق.

واجهات برمجة التطبيقات

يسرد الجدول التالي واجهات برمجة التطبيقات المقابلة لمحوّل التوسّط مع واجهات برمجة التطبيقات للأحداث المخصّصة التي يجب استخدامها بدءًا من الإصدار 9.0.0.

v8	v9
GADCustomEventBanner GADCustomEventInterstitial GADCustomEventNativeAd	GADMediationAdapter	GADMediationBannerAd GADMediationInterstitialAd GADMediationInterscrollerAd GADMediationRewardedAd GADMediationNativeAd
`delegate`	يتم عرض التفويض من خلال معالج إكمال التحميل لكل دالة تحميل من فئات `GADMediationAdapter`.
`-init`	`-init`
`-requestBannerAd:parameter:label:request:`	`-loadBannerForAdConfiguration:completionHandler:`
`-requestInterstitialAdWithParameter:label:request:`	`-loadInterstitialForAdConfiguration:completionHandler:`
`-requestNativeAdWithParameter:request:adTypes:options:rootViewController:`	`-loadNativeAdForAdConfiguration:completionHandler:`
لا ينطبق	`-loadInterscrollerAdForAdConfiguration:completionHandler:`
لا ينطبق	`-loadRewardedAdForAdConfiguration:completionHandler:`
`-presentFromRootViewController:`		`-presentFromViewController:`
`-handlesUserClicks`		`-handlesUserClicks`
`-handlesUserImpressions`		`-handlesUserImpressions`

طرق التفويض

يسرد الجدول أدناه طرق تفويض حدث إعلان التوسّط المقابلة لطرق تفويض الحدث المخصّصة التي يجب استخدامها بدءًا من الإصدار 9.0.0.

v8	v9
GADCustomEventBanner الإدارة GADCustomEventInterstitial فواتير GADCustomEventNativeAdدور	GADMediationAdEventDelegate	إعلان GADMediation
`-customEventBanner:didReceiveAd:` `-customEventInterstitialDidReceiveAd:`	يتم تضمين حالة تحميل الإعلانات في معالج إكمال التحميل لكل دالة تحميل في الفئة `GADMediationAdapter`.
`-customEventBanner:didFailAd:` `-customEventInterstitial:didFailAd:`
`-customEventBannerWasClicked:` `-customEventInterstitialWasClicked:`	`-reportClick`
`-customEventBannerWillPresentModal:` `-customEventInterstitialWillPresentModal:`	`-willPresentFullScreenView`
`-customEventBannerWillDismissModal:` `-customEventInterstitialWillDismissModal:`	`-willDismissFullScreenView`
`-customEventBannerDidDismissModal:` `-customEventInterstitialDidDismissModal:`	`-didDismissFullScreenView`
`-customEventBannerWillLeaveApplication:` `-customEventInterstitialWillLeaveApplication:`	`-willBackgroundApplication`
`viewControllerForPresentingModalView`		`-[GADMediationBannerAd view]`

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

التغييرات في الطريقة أو الثبات أو الخاصية
`kGAD-` ثوابت بادئة	تمّت إزالة الموضوع. استخدِم ثوابت `GAD-` مسبوقة.
`GADAdNetworkResponseInfo`	تمّت إزالة `credentials`. يمكنك استخدام `adUnitMapping` بدلاً من ذلك.
`GAMRequest`	تم إيقاف `kGAMSimulatorID` في `GAMRequest` نهائيًا. يمكنك استخدام `GADSimulatorID` في `GADRequestConfiguration` بدلاً من ذلك.
`GADCustomNativeAd`	تم إيقاف `mediaView` في `GADCustomNativeAd` نهائيًا. يمكنك استخدام `mediaContent` كبديل.
واجهات برمجة التطبيقات للشراء داخل التطبيق في `GoogleMobileAds`	تمت إزالة `inAppPurchase` واجهات برمجة تطبيقات في `GoogleMobileAds`.

نقل البيانات من الإصدار 7 إلى الإصدار 8

يتضمّن الإصدار 8.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" بعض التغييرات الرئيسية، بالإضافة إلى بعض عمليات إعادة تسمية واجهات برمجة التطبيقات وإزالتها.

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

بدءًا من الإصدار 8.0.0، تتشارك الإعلانات البينية والإعلانات التي تضم مكافأة عامًا كاملاً نمط الإعلان على الشاشة لتحقيق مزيد من الاتساق. تحتوي واجهات برمجة التطبيقات الجديدة للإعلانات التي يتم عرضها بملء الشاشة على اثنين الاختلافات الرئيسية عن الإصدار 7 من واجهات برمجة التطبيقات للإعلانات بملء الشاشة:

طريقة الصف الثابتة load

في ما يلي الطريقة السابقة لتحميل/عرض إعلان بملء الشاشة:
1. أنشئ مثيل كائن إعلان واحتفظ بإشارة إليه.
2. عيِّن مستخدمًا يشرف على التحميل ويعرض عمليات معاودة الاتصال.
3. حمِّل إعلانًا.
4. تحقَّق ممّا إذا تم تحميل الإعلان باستخدام isReady.
5. اعرض الإعلان.
في الإصدار 8، تغيرت النهج قليلاً. لم يعد تحميل طلبات معاودة الاتصال كجزء من الشخص المفوَّض. وبدلاً من ذلك، يتم تمريرها إلى طريقة load باعتبارها معالج الإكمال:
1. استدعاء طريقة تحميل ثابتة في فئة الإعلان وتوفير إكمال التحميل .
2. في استدعاء إكمال التحميل، ارجع إلى الإعلان الذي تم تحميله والذي عاد.
3. عيِّن مستخدمًا مفوّضًا لمعالجة طلبات معاودة الاتصال.
4. اعرض الإعلان.
يوفر الأسلوب الجديد المزايا التالية:
- ولن يكون لديك أبدًا إشارة إلى إعلان لم يتم تحميله.
- لن تحتاج إلى الاحتفاظ بكائن الإعلان أثناء تحميله.

أحداث الإعلانات المنتظمة:

نوع الحدث	واجهة برمجة التطبيقات الحالية	الإصدار 8 من واجهة برمجة التطبيقات
تحميل الأحداث	`GADInterstitialDelegate` أو `GADRewardedAdDelegate`	`GAMInterstitialAdLoadCompletionHandler` أو `GADRewardedAdLoadCompletionHandler`
أحداث العروض التقديمية	`GADInterstitialDelegate` أو `GADRewardedAdDelegate`	`GADFullScreenContentDelegate`

في السابق، للاستماع إلى أي أحداث إعلانية، كنت تريد تسجيل فئة لتنفيذ GADInterstitialDelegate إلى الملكية المفوَّضة لأحد الإعلانات البينية أو تسجيل فئة لتنفيذ GADRewardedAdDelegate إلى الموقع المفوَّض للإعلان الذي يضم مكافأة بناءً على شكل الإعلان التي تستخدمها. كان لدى هذا الشخص المفوَّض نفسه طرق تتعلق بكل من التحميل دورة حياة العرض التقديمي للإعلان.

وفي الإصدار 8، تكون أحداث التحميل والعرض التقديمي منفصلة. يمكنك الآن تسجيل GADFullScreenContentDelegate أي وقت قبل عرض إعلان بدلاً من أن يُطلب منه تحديد قبل تحميل الإعلان. أحداث عدد الإعلانات المخصّصة لكلّ منها التنسيق، انتقل إلى معالج واحد لاكتمال التحميل تم تمريره في طريقة التحميل.

إعلان بيني

تحميل الإعلان

توضِّح لك مقتطفات الرمز أدناه كيفية تحميل إعلان بيني والاستماع إلى الأحداث التي يتم عندها عرض الإعلان بنجاح أو تعذُّر تحميله.

الإصدار 7

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADInterstitialDelegate {

  var interstitial: DFPInterstitial!

  override func viewDidLoad() {
    super.viewDidLoad()
    interstitial = DFPInterstitial(adUnitID: "/21775744923/example/interstitial")
    interstitial.delegate = self
    let request = GAMRequest()
    interstitial.load(request)
  }

  /// Tells the delegate an ad request succeeded.
  func interstitialDidReceiveAd(_ ad: DFPInterstitial) {
    print("Interstitial ad loaded.")
  }

  /// Tells the delegate an ad request failed.
  func interstitial(_ ad: DFPInterstitial, didFailToReceiveAdWithError error: GADRequestError) {
    print("Interstitial ad failed to load with error: \(error.localizedDescription)")
  }
}

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController () 

@property(nonatomic, strong) DFPInterstitial *interstitial;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  self.interstitial = [[DFPInterstitial alloc]
      initWithAdUnitID:@"/21775744923/example/interstitial"];
  self.interstitial.delegate = self;
  GAMRequest *request = [GAMRequest request];
  [self.interstitial loadRequest:request];
}

/// Tells the delegate an ad request succeeded.
- (void)interstitialDidReceiveAd:(DFPInterstitial *)ad {
  NSLog(@"Insterstitial ad loaded.");
}

/// Tells the delegate an ad request failed.
- (void)interstitial:(DFPInterstitial *)ad
    didFailToReceiveAdWithError:(GADRequestError *)error {
  NSLog(@"Interstitial ad failed to load with error: %@", [error localizedDescription]);
}

v8

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADFullScreenContentDelegate {

  var interstitial: GAMInterstitialAd?

  override func viewDidLoad() {
    super.viewDidLoad()
    let request = GAMRequest()
    GAMInterstitialAd.load(withAdUnitID:"ca-app-pub-8123415297019784/4985798738",
                                request: request,
                      completionHandler: { (ad, error) in
                        if let error = error {
                          print("Failed to load interstitial ad with error: \(error.localizedDescription)")
                          return
                        }
                        self.interstitial = ad
                        self.interstitial.fullScreenContentDelegate = self
                      }
    )
  }
}

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController () 

@property(nonatomic, strong) GAMInterstitialAd *interstitial;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  GAMRequest *request = [GAMRequest request];
  [GAMInterstitialAd loadWithAdUnitID:@"/21775744923/example/interstitial"
                              request:request
                    completionHandler:^(GAMInterstitialAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Failed to load interstitial ad with error: %@", [error localizedDescription]);
      return;
    }
    self.interstitial = ad;
    self.interstitial.fullScreenContentDelegate = self;
  }];
}

إعلان صوري

الإصدار 7

Swift

func showInterstitial() {
  ...
  if interstitial.isReady {
    interstitial.present(fromRootViewController: self)
  } else {
    print("Ad wasn't ready")
  }
}

Objective-C

- (void)showInterstitial: {
  ...
  if (self.interstitial.isReady) {
    [self.interstitial presentFromRootViewController:self];
  } else {
    NSLog(@"Ad wasn't ready");
  }
}

v8

Swift

func showInterstitial() {
  ...
  if let ad = interstitial {
    ad.present(fromRootViewController: self)
  } else {
    print("Ad wasn't ready")
  }
}

Objective-C

- (void)showInterstitial: {
  ...
  if (self.interstitial) {
    [self.interstitial presentFromRootViewController:self];
  } else {
    NSLog(@"Ad wasn't ready");
  }
}

أحداث إعلانات العرض التقديمي

توضّح لك مقتطفات الرمز أدناه كيفية التعامل مع عمليات الاستدعاء عندما يتم عرض الإعلان تقديمه (بنجاح أو غير ناجح) وعند رفضه.

الإصدار 7

Swift

override func viewDidLoad() {
  super.viewDidLoad()
  interstitial = DFPInterstitial(adUnitID: "/21775744923/example/interstitial")
  interstitial.delegate = self
  ...
}

/// Tells the delegate that an interstitial will be presented.
func interstitialWillPresentScreen(_ ad: DFPInterstitial) {
  print("Interstitial ad will be presented.")
}

/// Tells the delegate the interstitial is to be animated off the screen.
func interstitialWillDismissScreen(_ ad: DFPInterstitial) {
  print("Interstitial ad will be dismissed.")
}

/// Tells the delegate the interstitial had been animated off the screen.
func interstitialDidDismissScreen(_ ad: DFPInterstitial) {
  print("Interstitial ad dismissed.")
}

/// Tells the delegate that a user click will open another app
/// (such as the App Store), backgrounding the current app.
///
/// This is not a reliable callback for an ad click event and is removed in
/// version 8. If you wish to listen to an ad causing a user to leave the app,
/// use applicationWillResignActive: or sceneWillResignActive: instead.
func interstitialWillLeaveApplication(_ ad: DFPInterstitial) {
  print("Interstitial ad will leave application.")
}

Objective-C

- (void)viewDidLoad {
  [super viewDidLoad];
  self.interstitial = [[DFPInterstitial alloc] initWithAdUnitID:"/21775744923/example/interstitial"];
  self.interstitial.delegate = self;
  ...
}

/// Tells the delegate that an interstitial will be presented.
- (void)interstitialWillPresentScreen:(DFPInterstitial *)ad {
  NSLog(@"Interstitial ad will be presented.");
}

/// Tells the delegate the interstitial is to be animated off the screen.
- (void)interstitialWillDismissScreen:(DFPInterstitial *)ad {
  NSLog(@"Interstitial ad will be dismissed.");
}

/// Tells the delegate the interstitial had been animated off the screen.
- (void)interstitialDidDismissScreen:(DFPInterstitial *)ad {
  NSLog(@"Interstitial ad dismissed.");
}

/// Tells the delegate that a user click will open another app
/// (such as the App Store), backgrounding the current app.
///
/// This is not a reliable callback for an ad click event and is removed in
/// version 8. If you wish to listen to an ad causing a user to leave the app,
/// use applicationWillResignActive: or sceneWillResignActive: instead.
- (void)interstitialWillLeaveApplication:(DFPInterstitial *)ad {
  NSLog(@"Interstitial ad will leave application.");
}

v8

Swift

override func viewDidLoad() {
  super.viewDidLoad()
  let request = GAMRequest()
  GAMInterstitialAd.load(withAdUnitID:"ca-app-pub-8123415297019784/4985798738",
                              request: request,
                    completionHandler: { (ad, error) in
                      if let error = error {
                        print(error.localizedDescription)
                        return
                      }
                      self.interstitial = ad
                      self.interstitial.fullScreenContentDelegate = self
                    }
  )
}

func adDidPresentFullScreenContent(_ ad: GADFullScreenPresentingAd) {
  print("Ad did present full screen content.")
}

func ad(_ ad: GADFullScreenPresentingAd, didFailToPresentFullScreenContentWithError error: Error) {
  print("Ad failed to present full screen content with error \(error.localizedDescription).")
}

func adDidDismissFullScreenContent(_ ad: GADFullScreenPresentingAd) {
  print("Ad did dismiss full screen content.")
}

Objective-C

- (void)viewDidLoad {
  [super viewDidLoad];
  GAMRequest *request = [GAMRequest request];
  [GAMInterstitialAd loadWithAdUnitID:@"/21775744923/example/interstitial"
                              request:request
                    completionHandler:^(GAMInterstitialAd *ad, NSError *error) {
    if (error) {
      NSLog(@"interstitial:didFailToReceiveAdWithError: %@", [error localizedDescription])
      return;
    }
    self.interstitial = ad;
    self.interstitial.fullScreenContentDelegate = self;
  }];
}

- (void)adDidPresentFullScreenContent:(id)ad {
  NSLog(@"Ad did present full screen content.");
}

- (void)ad:(id)ad didFailToPresentFullScreenContentWithError:(NSError *)error {
  NSLog(@"Ad failed to present full screen content with error %@.", [error localizedDescription]);
}

- (void)adDidDismissFullScreenContent:(id)ad {
  NSLog(@"Ad did dismiss full screen content.");
}

تم منح المكافأة

تحميل الإعلان

الإصدار 7

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADRewardedAdDelegate {
  /// The rewarded ad.
  var rewardedAd: GADRewardedAd?

  override func viewDidLoad() {
    super.viewDidLoad()
    rewardedAd = GADRewardedAd(adUnitID: "ca-app-pub-3940256099942544/1712485313")
    rewardedAd.delegate = self
    rewardedAd?.load(GAMRequest()) { error in
      if let error = error {
        print("Rewarded ad failed to load with error: \(error.localizedDescription)")
      } else {
        print("Rewarded ad loaded.")
      }
    }
  }
}

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController () 

@property(nonatomic, strong) GADRewardedAd *rewardedAd;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  self.rewardedAd = [[GADRewardedAd alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313"];
  self.rewardedAd.delegate = self;
  GAMRequest *request = [GAMRequest request];
  [self.rewardedAd loadRequest:request completionHandler:^(GADRequestError * _Nullable error) {
    if (error) {
      NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
    } else {
      NSLog(@"Rewarded ad loaded.");
    }
  }];
}

v8

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADFullScreenContentDelegate {
  /// The rewarded ad.
  var rewardedAd: GADRewardedAd?

  override func viewDidLoad() {
  super.viewDidLoad()
  let request = GAMRequest()
  GADRewardedAd.load(withAdUnitID: "ca-app-pub-8123415297019784/9501821136",
                          request: request, completionHandler: { (ad, error) in
                            if let error = error {
                              print("Rewarded ad failed to load with error: \(error.localizedDescription)")
                              return
                            }
                            self.rewardedAd = ad
                            self.rewardedAd?.fullScreenContentDelegate = self
                          }
  )
  }
}

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController () 

@property(nonatomic, strong) GADRewardedAd *rewardedAd;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  GAMRequest *request = [GAMRequest request];
  [GADRewardedAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313"
                          request:request
                completionHandler:^(GADRewardedAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
      return;
    }
    self.rewardedAd = ad;
    NSLog(@"Rewarded ad loaded.");
    self.rewardedAd.fullScreenContentDelegate = self;
}

مكافأة الإعلان الصوري والاسم المعرِّف

تتطلّب الإعلانات التي تضم مكافأة معالجة الحدث عندما يحصل المستخدم على مكافأة. مع 7 من واجهة برمجة تطبيقات GADRewardedAd، فأنت تنفّذ rewardedAd:userDidEarnReward: كجزء من بروتوكول GADRewardedAdDelegate. في الإصدار 8، عليك تنفيذ GADUserDidEarnRewardHandler بهدف اعرض الإعلان.

الإصدار 7

Swift

func showRewardedAd() {
  ...
  if rewardedAd.isReady {
    rewardedAd.present(fromRootViewController: self delegate:self)
  } else {
    print("Ad wasn't ready")
  }
}

/// Tells the delegate that the user earned a reward.
func rewardedAd(_ rewardedAd: GADRewardedAd, userDidEarnReward: GADAdReward) {
  // TODO: Reward the user.
}

Objective-C

- (void)showRewardedAd: {
  ...
  if (self.rewardedAd.isReady) {
    [self.rewardedAd presentFromRootViewController:self delegate:self];
  } else {
    NSLog(@"Ad wasn't ready");
  }
}

/// Tells the delegate that the user earned a reward.
- (void)rewardedAd:(GADRewardedAd *)rewardedAd userDidEarnReward:(GADAdReward *)reward {
  // TODO: Reward the user.
}

v8

Swift

func showRewardedAd() {
  ...
  if let ad = rewardedAd {
      ad.present(fromRootViewController: self,
               userDidEarnRewardHandler: {
                 let reward = ad.adReward
                 // TODO: Reward the user.
               }
      )
  } else {
    print("Ad wasn't ready")
  }
}

Objective-C

- (void)showRewardedAd: {
  ...
  if (self.rewardedAd) {
    [self.rewardedAd presentFromRootViewController:self
                          userDidEarnRewardHandler:^ {
      GADAdReward *reward = self.rewardedAd.adReward;
      // TODO: Reward the user.
    }];
  } else {
    NSLog(@"Ad wasn't ready");
  }
}

أحداث إعلانات العرض التقديمي

باستخدام GADRewardedAd API، يمكنك ضبط GADRewardedAdDelegate في الطريقة. التي تعرض الإعلان باستخدام GADRewardedAd API، يمكنك إعداد GADFullscreenContentDelegate كخاصية في الإعلان قبل عرض الإعلان.

الإصدار 7

Swift

func showRewardedAd() {
  ...
  if rewardedAd.isReady {
    rewardedAd.present(fromRootViewController: self delegate:self)
  } else {
    print("Ad wasn't ready")
  }
}

/// Tells the delegate that the rewarded ad was presented.
func rewardedAdDidPresent(_ rewardedAd: GADRewardedAd) {
  print("Rewarded ad presented.")
}
/// Tells the delegate that the rewarded ad was dismissed.
func rewardedAdDidDismiss(_ rewardedAd: GADRewardedAd) {
  print("Rewarded ad dismissed.")
}
/// Tells the delegate that the rewarded ad failed to present.
func rewardedAd(_ rewardedAd: GADRewardedAd, didFailToPresentWithError error: Error) {
  print("Rewarded ad failed to present with error: \(error.localizedDescription).")
}

Objective-C

- (void)showRewardedAd: {
  ...
  if (self.rewardedAd.isReady) {
    [self.rewardedAd presentFromRootViewController:self delegate:self];
  } else {
    NSLog(@"Ad wasn't ready");
  }
}

/// Tells the delegate that the rewarded ad was presented.
- (void)rewardedAdDidPresent:(GADRewardedAd *)rewardedAd {
  NSLog(@"Rewarded ad presented.");
}

/// Tells the delegate that the rewarded ad failed to present.
- (void)rewardedAd:(GADRewardedAd *)rewardedAd didFailToPresentWithError:(NSError *)error {
  NSLog(@"Rewarded ad failed to present with error: %@",
        [error localizedDescription]);
}

/// Tells the delegate that the rewarded ad was dismissed.
- (void)rewardedAdDidDismiss:(GADRewardedAd *)rewardedAd {
  NSLog(@"Rewarded ad dismissed.");
}

v8

Swift

override func viewDidLoad() {
  super.viewDidLoad()
  let request = GAMRequest()
  GADRewardedAd.load(withAdUnitID: "ca-app-pub-8123415297019784/9501821136",
                          request: request, completionHandler: { (ad, error) in
                            if let error = error {
                              print(error.localizedDescription)
                              return
                            }
                            self.rewardedAd = ad
                            self.rewardedAd?.fullScreenContentDelegate = self
                          }
  )
}

/// Tells the delegate that the rewarded ad was presented.
func adDidPresentFullScreenContent(_ ad: GADFullScreenPresentingAd) {
  print("Rewarded ad presented.")
}
/// Tells the delegate that the rewarded ad was dismissed.
func adDidDismissFullScreenContent(_ ad: GADFullScreenPresentingAd) {
  print("Rewarded ad dismissed.")
}
/// Tells the delegate that the rewarded ad failed to present.
func ad(_ ad: GADFullScreenPresentingAd,
    didFailToPresentFullScreenContentWithError error: Error) {
  print("Rewarded ad failed to present with error: \(error.localizedDescription).")
}

Objective-C

- (void)viewDidLoad {
  [super viewDidLoad];

  GAMRequest *request = [GAMRequest request];
  [GADRewardedAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313"
                          request:request
                completionHandler:^(GADRewardedAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
      return;
    }
    self.rewardedAd = ad;
    NSLog(@"Rewarded ad loaded.");
    self.rewardedAd.fullScreenContentDelegate = self;
}

/// Tells the delegate that the rewarded ad was presented.
- (void)adDidPresentFullScreenContent:(id)ad {
  NSLog(@"Rewarded ad presented.");
}

/// Tells the delegate that the rewarded ad failed to present.
- (void)ad:(id)ad
    didFailToPresentFullScreenContentWithError:(NSError *)error {
  NSLog(@"Rewarded ad failed to present with error: %@",
       [error localizedDescription]);
}

/// Tells the delegate that the rewarded ad was dismissed.
- (void)adDidDismissFullScreenContent:(id)ad {
  NSLog(@"Rewarded ad dismissed.");
}

إزالة واجهة برمجة التطبيقات القديمة GAD AwardedbasedVideoAd API

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

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

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

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

Swift

class ViewController: UIViewController {

  override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    // Note: The safe area is not known until viewWillAppear.
    let adSize = getFullWidthAdaptiveAdSize()
  }

  func getFullWidthAdaptiveAdSize() -> GADAdSize {
    // Here safe area is taken into account, hence the view frame is used after the
    // view has been laid out.
    let frame = { () -> CGRect in
      if #available(iOS 11.0, *) {
        return view.frame.inset(by: view.safeAreaInsets)
      } else {
        return view.frame
      }
    }()
    return GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(frame.size.width)
  }
}

Objective-C

@implementation ViewController

- (void)viewDidAppear:(BOOL)animated {
  [super viewDidAppear:animated];
  // Note: The safe area is not known until viewWillAppear.
  GADAdSize adSize = [self getFullWidthAdaptiveAdSize];
}

- (GADAdSize)getFullWidthAdaptiveAdSize {
  CGRect frame = self.view.frame;
  // Here safe area is taken into account, hence the view frame is used after
  // the view has been laid out.
  if (@available(iOS 11.0, *)) {
    frame = UIEdgeInsetsInsetRect(self.view.frame, self.view.safeAreaInsets);
  }
  return GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(frame.size.width);
}

@end

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

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

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

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

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

تمت إعادة تسمية جميع الصفوف ذات الصلة بـ "GADUnifiedNativeAd" إلى GADNativeAd
GADRewardBasedVideoAd وGADNativeExpressAdView وGADInstreamAd لديهما تمت إزالته.
تم استبدال جميع الصفوف التي تبدأ بالبادئة DFP بالبادئة GAM.

الإصدار 7.68.0 من فئة	فئة الإصدار 8.0.0
DFPBannerView	GAMBannerView
DFPBannerViewOptions	GAMBannerViewOptions
DFPInterstitial	GAMInterstitialAd
DFPRequest	GAMRequest
GADRequestError	NSError
GADUnifiedNativeAdView	GADNativeAdView
شركة GADUnifiedNativeAd	GADNativeAd
GADUnifiedNativeAdAssetIdentifiers	GADNativeAdAssetIdentifiers
GADUnifiedNativeAdDelegate	GADNativeAdDelegate
GADUnifiedNativeAdUnconfirmedClickDelegate	GADNativeAdUnconfirmedClickDelegate
GADNativeCustomTemplateAd	GADCustomNativeAd
GADNativeCustomTemplateAdLoaderDelegate	GADCustomNativeAdLoaderDelegate
GADNativeAdDelegate	GADCustomNativeAdDelegate
GADInAppPurchase	تمت الإزالة
GADInterstitial	GADInterstitialAd
GADNativeExpressAdView	تمت الإزالة
GADRewardBasedVideoAd	تمت الإزالة
GADInstreamAd	تمت الإزالة
GADInstreamAdView	تمت الإزالة

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

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

وتمت إزالة الطرق والخصائص المتوقّفة نهائيًا في السابق.
تمت إزالة طرق تفويض -willLeaveApplication: من جميع التنسيقات.
تم نقل اسم فئة شبكة الإعلانات إلى الموقع GADResponseInfo.
تم نقل معرّف الجهاز الاختباري إلى GADRequestConfiguration. الموقع.

الإصدار 7.68.0 من فئة	الإصدار 7.68.0 من واجهة برمجة التطبيقات	الإصدار 8.0.0 من واجهة برمجة التطبيقات	ملاحظات
GADMobileAds	+configureWithApplicationID:	-startWithCompletionHandler:	تم ضبط رقم تعريف التطبيق الآن في Info.plist.
	+disableAutomatedInAppPurchaseReporting	-disableAutomatedInAppPurchaseReporting
	+disableSDKCrashReporting	-disableSDKCrashReporting
GADRequest	testDevices	GADRequestConfiguration.testdeviceidentifiers	تنطبق خاصية testDeviceIdentifiers على جميع طلبات الإعلانات، بينما تنطبق خاصية testDeviceIdentifiers على جميع طلبات الإعلانات. تم إعداد السمة testDevices القديمة لكل طلب.
	الجنس	تمت الإزالة
	عيد الميلاد	تمت الإزالة
	+sdkVersion	GADMobileAds.sharedInstance.sdkVersion
	-setBirthdayWithMonth:day:year:	تمت الإزالة
	-setLocationWithDescription:	-setLocationWithLatitude:longitude:accuracy:
	-tagForChildDirectionTreatment:	[GADMobileAds.sharedInstance.requestConfiguration tagForChildDirectionTreatment]
GADErrorCode	kGADError*	خطأ GADError*	يتم إسقاط البادئة `k` من جميع ثوابت رموز الخطأ.
GADBannerView	hasAutoRefreshed	autoloadEnabled
	inAppPurchaseDelegate	تمت الإزالة
	mediatedAdView	تمت الإزالة
	adNetworkClassName	responseInfo.adNetworkClassName
DFPBannerView	-setValidAdSizesWithSizes:	-setValidAdSizes:
DFPBannerViewOptions	-adSizeDelegate	تمت الإزالة
GADBannerViewDelegate	-adViewDidReceiveAd:	-bannerViewDidReceiveAd:
	-adView:didFailToReceiveAdWithError:	-bannerView:didFailToReceiveAdWithError:
	-adViewWillPresentScreen:	-bannerViewWillPresentScreen:
	-adViewWillDismissScreen:	-bannerViewWillDismissScreen:
	-adViewDidDismissScreen:	-bannerViewDidDismissScreen:
	-adViewWillLeaveApplication:	تمت الإزالة
GADNativeCustomTemplateAd	templateID	GADCustomNativeAd.formatID
GADNativeCustomTemplateAd	-performClickOnAssetWithKey:customClickHandler:	-performClickOnAssetWithKey:
GADNativeAdImageAdLoaderOptions	preferredImageOrientation	GADNativeAdMediaAdOptions.mediaAspectRatio
GADInterstitial	inAppPurchaseDelegate	تمت الإزالة
	isReady	تمت الإزالة	استخدِم canPresentFromRootViewController:error: بدلاً من ذلك.
	hasBeenUsed	تمت الإزالة
	-init	-initWithAdUnitID:
	-setAdUnitID:	-initWithAdUnitID:
	adNetworkClassName	responseInfo.adNetworkClassName
	-interstitialWillLeaveApplication:	تمت الإزالة
شركة GADUnifiedNativeAd	videoController	mediaContent.videoController
شركة GADUnifiedNativeAd	adNetworkClassName	responseInfo.adNetworkClassName