ضبط الميزات المتقدّمة المضمّنة

اختيار النظام الأساسي: Android iOS Android (قديم)

تتضمّن "الإعلانات المدمجة مع المحتوى" العديد من الميزات المتقدّمة التي تتيح لك إجراء عمليات تخصيص إضافية وتقديم أفضل تجربة إعلانية ممكنة. يوضّح لك هذا الدليل كيفية استخدام الميزات المتقدّمة لـ "الإعلانات المدمجة مع المحتوى".

المتطلبات الأساسية

• دمج شكل الإعلان المدمج مع المحتوى

عناصر التحكّم في مواد العرض

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

عناصر التحكّم المفضّلة في نسبة العرض إلى الارتفاع للوسائط

تتيح لك عناصر التحكّم في نسبة العرض إلى الارتفاع للوسائط تحديد نسبة العرض إلى الارتفاع المفضّلة لمواد الإعلان الإبداعية.

ملاحظة مهمة: لا يضمن استخدام واجهة برمجة التطبيقات هذه أن تستوفي جميع مواد الإعلان الإبداعية الخيار المفضّل المحدّد.

اضبط GADNativeAdMediaAdLoaderOptions mediaAspectRatio باستخدام GADMediaAspectRatio.

• في حال عدم ضبط هذه السمة، يمكن أن يكون للإعلان الذي يتم عرضه أي نسبة عرض إلى ارتفاع للوسائط.

• عند ضبط هذه السمة، ستتمكّن من تحسين تجربة المستخدم من خلال تحديد النوع المفضّل لنسبة العرض إلى الارتفاع.

يوجّه المثال التالي حزمة تطوير البرامج (SDK) إلى تفضيل عرض صورة أو فيديو بنسبة عرض إلى ارتفاع معيّنة.

Swift

let nativeOptions = NativeAdMediaAdLoaderOptions()
nativeOptions.mediaAspectRatio = .any

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdMediaAdLoaderOptions *nativeOptions = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOptions.mediaAspectRatio = GADMediaAspectRatioAny;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

استبدِل nativeAdUnitID برقم تعريف وحدتك الإعلانية.

التحكّم في تنزيل الصور

يتيح لك عنصر التحكّم في تنزيل الصور تحديد ما إذا كانت حزمة تطوير البرامج (SDK) ستعرض مواد عرض الصور أو معرّفات الموارد المنتظمة (URI) فقط.

اضبط GADNativeAdImageAdLoaderOptions disableImageLoading على قيمة BOOL.

• تكون عناصر التحكّم في تنزيل الصور غير مفعّلة تلقائيًا.

• عند إيقاف هذا الخيار، يملأ Google Mobile Ads SDK كلاً من الصورة ومعرّف الموارد المنتظم (URI) نيابةً عنك.

• عند تفعيل هذه الميزة، تملأ حزمة تطوير البرامج (SDK) معرّف الموارد المنتظم (URI) فقط، ما يتيح لك تنزيل الصور الفعلية وفقًا لتقديرك.

يوجّه المثال التالي حزمة تطوير البرامج (SDK) إلى عرض معرّف الموارد المنتظم (URI) فقط.

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.isImageLoadingDisabled = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.disableImageLoading = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

عناصر التحكّم في حمولة الصور

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

• تكون عناصر التحكّم في حمولة الصور غير مفعَّلة تلقائيًا.

• عند إيقاف هذا الخيار، يطلب تطبيقك من حزمة تطوير البرامج (SDK) تقديم الصورة الأولى فقط لأي مواد عرض تحتوي على سلسلة.

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

يوجّه المثال التالي حزمة تطوير البرامج (SDK) لعرض مواد عرض صور متعددة.

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.shouldRequestMultipleImages = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.shouldRequestMultipleImages = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

مواضع "خيارات الإعلان"

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

عناصر التحكّم في موضع AdChoices

تتيح لك عناصر التحكّم في موضع AdChoices اختيار الزاوية التي تريد عرض رمز "خيارات الإعلان" فيها.

اضبط GADNativeAdViewAdOptions preferredAdChoicesPosition باستخدام قيمة GADAdChoicesPosition.

• في حال عدم ضبطه، يتم ضبط موضع رمز "خيارات الإعلان" على أعلى يسار الصفحة.

