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

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

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

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

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

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

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

اتصل بـ NativeAdOptions.Builder.setMediaAspectRatio() بقيمة NativeAdOptions.MediaAspectRatio .

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

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

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

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                              .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
                              .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

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

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

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

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

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

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

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                                                     .setReturnUrlsForImageAssets(true)
                                                     .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .forNativeAd(nativeAd -> {
                                List<Uri> imageUris = new ArrayList<>();
                                for (Image image : nativeAd.getImages()) {
                                  imageUris.add(image.getUri());
                                }
                              })
                              .build();

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

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

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

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

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

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

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                                                     .setRequestMultipleImages(true)
                                                     .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

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

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

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

الاتصال بالرقم NativeAdOptions.Builder.setAdChoicesPlacement() مع NativeAdOption.AdChoicesPlacement

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

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

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

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                                                     .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
                                                     .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

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

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

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

public void onNativeAdLoaded(NativeAd ad) {
    NativeAdView nativeAdView = new NativeAdView(getApplicationContext());
    AdChoicesView adChoicesView = new AdChoicesView(this);
    nativeAdView.setAdChoicesView(adChoicesView);
}

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

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

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

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

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

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

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

VideoOptions videoOptions = new VideoOptions.Builder()
                                            .setStartMuted(false)
                                            .build();

NativeAdOptions adOptions = new NativeAdOptions.Builder()
                                               .setVideoOptions(videoOptions)
                                               .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(adOptions).build();

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

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

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

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

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

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

VideoOptions videoOptions = new VideoOptions.Builder()
                                            .setCustomControlsRequested(true)
                                            .build();

NativeAdOptions adOptions = new NativeAdOptions.Builder()
                                               .setVideoOptions(videoOptions)
                                               .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(adOptions).build();

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

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

@Override
public void onNativeAdLoaded(NativeAd nativeAd) {
  MediaContent mediaContent = nativeAd.getMediaContent();
  if (mediaContent != null) {
    VideoController videoController = mediaContent.getVideoController();
    boolean canShowCustomControls = videoController.isCustomControlsEnabled();
  }
}

NativeAd.OnNativeAdLoadedListener { ad ->
  val mediaContent = ad.mediaContent
  if (mediaContent != null) {
    val videoController = mediaContent.videoController
    val canShowCustomControls = videoController.isCustomControlsEnabled
  }
}

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

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

الاتصال بالرقم NativeAdOptions.Builder.enableCustomClickGestureDirection() مع NativeAdOptions.SwipeGestureDirection وboolean للإشارة إلى ما إذا كنت تريد أن يُسمح بالنقرات كنقرات.

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

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

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

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

NativeAdOptions adOptions = new NativeAdOptions
    .Builder()
    .enableCustomClickGestureDirection(NativeAdOptions.SWIPE_GESTURE_DIRECTION_RIGHT,
            /* tapsAllowed= */ true)
    .build();

// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
AdLoader.Builder builder = new AdLoader
    .Builder(this, 'ca-app-pub-3940256099942544/2247696110')
    .withNativeAdOptions(adOptions);

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

عند تسجيل نقرة على إيماءة التمرير السريع، تستدعي "حزمة SDK لإعلانات Google على الأجهزة الجوّالة" onAdSwipeGestureClicked() على AdListener، بالإضافة إلى onAdClicked() الحالية.

AdLoader adLoader = builder
    .withAdListener(
      new AdListener() {
        // Called when a swipe gesture click is recorded.
        @Override
        public void onAdSwipeGestureClicked() {
          Log.d(TAG, "A swipe gesture click has occurred.")
        }

        // Called when a swipe gesture click or a tap click is recorded, as
        // configured in NativeAdOptions.
        @Override
        public void onAdClicked() {
          Log.d(TAG, "A swipe gesture click or a tap click has occurred.")
        }
      })
    .build();

الوساطة

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