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

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

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

• أدخِل شكل الإعلان المدمج مع المحتوى.

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

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

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

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

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

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

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

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

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

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

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

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

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

• عند تفعيل حزمة تطوير البرامج، تملأ حزمة SDK عنوان URL فقط، ما يتيح لك تنزيل الصور الفعلية وفقًا لتقديرك.

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

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

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

اضبط GADNativeAdImageAdLoaderOptions shouldRequestMultipleImages بالقيمة BOOL.

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

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

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

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

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

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

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

اضبط GADNativeAdViewAdOptions preferredAdChoicesPosition بقيمة GADAdChoicesPosition .

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

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

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

العرض المخصّص لخدمة "خيارات الإعلان"

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

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

اضبط السمة GADNativeAd.adChoicesView باستخدام GADAdChoicesView قبل العرض، وسيتم عرض محتوى AdChoices داخل 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:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

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

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

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

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

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

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

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

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

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           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
}

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

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

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:@"ca-app-pub-3940256099942544/3986624511"
      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.");
}

الوساطة

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