تتناول هذه الصفحة عمليات نقل البيانات للإصدارات الحالية والسابقة.
نقل البيانات من الإصدار 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 |
|
|
نقل البيانات من الإصدار 9 إلى الإصدار 10
Ads stop serving on iOS 11
Google Mobile Ads SDK version 10.0.0 serves ads only on devices running iOS 12 and higher.
Upgrading to Google Mobile Ads SDK version 10.0.0 will not break your app on iOS 11 and iOS 10 devices, however, no ads will be served on those devices.
Requirement of Ad Manager App ID
The Ad Manager App ID is now required in Info.plist
for all Ad Manager apps and
requires the ca-app-pub-################~##########
format. See Update your Info.plist
for more details.
Requirement of GoogleAppMeasurement.xcframework
GoogleAppMeasurement.xcframework is now required for all Ad Manager apps. If you install the Google Mobile Ads SDK through Cocoapods or Swift Package Manager, no additional action is required. If you install frameworks manually, see Manual Download for more details.
Building with bitcode is no longer supported
Disabling bitcode in your mobile apps is now required to integrate the Google Mobile Ads SDK.
Types removed
Type | Notes |
---|---|
GADGender | No replacement. |
GADMRewardBasedVideoAdNetworkAdapterProtocol | All rewarded mediation adapters listed on Choose Networks have stopped using these protocols for over a year. Use GADMediationAdapter for mediation and custom events. |
GADMRewardBasedVideoAdNetworkConnectorProtocol |
Properties removed
The following properties are removed with no replacement.
v10.0.0 Class | Property |
---|---|
GADMediationAdRequest | userBirthday |
userGender | |
userHasLocation | |
userLatitude | |
userLongitude | |
userLocationAccuracyInMeters | |
userLocationDescription | |
GADCustomEventRequest | userHasLocation |
userLatitude | |
userLongitude | |
userLocationAccuracyInMeters | |
userLocationDescription |
نقل البيانات من الإصدار 8 إلى الإصدار 9
Ads stop serving on iOS 10
The minimum iOS version the Google Mobile Ads SDK version 9.0.0 supports is iOS 11.
Upgrading to Google Mobile Ads SDK version 9.0.0 will not break your app on iOS 10 devices, however, no ads will be served on those devices.
Stricter enforcement of status bar controls
Starting from version 9.0.0, when you present full-screen format ads, your app should ensure that the ads are able to control the presentation of the status bar. You will see an error message in the logs if you fail to do so.
Depending on the specific layout of view controllers in your app, you might not
need to make any changes to ensure this. Consider whether you need to set the
childViewControllerForStatusBarHidden
property on your ad's rootViewController
.
Rename adDidPresentFullScreenContent: to adWillPresentFullScreenContent:
There is no behavior change. The delegate method is invoked right before the ad is about to be presented, so the new method name better reflects its functionality.
Remove location setting API on GADRequest
- (void)setLocationWithLatitude:longitude:accuracy:
has been deleted from
GADRequest
since location data is not used by Google to target ads. Use
third-party APIs to provide the information to third-party ad networks if
required.
Custom event interfaces deprecation
Custom events enable publishers using Ad Manager Mediation to add waterfall mediation for an ad network that isn't one of the supported ad networks.
All the custom event protocols are deprecated. Instead, use the existing
GADMediationAdapter
and
GADMediationAdEventDelegate
protocols to achieve the same functionalities. This change improves clarity and
enables you to create custom events for rewarded ads and interscroller ads which
were not previously available.
APIs
The table below lists the corresponding mediation adapter APIs to custom events APIs that should be used starting from version 9.0.0.
v8 | v9 | |
---|---|---|
GADCustomEventBanner GADCustomEventInterstitial GADCustomEventNativeAd |
GADMediationAdapter | GADMediationBannerAd GADMediationInterstitialAd GADMediationInterscrollerAd GADMediationRewardedAd GADMediationNativeAd |
delegate
|
Delegate is returned by the load completion handler of each load function
of GADMediationAdapter class
|
|
-init |
-init |
|
-requestBannerAd:parameter: |
-loadBannerForAdConfiguration: |
|
-requestInterstitialAdWith |
-loadInterstitialFor |
|
-requestNativeAdWithParameter:
|
-loadNativeAdFor |
|
N/A | -loadInterscrollerAdFor |
|
N/A | -loadRewardedAdFor |
|
-presentFromRootViewController:
|
-presentFromViewController: |
|
-handlesUserClicks |
-handlesUserClicks |
|
-handlesUserImpressions |
-handlesUserImpressions |
Delegate methods
The table below lists the corresponding mediation ad event delegate methods to custom event delegate methods that should be used starting from version 9.0.0.
v8 | v9 | |
---|---|---|
GADCustomEventBannerDelegate GADCustomEventInterstitialDelegate GADCustomEventNativeAdDelegate |
GADMediationAdEventDelegate | GADMediationAd |
-customEventBanner:didReceiveAd: -customEventInterstitialDidReceiveAd:
|
Ad load status is included in the load completion handler of
each load function in the GADMediationAdapter class
|
|
-customEventBanner:didFailAd: -customEventInterstitial:didFailAd:
|
||
-customEventBannerWasClicked: -customEventInterstitialWasClicked:
|
-reportClick |
|
-customEventBannerWill -customEventInterstitialWill
|
-willPresentFullScreenView |
|
-customEventBannerWill -customEventInterstitialWill
|
-willDismissFullScreenView |
|
-customEventBannerDid -customEventInterstitialDid
|
-didDismissFullScreenView |
|
-customEventBannerWill -customEventInterstitialWill
|
-willBackgroundApplication |
|
viewControllerFor |
-[GADMediationBannerAd view] |
Other removed/replaced methods and constants
Changes to method, constant, or property | |
---|---|
kGAD- prefixed constants
|
Removed. Use GAD- prefixed constants.
|
GADAdNetworkResponseInfo
|
credentials were removed. Use adUnitMapping
instead.
|
GAMRequest
|
kGAMSimulatorID in GAMRequest is deprecated.
Use GADSimulatorID in GADRequestConfiguration
instead.
|
GADCustomNativeAd
|
mediaView in GADCustomNativeAd is deprecated.
Use mediaContent instead.
|
In-App Purchase APIs in GoogleMobileAds |
inAppPurchase APIs in GoogleMobileAds were
removed.
|
نقل البيانات من الإصدار 7 إلى الإصدار 8
يتضمّن الإصدار 8.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" بعض التغييرات الرئيسية، بالإضافة إلى بعض عمليات إعادة تسمية واجهات برمجة التطبيقات وإزالتها.
تحديثات واجهة برمجة التطبيقات لتنسيق ملء الشاشة
بدءًا من الإصدار 8.0.0، تتشارك الإعلانات البينية والإعلانات التي تضم مكافأة عامًا كاملاً نمط الإعلان على الشاشة لتحقيق مزيد من الاتساق. تحتوي واجهات برمجة التطبيقات الجديدة للإعلانات التي يتم عرضها بملء الشاشة على اثنين الاختلافات الرئيسية عن الإصدار 7 من واجهات برمجة التطبيقات للإعلانات بملء الشاشة:
طريقة الصف الثابتة
load
في ما يلي الطريقة السابقة لتحميل/عرض إعلان بملء الشاشة:
- أنشئ مثيل كائن إعلان واحتفظ بإشارة إليه.
- عيِّن مستخدمًا يشرف على التحميل ويعرض عمليات معاودة الاتصال.
- حمِّل إعلانًا.
- تحقَّق ممّا إذا تم تحميل الإعلان باستخدام
isReady
. - اعرض الإعلان.
في الإصدار 8، تغيرت النهج قليلاً. لم يعد تحميل طلبات معاودة الاتصال كجزء من الشخص المفوَّض. وبدلاً من ذلك، يتم تمريرها إلى طريقة
load
باعتبارها معالج الإكمال:- استدعاء طريقة تحميل ثابتة في فئة الإعلان وتوفير إكمال التحميل .
- في استدعاء إكمال التحميل، ارجع إلى الإعلان الذي تم تحميله والذي عاد.
- عيِّن مستخدمًا مفوّضًا لمعالجة طلبات معاودة الاتصال.
- اعرض الإعلان.
يوفر الأسلوب الجديد المزايا التالية:
- ولن يكون لديك أبدًا إشارة إلى إعلان لم يتم تحميله.
- لن تحتاج إلى الاحتفاظ بكائن الإعلان أثناء تحميله.
أحداث الإعلانات المنتظمة:
نوع الحدث واجهة برمجة التطبيقات الحالية الإصدار 8 من واجهة برمجة التطبيقات تحميل الأحداث GADInterstitialDelegate
أوGADRewardedAdDelegate
GAMInterstitialAdLoadCompletionHandler
أوGADRewardedAdLoadCompletionHandler
أحداث العروض التقديمية 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. |
+disableAutomatedInApp |
-disableAutomatedInApp |
||
+disableSDKCrashReporting | -disableSDKCrashReporting | ||
GADRequest | testDevices | GADRequestConfiguration |
تنطبق خاصية testDeviceIdentifiers على جميع طلبات الإعلانات، بينما تنطبق خاصية testDeviceIdentifiers على جميع طلبات الإعلانات. تم إعداد السمة testDevices القديمة لكل طلب. |
الجنس | تمت الإزالة | ||
عيد الميلاد | تمت الإزالة | ||
+sdkVersion | GADMobileAds.sharedInstance |
||
-setBirthday |
تمت الإزالة | ||
-setLocationWithDescription: | -setLocationWith |
||
-tagForChildDirectionTreatment: | [GADMobileAds.sharedInstance.requestConfiguration tagForChildDirectionTreatment] | ||
GADErrorCode | kGADError* | خطأ GADError* | يتم إسقاط البادئة k من جميع ثوابت رموز الخطأ.
|
GADBannerView | hasAutoRefreshed | autoloadEnabled | |
inAppPurchaseDelegate | تمت الإزالة | ||
mediatedAdView | تمت الإزالة | ||
adNetworkClassName | responseInfo |
||
DFPBannerView | -setValidAdSizesWithSizes: | -setValidAdSizes: | |
DFPBannerViewOptions | -adSizeDelegate | تمت الإزالة | |
GADBannerViewDelegate | -adViewDidReceiveAd: | -bannerViewDidReceiveAd: | |
-adView:didFailToReceive |
-bannerView:didFailToReceive |
||
-adViewWillPresentScreen: | -bannerViewWillPresentScreen: | ||
-adViewWillDismissScreen: | -bannerViewWillDismissScreen: | ||
-adViewDidDismissScreen: | -bannerViewDidDismissScreen: | ||
-adViewWillLeaveApplication: | تمت الإزالة | ||
GADNativeCustomTemplateAd | templateID | GADCustomNativeAd.formatID | |
-performClickOnAssetWithKey: |
-performClickOnAssetWithKey: | ||
GADNativeAdImageAd |
preferredImageOrientation | GADNativeAdMediaAdOptions |
|
GADInterstitial | inAppPurchaseDelegate | تمت الإزالة | |
isReady | تمت الإزالة | استخدِم canPresentFrom |
|
hasBeenUsed | تمت الإزالة | ||
-init | -initWithAdUnitID: | ||
-setAdUnitID: | -initWithAdUnitID: | ||
adNetworkClassName | responseInfo |
||
-interstitialWill |
تمت الإزالة | ||
شركة GADUnifiedNativeAd | videoController | mediaContent.videoController | |
adNetworkClassName | responseInfo |