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

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

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

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

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

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

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

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

الاتصال بالرقم 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, '/21775744923/example/native')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

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

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

الاتصال بالرقم NativeAdOptions.Builder.setReturnUrlsForImageAssets() بقيمة boolean.

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

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

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

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

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

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

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

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

الاتصال بالرقم NativeAdOptions.Builder.setRequestMultipleImages() بقيمة boolean.

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

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

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

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

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

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

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

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

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

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

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

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

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

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

الاتصال بالرقم NativeAdView.setAdChoicesView() مع AdChoicesView

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

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

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

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

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

الاتصال بالرقم VideoOptions.Builder.setStartMuted() بقيمة boolean.

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

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

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

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

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(adOptions).build();

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

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

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

اتصل بـ VideoOptions.Builder.setCustomControlsRequested() مع قيمة boolean.

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

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

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

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

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(adOptions).build();

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

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

Java

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

Kotlin

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, '/21775744923/example/native')
    .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();

الوساطة

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