خيارات الإعلانات المدمجة مع المحتوى

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

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

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

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

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

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

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

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

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

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

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

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

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

• عند إيقاف هذه الميزة، تملأ حزمة SDK لإعلانات Google على الأجهزة الجوّالة كلّ من الصورة وعنوان URL نيابةً عنك.

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

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

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

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

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

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

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

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

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

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

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

ضبط GADNativeAdViewAdOptions preferredAdChoicesPosition مع GADAdChoicesPosition

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

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

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

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

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

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

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

- (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd {

    ...

    
    GADAdChoicesView *customAdChoicesView =
        [[GADAdChoicesView alloc] initWithFrame: CGRectMake(..., ..., ..., ...)];

    [nativeAdView addSubview:customAdChoicesView];
    nativeAdView.adChoicesView = customAdChoicesView;

    // 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;
}

func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
    refreshAdButton.isEnabled = true

    ...
    // Define a custom position for the AdChoices icon.
    let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
    let customAdChoicesView = GADAdChoicesView(frame: customRect)
    nativeAdView.addSubview(customAdChoicesView)
    nativeAdView.adChoicesView = customAdChoicesView

    // 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;
}

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

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

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

• يكون سلوك بدء كتم الصوت مفعَّلاً تلقائيًا.

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

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

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

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

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

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

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

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

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

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/21775744923/example/native"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

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

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

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd*)nativeAd {

  GADVideoController *videoController = nativeAd.mediaContent.videoController;
  BOOL canShowCustomControls = videoController.customControlsEnabled;

}

func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
        let videoController = nativeAd.mediaContent.videoController
        let canShowCustomControls = videoController?.customControlsEnabled() == true
}

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

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

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

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

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

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

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

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

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

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

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

// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
self.adLoader = [[GADAdLoader alloc]
        initWithAdUnitID:@"/21775744923/example/native"
      rootViewController:self
                 adTypes:@[ GADAdLoaderAdTypeNative ]
                 options:@[ swipeGestureOptions ]];

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

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

#pragma mark - GADNativeAdDelegate implementation

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

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

الوساطة

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