نماذج مدمجة مع المحتوى

تنزيل النماذج المضمّنة

ملاحظة مهمة: قبل المتابعة، تعرَّف على كيفية تحميل إعلان مضمّن. اطّلِع على مزيد من المعلومات عن الإعلانات المدمجة مع المحتوى في دليل الإعلانات المدمجة مع المحتوى.

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

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

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

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

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

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

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

نموذج صغير

@layout/gnt_small_template_view

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

نموذج متوسط

@layout/gnt_medium_template_view

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

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

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

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

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

2. اختَر مجلد nativetemplates.

   

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

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

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

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

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

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

   <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>
   

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

   MobileAds.initialize(this);
   AdLoader adLoader = new AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110")
       .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 AdRequest.Builder().build());
   

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

هناك طريقتان لتنسيق النموذج: باستخدام تنسيق XML التقليدي للتخطيط و باستخدام عنصر NativeTemplateStyle.Builder. يوضّح نموذج الرمز أعلاه كيفية استخدام العنصر NativeTemplateStyle.Builder لضبط لون الخلفية الرئيسي، ولكن هناك مجموعة متنوعة من الخيارات الأخرى أيضًا. في ما يلي كل methods المتاحة لصانع التقارير. يعرِض أداة الإنشاء عنصر 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 الخاص بنا GitHub لإضافة نماذج أو ميزات جديدة. أرسِل إلينا طلبًا لإضافة الرمز البرمجي وسنطّلع عليه.