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

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

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

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

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

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

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

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

الاتصال بالرقم 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

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

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

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

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

الوساطة

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