• في حال ضبط هذا الخيار، يتم وضع AdChoices في الموضع المخصّص حسب الطلب.

يوضّح المثال التالي كيفية ضبط موضع مخصّص لصورة AdChoices.

Swift

let nativeOptions = NativeAdViewAdOptions()
nativeOptions.preferredAdChoicesPosition = .topRightCorner

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopRightCorner;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

عرض مخصّص لـ AdChoices

تحذير: الوصول إلى هذه الميزة محدود. لطلب الوصول، يُرجى التواصل مع مدير حسابك.

تتيح لك ميزة العرض المخصّص لـ "خيارات الإعلان" وضع رمز "خيارات الإعلان" في موقع مخصّص. يختلف ذلك عن عناصر التحكّم في موضع AdChoices التي تسمح فقط بتحديد إحدى الزوايا الأربع.

اضبط السمة GADNativeAd.adChoicesView باستخدام GADAdChoicesView قبل العرض، وسيتم عرض محتوى "خيارات الإعلان" داخل GADAdChoicesView.

يوضّح المثال التالي كيفية ضبط عرض مخصّص لـ AdChoices. يتم عرض رمز "خيارات الإعلان" داخل GADAdChoicesView:

Swift

private func createAdChoicesView(nativeAdView: NativeAdView) {
  // Define a custom position for the AdChoices icon.
  let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
  let customAdChoicesView = AdChoicesView(frame: customRect)
  nativeAdView.addSubview(customAdChoicesView)
  nativeAdView.adChoicesView = customAdChoicesView
}
NativeAdOptionsSnippets.swift

Objective-C

- (void)createAdChoicesViewWithNativeAdView:(GADNativeAdView *)nativeAdView {
  // Define a custom position for the AdChoices icon.
  CGRect customRect = CGRectMake(100, 100, 15, 15);
  GADAdChoicesView *customAdChoicesView = [[GADAdChoicesView alloc] initWithFrame:customRect];
  [nativeAdView addSubview:customAdChoicesView];
  nativeAdView.adChoicesView = customAdChoicesView;
}
NativeAdOptionsSnippets.m

عناصر التحكُّم في الفيديو

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

بدء سلوك كتم الصوت

يتيح لك سلوك "بدء التشغيل مع كتم الصوت" إيقاف الصوت الأولي للفيديو أو تفعيله.

اضبط GADVideoOptions startMuted على قيمة BOOL.

• يتم تفعيل سلوك "بدء الاجتماع بكتم الصوت" تلقائيًا.

• عند إيقاف هذا الخيار، يطلب تطبيقك بدء الفيديو بالصوت.

• عند تفعيل هذا الخيار، يطلب تطبيقك أن يبدأ الفيديو بدون صوت.

يوضّح المثال التالي كيفية بدء الفيديو مع تفعيل الصوت.

Swift

let videoOptions = VideoOptions()
videoOptions.shouldStartMuted = false

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.startMuted = NO;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];
NativeAdOptionsSnippets.m

عناصر التحكّم المخصّصة في التشغيل

تحذير: الوصول إلى هذه الميزة محدود. لطلب الوصول، يُرجى التواصل مع مدير حسابك.

يتيح لك ذلك طلب عناصر تحكّم مخصّصة في إدخال الفيديو لتشغيل الفيديو أو إيقافه مؤقتًا أو كتم صوته.

اضبط GADVideoOptions customControlsRequested على قيمة BOOL.

• تكون عناصر التحكّم المخصّصة في التشغيل غير مفعّلة تلقائيًا.

• وعند إيقافها، سيعرض الفيديو عناصر التحكّم في الإدخال التي تعرضها حزمة تطوير البرامج (SDK).

• عند تفعيل هذه الميزة، يمكنك استخدام GADVideoController play وGADVideoController pause وGADVideoController setMute للتحكّم في إعلان الفيديو.

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

GADVideoController.

يوضّح المثال التالي كيفية طلب فيديو يتضمّن عناصر تحكّم مخصّصة في التشغيل.

Swift

let videoOptions = VideoOptions()
videoOptions.areCustomControlsRequested = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.customControlsRequested = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];
NativeAdOptionsSnippets.m

التحقّق من تفعيل عناصر التحكّم المخصّصة

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

Swift

