عرض شكل إعلان مدمج مع المحتوى يحدّده النظام
عند تحميل إعلان مدمج مع المحتوى، سيتلقّى تطبيقك عنصر إعلان مدمج مع المحتوى من خلال إحدى رسائل بروتوكول
GADAdLoaderDelegate
. بعد ذلك، يتحمّل تطبيقك مسؤولية
عرض الإعلان (على الرغم من أنّه ليس بالضرورة أن يتم ذلك على الفور).
لتسهيل عرض أشكال الإعلانات التي يحددها النظام، توفر حزمة تطوير البرامج (SDK) بعض
الموارد.
GADNativeAdView
بالنسبة إلى GADNativeAd
، هناك "مشاهدة إعلان" مقابلة
الفئة:
GADNativeAdView
فئة مشاهدة الإعلان هذه هي UIView
يجب أن يستخدمها الناشرون لعرض الإعلان.
على سبيل المثال، يمكن أن يعرض نوع GADNativeAdView
الواحد مثيلاً واحدًا من
GADNativeAd
. كل عنصر من عناصر UIView
المستخدمة لعرض الإعلان
يجب أن تكون مواد العرض عروض فرعية لكائن GADNativeAdView
هذا.
على سبيل المثال، إذا كنت تعرض إعلانًا في UITableView
، قد يبدو التسلسل الهرمي
للعرض لأحد الخلايا على النحو التالي:
توفّر فئة GADNativeAdView
أيضًا IBOutlets
المستخدَم لتسجيل
طريقة العرض المستخدَمة لكل مادة عرض فردية، وطريقة لتسجيل
GADNativeAd
العنصر نفسه. إنّ تسجيل المشاهدات بهذه الطريقة يسمح لحزمة SDK
للتعامل مع المهام مثل:
- يتم تسجيل النقرات.
- تسجيل مرّات الظهور (عندما يكون أول بكسل مرئيًا على الشاشة)
- يتم عرض تراكب "خيارات الإعلان".
تراكب "خيارات الإعلان"
بالنسبة إلى الإعلانات المباشرة غير القابلة للتخطّي (التي يتم عرضها من خلال إضافة الإعلانات السابقة في AdMob أو من خلال Ad Exchange أو AdSense)، تُضيف حزمة تطوير البرامج (SDK) تراكبًا لميزة "خيارات الإعلان". ترك مساحة في المساحة المفضّلة الزاوية لعرض الإعلان المدمج مع المحتوى لشعار "خيارات الإعلان" الذي يتم إدراجه تلقائيًا. عليك أيضًا إجراء التأكد من وضع تراكب "خيارات الإعلان" على المحتوى الذي يسمح يسهل رؤيتها. لمزيد من المعلومات حول شكل التراكب ووظيفته، راجع إرشادات تنفيذ الإعلانات الآلية المدمجة مع المحتوى.
إحالة الإعلان
عند عرض إعلانات مدمجة مع المحتوى آليًا، يجب عرض مصدر إعلان لتحديد أنّ العرض هو إعلان.مثال على الرمز البرمجي
لنلقِ نظرة على كيفية عرض الإعلانات المدمجة باستخدام طرق العرض المحمَّلة ديناميكيًا
من ملفات xib. يمكن أن يكون هذا النهج مفيدًا جدًا عند استخدام GADAdLoaders
الذي تم ضبطه لطلب تنسيقات متعددة.
تخطيط UIViews
الخطوة الأولى هي وضع UIViews
الذي سيعرض مواد عرض الإعلانات المدمجة مع المحتوى.
يمكنك إجراء ذلك في أداة إنشاء الواجهة كما تفعل عند إنشاء أي واجهة
xib. في ما يلي شكل تنسيق إعلان مدمج
مع المحتوى:
لاحِظ قيمة Custom Class (الفئة المخصّصة) في أعلى يسار الصورة. تم ضبطه على
GADNativeAdView
هذه هي فئة مشاهدة الإعلان المستخدمة لعرض GADNativeAd
.
عليك أيضًا ضبط الفئة المخصّصة لعنصر GADMediaView
الذي يُستخدَم
لعرض الفيديو أو الصورة للإعلان.
ربط المتاجر بطرق العرض
بعد وضع طرق العرض وتحديد فئة عرض الإعلان الصحيحة
للتنسيق، اربط منافذ مواد عرض عرض الإعلان بالUIViews
الذي أنشأته.
في ما يلي كيفية ربط منافذ مواد العرض في مشاهدة الإعلان بحملة "UIViews
" التي تم إنشاؤها.
على إعلان:
في لوحة المنافذ، تم ربط المنافذ في GADNativeAdView
ب
UIViews
المعروض في "أداة إنشاء الواجهات". يتيح ذلك
لحزمة تطوير البرامج (SDK) معرفة UIView
التي تعرِض مادة العرض.
من المهم أيضًا تذكُّر أنّ هذه المنافذ تمثّل المشاهدات التي يمكن
النقر عليها في الإعلان.
عرض الإعلان
بعد اكتمال التصميم وربط المقابس، أضف الرمز التالي إلى تطبيقك الذي يعرض إعلانًا بعد تحميله:
Swift
// Mark: - GADNativeAdLoaderDelegate
func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
print("Received native ad: \(nativeAd)")
refreshAdButton.isEnabled = true
// Create and place ad in view hierarchy.
let nibView = Bundle.main.loadNibNamed("NativeAdView", owner: nil, options: nil)?.first
guard let nativeAdView = nibView as? GADNativeAdView else {
return
}
setAdView(nativeAdView)
// Set ourselves as the native ad delegate to be notified of native ad events.
nativeAd.delegate = self
// Populate the native ad view with the native ad assets.
// The headline and mediaContent are guaranteed to be present in every native ad.
(nativeAdView.headlineView as? UILabel)?.text = nativeAd.headline
nativeAdView.mediaView?.mediaContent = nativeAd.mediaContent
// This app uses a fixed width for the GADMediaView and changes its height to match the aspect
// ratio of the media it displays.
if let mediaView = nativeAdView.mediaView, nativeAd.mediaContent.aspectRatio > 0 {
let heightConstraint = NSLayoutConstraint(
item: mediaView,
attribute: .height,
relatedBy: .equal,
toItem: mediaView,
attribute: .width,
multiplier: CGFloat(1 / nativeAd.mediaContent.aspectRatio),
constant: 0)
heightConstraint.isActive = true
}
// These assets are not guaranteed to be present. Check that they are before
// showing or hiding them.
(nativeAdView.bodyView as? UILabel)?.text = nativeAd.body
nativeAdView.bodyView?.isHidden = nativeAd.body == nil
(nativeAdView.callToActionView as? UIButton)?.setTitle(nativeAd.callToAction, for: .normal)
nativeAdView.callToActionView?.isHidden = nativeAd.callToAction == nil
(nativeAdView.iconView as? UIImageView)?.image = nativeAd.icon?.image
nativeAdView.iconView?.isHidden = nativeAd.icon == nil
(nativeAdView.starRatingView as? UIImageView)?.image = imageOfStars(
fromStarRating: nativeAd.starRating)
nativeAdView.starRatingView?.isHidden = nativeAd.starRating == nil
(nativeAdView.storeView as? UILabel)?.text = nativeAd.store
nativeAdView.storeView?.isHidden = nativeAd.store == nil
(nativeAdView.priceView as? UILabel)?.text = nativeAd.price
nativeAdView.priceView?.isHidden = nativeAd.price == nil
(nativeAdView.advertiserView as? UILabel)?.text = nativeAd.advertiser
nativeAdView.advertiserView?.isHidden = nativeAd.advertiser == nil
// For the SDK to process touch events properly, user interaction should be disabled.
nativeAdView.callToActionView?.isUserInteractionEnabled = false
// Associate the native ad view with the native ad object. This is
// required to make the ad clickable.
// Note: this should always be done after populating the ad views.
nativeAdView.nativeAd = nativeAd
}
SwiftUI
إنشاء نموذج عرض
إنشاء نموذج عرض يحمِّل إعلانًا مدمجًا مع المحتوى وينشر بيانات الإعلان المدمج مع المحتوى التغييرات:
import GoogleMobileAds
class NativeAdViewModel: NSObject, ObservableObject, GADNativeAdLoaderDelegate {
@Published var nativeAd: GADNativeAd?
private var adLoader: GADAdLoader!
func refreshAd() {
adLoader = GADAdLoader(
adUnitID: "ca-app-pub-3940256099942544/3986624511",
// The UIViewController parameter is optional.
rootViewController: nil,
adTypes: [.native], options: nil)
adLoader.delegate = self
adLoader.load(GADRequest())
}
func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
// Native ad data changes are published to its subscribers.
self.nativeAd = nativeAd
nativeAd.delegate = self
}
func adLoader(_ adLoader: GADAdLoader, didFailToReceiveAdWithError error: Error) {
print("\(adLoader) failed with error: \(error.localizedDescription)")
}
}
أنشئ UIViewRepresentable.
إنشاء
UIViewRepresentable
بالنسبة إلى GADNativeView
، والاشتراك في تغييرات البيانات في ViewModel
الفئة:
private struct NativeAdView: UIViewRepresentable {
typealias UIViewType = GADNativeAdView
// Observer to update the UIView when the native ad value changes.
@ObservedObject var nativeViewModel: NativeAdViewModel
func makeUIView(context: Context) -> GADNativeAdView {
return
Bundle.main.loadNibNamed(
"NativeAdView",
owner: nil,
options: nil)?.first as! GADNativeAdView
}
func updateUIView(_ nativeAdView: GADNativeAdView, context: Context) {
guard let nativeAd = nativeViewModel.nativeAd else { return }
// Each UI property is configurable using your native ad.
(nativeAdView.headlineView as? UILabel)?.text = nativeAd.headline
nativeAdView.mediaView?.mediaContent = nativeAd.mediaContent
(nativeAdView.bodyView as? UILabel)?.text = nativeAd.body
(nativeAdView.iconView as? UIImageView)?.image = nativeAd.icon?.image
(nativeAdView.starRatingView as? UIImageView)?.image = imageOfStars(from: nativeAd.starRating)
(nativeAdView.storeView as? UILabel)?.text = nativeAd.store
(nativeAdView.priceView as? UILabel)?.text = nativeAd.price
(nativeAdView.advertiserView as? UILabel)?.text = nativeAd.advertiser
(nativeAdView.callToActionView as? UIButton)?.setTitle(nativeAd.callToAction, for: .normal)
// For the SDK to process touch events properly, user interaction should be disabled.
nativeAdView.callToActionView?.isUserInteractionEnabled = false
// Associate the native ad view with the native ad object. This is required to make the ad
// clickable.
// Note: this should always be done after populating the ad views.
nativeAdView.nativeAd = nativeAd
}
إضافة طريقة العرض إلى التدرج الهرمي لطريقة العرض
يوضّح الرمز البرمجي التالي إضافة UIViewRepresentable
إلى التسلسل الهرمي للعرض
:
struct NativeContentView: View {
// Single source of truth for the native ad data.
@StateObject private var nativeViewModel = NativeAdViewModel()
var body: some View {
ScrollView {
VStack(spacing: 20) {
NativeAdView(nativeViewModel: nativeViewModel) // Updates when the native ad data changes.
.frame(minHeight: 300) // minHeight determined from xib.
Objective-C
#pragma mark GADNativeAdLoaderDelegate implementation
- (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd {
NSLog(@"Received native ad: %@", nativeAd);
self.refreshButton.enabled = YES;
// Create and place ad in view hierarchy.
GADNativeAdView *nativeAdView =
[[NSBundle mainBundle] loadNibNamed:@"NativeAdView" owner:nil options:nil].firstObject;
[self setAdView:nativeAdView];
// Set the mediaContent on the GADMediaView to populate it with available
// video/image asset.
nativeAdView.mediaView.mediaContent = nativeAd.mediaContent;
// Populate the native ad view with the native ad assets.
// The headline is present in every native ad.
((UILabel *)nativeAdView.headlineView).text = nativeAd.headline;
// These assets are not guaranteed to be present. Check that they are before
// showing or hiding them.
((UILabel *)nativeAdView.bodyView).text = nativeAd.body;
nativeAdView.bodyView.hidden = nativeAd.body ? NO : YES;
[((UIButton *)nativeAdView.callToActionView)setTitle:nativeAd.callToAction
forState:UIControlStateNormal];
nativeAdView.callToActionView.hidden = nativeAd.callToAction ? NO : YES;
((UIImageView *)nativeAdView.iconView).image = nativeAd.icon.image;
nativeAdView.iconView.hidden = nativeAd.icon ? NO : YES;
((UIImageView *)nativeAdView.starRatingView).image = [self imageForStars:nativeAd.starRating];
nativeAdView.starRatingView.hidden = nativeAd.starRating ? NO : YES;
((UILabel *)nativeAdView.storeView).text = nativeAd.store;
nativeAdView.storeView.hidden = nativeAd.store ? NO : YES;
((UILabel *)nativeAdView.priceView).text = nativeAd.price;
nativeAdView.priceView.hidden = nativeAd.price ? NO : YES;
((UILabel *)nativeAdView.advertiserView).text = nativeAd.advertiser;
nativeAdView.advertiserView.hidden = nativeAd.advertiser ? NO : YES;
// In order for the SDK to process touch events properly, user interaction
// should be disabled.
nativeAdView.callToActionView.userInteractionEnabled = NO;
// Associate the native ad view with the native ad object. This is
// required to make the ad clickable.
nativeAdView.nativeAd = nativeAd;
}
مثال كامل على GitHub
عرض المثال الكامل لدمج الإعلانات المدمجة مع المحتوى في Swift وSwiftUI الهدف-ج باتباع رابط GitHub ذي الصلة.
مثال متقدّم على الإعلانات المدمجة مع المحتوى في Swift مثال على الإعلانات المدمجة مع المحتوى في SwiftUI مثال متقدّم على الإعلانات المدمجة مع المحتوى في Objective-CGADMediaView
تظهر مواد عرض الصور والفيديوهات للمستخدمين من خلال
GADMediaView
وهذا النوع من السمة UIView
يمكن تحديده في ملف xib أو إنشاؤه ديناميكيًا.
يجب وضعها ضمن العرض الهرمي لـ GADNativeAdView
، كما هو الحال مع
أي عرض آخر لمادة عرض.
كما هو الحال مع جميع طرق عرض مواد العرض، يجب أن يتمّ
ملء محتوى عرض الوسائط. يتم تعيين هذا باستخدام
mediaContent
في الموقع GADMediaView
. تحتوي سمة
mediaContent
الخاصة بعنصر
GADNativeAd
على محتوى وسائط يمكن تمريره إلى عنصر
GADMediaView
.
في ما يلي مقتطف من
مثال للإعلان المدمج مع المحتوى (المتقدم)
(Swift |
Objective-C)
الذي يوضّح كيفية تعبئة GADMediaView
بمواد عرض الإعلانات المدمجة مع المحتوى باستخدام
GADMediaContent
من GADNativeAd
:
Swift
nativeAdView.mediaView?.mediaContent = nativeAd.mediaContent
Objective-C
nativeAdView.mediaView.mediaContent = nativeAd.mediaContent;
تأكَّد من أنّك في ملف "أداة إنشاء الواجهات" لعرض الإعلان المدمج مع المحتوى قد أعددت
الفئة المخصّصة للمشاهدات على GADMediaView
وأنّك ربطتها بمخرج
mediaView
.
تغيير وضع محتوى الصورة
تلتزم الفئة GADMediaView
بالسمة UIView
.
contentMode
الخاص بها عند عرض الصور. إذا أردت تغيير طريقة تغيير حجم صورة في
GADMediaView
، اضبط القيمة المناسبة
UIViewContentMode
في سمة contentMode
في GADMediaView
لتحقيق ذلك.
على سبيل المثال، لملء GADMediaView
عند عرض صورة (لا يحتوي الإعلان على
فيديو):
Swift
nativeAdView.mediaView?.contentMode = .aspectFill
Objective-C
nativeAdView.mediaView.contentMode = UIViewContentModeAspectFill;
GADMediaContent
GADMediaContent
البيانات ذات الصلة بمحتوى الوسائط للإعلان المدمج مع المحتوى، وهو
يتم عرضه باستخدام الفئة GADMediaView
. عند ضبطها على السمة GADMediaView
mediaContent
:
في حال توفر مادة عرض الفيديو، يتم تخزينها مؤقتًا ويبدأ تشغيلها داخل
GADMediaView
يمكنك معرفة ما إذا كانت مادة عرض الفيديو متاحة من خلال التحقّق من الأمرhasVideoContent
إذا لم يكن الإعلان يحتوي على مادة عرض فيديو، سيتم تنزيل مادة العرض "
mainImage
". ويتم وضعها داخلGADMediaView
بدلاً من ذلك.
الخطوات التالية
مزيد من المعلومات عن خصوصية المستخدمين