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

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

اختيار النظام الأساسي: 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

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

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

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

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

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

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

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

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

طريقة عرض مخصّصة لـ "خيارات الإعلان"

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

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

يوضّح المثال التالي كيفية ضبط طريقة عرض مخصّصة لـ "خيارات الإعلان". يتم عرض رمز "خيارات الإعلان" داخل 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

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

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

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

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

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

ابدأ بتهيئة مثيل 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 على الأجهزة الجوّالة. لا تستجيب مصادر الإعلانات التي تتطلّب حزم تطوير برامج تابعة لجهات خارجية للعرض لإعدادات اتجاهات النقر المخصّصة.

ضبط الميزات المتقدّمة المضمّنة تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

Swift

Objective-C

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

Swift

Objective-C

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

Swift

Objective-C

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

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

Swift

Objective-C

طريقة عرض مخصّصة لـ "خيارات الإعلان"

Swift

Objective-C

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

سلوك بدء التشغيل مع كتم الصوت

Swift

Objective-C

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

Swift

Objective-C

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

Swift

Objective-C

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

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

Swift

Objective-C

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

Swift

Objective-C

الوساطة

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