private func checkCustomControlsEnabled(nativeAd: NativeAd) -> Bool {
  let videoController = nativeAd.mediaContent.videoController
  return videoController.areCustomControlsEnabled
}
NativeAdOptionsSnippets.swift

Objective-C

- (BOOL)checkCustomControlsEnabledWithNativeAd:(GADNativeAd *)nativeAd {
  GADVideoController *videoController = nativeAd.mediaContent.videoController;
  return videoController.customControlsEnabled;
}
NativeAdOptionsSnippets.m

عرض عناصر تحكّم مخصّصة في الفيديو

يمكنك عرض عناصر تحكّم مخصّصة في الفيديو باتّباع أفضل الممارسات التالية:

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

ملاحظة: للحصول على معلومات عن مقدّمي خدمات القياس والتحقّق الذين التزموا بتطوير معيار إمكانية العرض للقياس المفتوح، يُرجى الاطّلاع على مجموعة عمل القياس المفتوح.

إيماءات النقر المخصّصة

تحذير: الوصول إلى هذه الميزة محدود. لطلب الوصول، يُرجى التواصل مع مدير حسابك.

"إيماءات النقر المخصّصة" هي ميزة في "الإعلانات المدمجة مع المحتوى" تتيح لك تسجيل النقرات على الإعلانات من خلال التمرير السريع على مشاهدات الإعلانات. وتعمل مع التطبيقات التي تستخدم إيماءات التمرير السريع للتنقّل في المحتوى. يوضّح لك هذا الدليل كيفية تفعيل إيماءات النقر المخصّصة في "الإعلانات المدمجة مع المحتوى".

ابدأ بإنشاء مثيل GADNativeAdCustomClickGestureOptions باستخدام اتجاه التمرير السريع الذي اخترته. عليك أيضًا تحديد ما إذا كنت تريد السماح بالنقرات كعمليات نقر.

• تكون إيماءات النقر المخصّصة غير مفعّلة تلقائيًا.

• وعند إيقافها، يتم احتساب النقرات فقط.

• عند تفعيل هذا الخيار، يتم احتساب إيماءات التمرير السريع كنقرات، ويمكنك تحديد ما إذا كان سيتم احتساب النقرات كنقرات أم لا.

يوضّح المثال التالي كيفية تنفيذ إيماءة تمرير مخصّصة إلى اليمين مع الحفاظ على سلوك النقر العادي.

Swift

let swipeGestureOptions = NativeAdCustomClickGestureOptions(
  swipeGestureDirection: .right,
  tapsAllowed: true)

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [swipeGestureOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdCustomClickGestureOptions *swipeGestureOptions =
    [[GADNativeAdCustomClickGestureOptions alloc]
        initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
                          tapsAllowed:YES];

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ swipeGestureOptions ]];
NativeAdOptionsSnippets.m

تحذير: إذا لم تكن إيماءات النقر المخصّصة مفعَّلة في حسابك، ستؤدي طلبات الإعلانات إلى عدم تعبئة المساحة الإعلانية.

الاستماع إلى أحداث إيماءات التمرير السريع

عند تسجيل نقرة بإيماءة تمرير سريع، تستدعي Google Mobile Ads SDK طريقة التفويض nativeAdDidRecordSwipeGestureClick: في GADNativeAdDelegate ، بالإضافة إلى طريقة التفويض الحالية nativeAdDidRecordClick:.

Swift

// Called when a swipe gesture click is recorded, as configured in
// NativeAdCustomClickGestureOptions.
func nativeAdDidRecordSwipeGestureClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click has occurred.")
}

// Called when a swipe gesture click or a tap click is recorded.
func nativeAdDidRecordClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click or tap click has occurred.")
}
NativeAdOptionsSnippets.swift

Objective-C

// Called when a swipe gesture click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click has occurred.");
}

// Called when a swipe gesture click or a tap click is recorded.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click or tap click has occurred.");
}
NativeAdOptionsSnippets.m

الوساطة

لا تعمل إيماءات النقر المخصّصة إلا على "الإعلانات المدمجة مع المحتوى" التي تعرضها "SDK لإعلانات Google على الأجهزة الجوّالة". مصادر الإعلانات التي تتطلّب حزم تطوير برامج (SDK) تابعة لجهات خارجية من أجل العرض لا تستجيب لإعداد اتجاهات النقر المخصّصة.