الأنماط الأصلية

تتيح إعدادات أنماط الإعلانات المدمجة مع المحتوى لمدير إعلانات Google معالجة عرض إعلاناتك المدمجة مع المحتوى بناءً على الأنماط المدمجة مع المحتوى التي تحدّدها داخل المنتج. أولاً، تحديد الحجم والاستهداف. بعد ذلك، أضف HTML وCSS وJavaScript لتحديد الإعلانات المتجاوبة وتقديم عرض بجودة عالية على جميع الشاشات. لن تحتاج إلى تنفيذ أيٍّ من العرض، إذ يطبِّق "مدير الإعلانات" تلقائيًا نمط الإعلانات المدمجة مع المحتوى المناسب للوجهة. يتم تنفيذ أنماط الإعلانات المدمجة مع المحتوى تمامًا مثل إعلانات البانر باستخدام AdManagerAdView. ويمكن استخدامها مع حجم إعلان ثابت يُحدَّد مسبقًا، أو مع حجم إعلان ثابت يتم تحديده في وقت التشغيل.

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

• الإصدار 0.13.6 من المكوّن الإضافي Flutter لإعلانات Google على الأجهزة الجوّالة أو الإصدارات الأحدث

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

حجم ثابت

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

1. أنشئ عنصرًا في واجهة مستخدم "مدير الإعلانات" واختَر أحد الأحجام المحدّدة مسبقًا من القائمة المنسدلة للحقل Size.

2. حمِّل AdManagerBannerAd بالحجم نفسه الذي أعددته في الخطوة 1. اطّلع على وثائق إعلان البانر لمعرفة كيفية إنشاء مثيل لأحد الإعلانات وتحميله. يمكنك الاطّلاع على قائمة بالأحجام وثوابت AdSize المقابلة لها في القسم حجم إعلان البانر.

في ما يلي مثال على كيفية تحديد حجم ثابت، مثل حجم الإعلان MEDIUM_RECTANGLE (300×250):

AdManagerBannerAd ad = AdManagerBannerAd(
  adUnitId: '<your-ad-unit>',
  sizes: <AdSize>[AdSize.mediumRectangle],
  request: AdManagerAdRequest(),
);

الحجم المرن

في بعض الحالات، قد لا يكون الحجم الثابت منطقيًا. على سبيل المثال، قد تريد أن يتطابق عرض الإعلان مع محتوى تطبيقك، ولكنك تحتاج إلى ضبط ارتفاعه ديناميكيًا ليلائم محتوى الإعلان. للتعامل مع هذه الحالة، يمكنك تحديد Fluid كحجم الإعلان في واجهة مستخدم "مدير الإعلانات"، والذي يحدد أن حجم الإعلان يتحدد في وقت التشغيل في التطبيق. توفّر حزمة تطوير البرامج (SDK) قيمة ثابتة AdSize خاصة، وهي FLUID، للتعامل مع هذه الحالة. يتم تحديد ارتفاع حجم الإعلان المرن ديناميكيًا على أساس العرض الذي يحدده الناشر، ما يسمح لعرض إعلان النظام الأساسي بضبط ارتفاعه ليلائم ارتفاع تصميم الإعلان.

طلب تدفق

استخدام FluidAdManagerBannerAd لطلب إعلان مرن:

final fluidAd = FluidAdManagerBannerAd(
  adUnitId: '<your-ad-unit>',
  request: AdManagerAdRequest(),
  listener: AdManagerBannerAdListener(
    onAdLoaded: (Ad ad) {
      print('$_fluidAd loaded.');
    },
    onAdFailedToLoad: (Ad ad, LoadAdError error) {
      print('$_fluidAd failedToLoad: $error');
      ad.dispose();
    },
  ),

عرض الإعلان المرن

بعد تحميل إعلانك، استخدِم FluidAdWidget لعرض إعلانات سلسة. وسيضبط ارتفاعه ليلائم عرض إعلان النظام الأساسي الأساسي:

FluidAdWidget(
  width: <your-width>,
  ad: fluidAd,
);

اطّلِع على مثال لتنفيذ حجم الإعلان المرن في "مدير الإعلانات" في نموذج التطبيق على GitHub.