حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في وضع الصيانة للحصول على آخر التحديثات والميزات، عليك migrate وإعداد "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة".

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

تصميم الإعلانات المدمَجة مع المحتوى في واجهة مستخدم "مدير الإعلانات"

اختيار النظام الأساسي: Android iOS Flutter Android (الإصدار القديم)

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

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

أكمِل دليل البدء.

حجم مرن

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

إنشاء طلب عرض إعلان مرن

على عكس أشكال الإعلانات الأخرى، لا يتضمّن حجم الإعلان المرن عرضًا محدّدًا مسبقًا، لذا احرص على ضبط layout_width لـ AdManagerAdView بشكل صريح في ملف تنسيق XML:

<com.google.android.gms.ads.admanager.AdManagerAdView
   android:id="@+id/fluid_ad_container"
   android:layout_width="match_parent"
   android:layout_height="wrap_content"
   android:layout_gravity="center_horizontal"
   ads:adSize="FLUID"
   ads:adUnitId="YOUR_AD_UNIT_ID" />

في ما يلي شكل عملية التنفيذ لتقديم طلب عرض الإعلان:

جافا

// fluidAdContainer is a ViewGroup that will be used to display the fluid native ad.
AdManagerAdView adView = (AdManagerAdView) fluidAdContainer;
AdManagerAdRequest request = new AdManagerAdRequest.Builder().build();
adView.loadAd(request);NativeStylesSnippets.java

Kotlin

// fluidAdContainer is a ViewGroup that will be used to display the fluid native ad.
val adView = fluidAdContainer as AdManagerAdView
val request = AdManagerAdRequest.Builder().build()
adView.loadAd(request)NativeStylesSnippets.kt

حجم ثابت

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

لضبط حجم ثابت، اتّبِع الخطوات التالية:

اضبط حجم الإعلان على قيمة أصغر من حجم شاشة الجهاز أو مساوية له. لتحديد الحد الأقصى لحجم الشاشة، استخدِم الطريقة Resources.getDisplayMetrics. تستخدم أبعاد العنصر AdSize وحدات بكسل مستقلة الكثافة (dp). عند المقارنة، قم بتحويل حجم الشاشة من بكسل إلى dp. لمعرفة التفاصيل حول قيود الحجم، يُرجى الاطّلاع على مقالة تحديد المشاكل وحلّها في ما يتعلّق بمرّات الظهور غير المعروضة في "إدارة إعلانات Google".

أنشئ عنصرًا في واجهة مستخدم "إدارة الإعلانات" واختَر أحد الأحجام المحدّدة مسبقًا من القائمة المنسدلة للحقل Size.
في ملف تنسيق XML الخاص بتطبيقك، اضبط السمة ads:adSize على الثابت الذي يتطابق مع الحجم المحدّد مسبقًا الذي اخترته في الخطوة 1. يمكنك الاطّلاع على قائمة بالأحجام وثوابت AdSize المقابلة لها في قسم الحجم الثابت.

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

<com.google.android.gms.ads.admanager.AdManagerAdView
   android:id="@+id/ad_view_container"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"
   android:layout_gravity="center_horizontal"
   ads:adSize="MEDIUM_RECTANGLE"
   ads:adUnitId="YOUR_AD_UNIT_ID" />