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

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

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

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

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

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

ضبط 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).

ضبط GADNativeAdImageAdLoaderOptions disableImageLoading بقيمة BOOL.
  • ويكون عنصر التحكّم في تنزيل الصور غير مفعَّل تلقائيًا.

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

  • عند تفعيل هذه الميزة، تعمل حزمة تطوير البرامج (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 ]];

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

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

ضبط GADNativeAdImageAdLoaderOptions shouldRequestMultipleImages بقيمة BOOL.
  • تكون عناصر التحكّم في حمولة الصور غير مفعَّلة تلقائيًا.

  • عند إيقاف هذا الإعداد، يوجّه تطبيقك إلى حزمة 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 ]];

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

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

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

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

Objective-C

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

Swift

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 startMuted بقيمة BOOL.
  • يكون سلوك بدء كتم الصوت مفعَّلاً تلقائيًا.

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

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

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

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

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

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

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

ضبط GADVideoOptions customControlsRequested بقيمة BOOL.
  • ويكون عنصر التحكّم المخصّص في التشغيل غير مفعَّل تلقائيًا.

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

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

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

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

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

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

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

Objective-C

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

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

}

Swift

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

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

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

إعداد 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) تابعة لجهات خارجية العرض، لا تستجيب لإعداد اتجاهات النقر المخصصة.