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

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

تنسيقات الإعلانات الأنيقة باستخدام النماذج الأصلية

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

تنزيل نماذج "الإعلانات المدمجة مع المحتوى"

باستخدام "الإعلانات المدمجة مع المحتوى"، يمكنك تخصيص إعلاناتك لتقديم تجربة مستخدم أفضل. يمكن أن تؤدي تجارب المستخدمين الأفضل إلى زيادة التفاعل وتحسين عائدك الإجمالي.

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

"النماذج المدمجة مع المحتوى" هي طرق عرض مكتملة الرموز لإعلاناتك المدمجة مع المحتوى، وهي مصمّمة لتنفيذها بسرعة وتعديلها بسهولة. باستخدام "نماذج الإعلانات المدمجة مع المحتوى"، يمكنك تنفيذ أول إعلان مدمج مع المحتوى في غضون دقائق معدودة، ويمكنك تخصيص المظهر والأسلوب بسرعة بدون الحاجة إلى الكثير من الرموز البرمجية. يمكنك وضع هذه النماذج في أي مكان تريده، مثل طريقة عرض Recycler المستخدمة في خلاصة الأخبار أو في مربّع حوار أو في أي مكان آخر في تطبيقك.

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

أحجام النماذج

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

نموذج صغير

@layout/gnt_small_template_view

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

نموذج متوسط

@layout/gnt_medium_template_view

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

يمكنك تجربة مواضع مختلفة. بالطبع، يمكنك أيضًا تغيير الرمز المصدر وملفات XML لتناسب متطلباتك.

تثبيت نماذج "الإعلانات المدمجة مع المحتوى"

لتثبيت النماذج المدمجة مع المحتوى، ما عليك سوى تنزيل ملف ZIP (باستخدام خيار استنساخ أو تنزيل على GitHub) واستيراد الوحدة إلى مشروعك الحالي في "استوديو Android".

اختَر ملف > جديد > استيراد وحدة.
اختَر المجلد nativetemplates.

أضِف السطر التالي إلى ملف build.gradle على مستوى التطبيق:

dependencies {
        ...
        implementation project(':nativetemplates')
        ...
}

استخدام نماذج "الإعلانات المدمجة مع المحتوى"

يمكنك استخدام النموذج في أي ملف XML للتنسيق، مثل أي مجموعة طرق عرض أخرى.

إضافة نموذج إلى التنسيق

يتألف استخدام النماذج من خطوتَين:

أولاً، عليك تضمين النموذج كجزء من التنسيق.

<LinearLayout
   xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:app="http://schemas.android.com/apk/res-auto"
   xmlns:tools="http://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   tools:context=".MainActivity"
   tools:showIn="@layout/activity_main" >

<!--  This is your template view -->
<com.google.android.ads.nativetemplates.TemplateView
   android:id="@+id/my_template"
   <!-- this attribute determines which template is used. The other option is
    @layout/gnt_medium_template_view -->
   app:gnt_template_type="@layout/gnt_small_template_view"
   android:layout_width="match_parent"
   android:layout_height="match_parent" />

...
</LinearLayout>

بعد ذلك، عليك تزويد النموذج بإعلانك المدمج مع المحتوى عند تحميله:

MobileAds.initialize(this);
AdLoader adLoader = new AdLoader.Builder(this, "/21775744923/example/native")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
        @Override
        public void onNativeAdLoaded(NativeAd nativeAd) {
            NativeTemplateStyle styles = new
              NativeTemplateStyle.Builder().withMainBackgroundColor(background).build();
            TemplateView template = findViewById(R.id.my_template);
            template.setStyles(styles);
            template.setNativeAd(nativeAd);
        }
     })
     .build();

adLoader.loadAd(new AdManagerAdRequest.Builder().build());

مفاتيح قاموس الأنماط

هناك طريقتان لتصميم النموذج: باستخدام تنسيق XML التقليدي واستخدام عنصر NativeTemplateStyle.Builder. يوضّح نموذج الرمز البرمجي أعلاه كيفية استخدام العنصر NativeTemplateStyle.Builder لضبط لون الخلفية الرئيسي، ولكن هناك مجموعة متنوعة من الخيارات الأخرى أيضًا. في ما يلي جميع طرق الإنشاء المتاحة. يعرض المنشئ عنصر NativeTemplateStyle يتجاوز أي نمط لتنسيق XML. يستخدم تنسيقا XML‏ gnt_small_template.xml وgnt_medium_template.xml مَعلمات الأنماط نفسها في Android التي تعرفها.

طرق الإنشاء لنمط النموذج المدمج مع المحتوى
`withCallToActionTextTypeface`	`Typeface callToActionTextTypeface` تمثّل هذه المَعلمة نوع الخط لعبارة الحث على اتخاذ إجراء.
`withCallToActionTextSize`	`float callToActionTextSize` حجم نص عبارة الحث على اتخاذ إجراء
`withCallToActionTypefaceColor`	`int callToActionTypefaceColor` لون نص عبارة الحث على اتخاذ إجراء
`withCallToActionBackgroundColor`	`ColorDrawable callToActionBackgroundColor` لون خلفية عبارة الحث على اتخاذ إجراء
`withPrimaryTextTypeface`	`Typeface primaryTextTypeface` تمثّل هذه السمة نوع الخط في السطر الأول من النص.
`withPrimaryTextSize`	`float primaryTextSize` حجم الصف الأول من النص
`withPrimaryTextTypefaceColor`	`int primaryTextTypefaceColor` لون الصف الأول من النص
`withPrimaryTextBackgroundColor`	`ColorDrawable primaryTextBackgroundColor` لون خلفية الصف الأول من النص
`withSecondaryTextTypeface`	`Typeface secondaryTextTypeface` الخط الطباعي للصف الثاني من النص
`withSecondaryTextSize`	`float secondaryTextSize` حجم السطر الثاني من النص
`withSecondaryTextTypefaceColor`	`int secondaryTextTypefaceColor` لون النص في الصف الثاني من النص
`withSecondaryTextBackgroundColor`	`ColorDrawable secondaryTextBackgroundColor` لون خلفية السطر الثاني من النص
`withTertiaryTextTypeface`	`Typeface tertiaryTextTypeface` الخط الطباعي للصف الثالث من النص
`withTertiaryTextSize`	`float tertiaryTextSize` حجم الصف الثالث من النص
`withTertiaryTextTypefaceColor`	`int tertiaryTextTypefaceColor` لون النص في الصف الثالث من النص
`withTertiaryTextBackgroundColor`	`ColorDrawable tertiaryTextBackgroundColor` لون خلفية الصف الثالث من النص
`withMainBackgroundColor`	`ColorDrawable mainBackgroundColor` لون الخلفية الرئيسي

المساهمة

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