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

اختيار النظام الأساسي: Android iOS Flutter

تنزيل "النماذج الأصلية"

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

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

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

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

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

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

نموذج صغير

@layout/gnt_small_template_view

يُعدّ النموذج الصغير مثاليًا لعناصر Recycler 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 لضبط لون الخلفية الرئيسي، ولكن تتوفّر أيضًا مجموعة متنوعة من الخيارات الأخرى. في ما يلي جميع طرق الإنشاء المتاحة. تعرض أداة الإنشاء 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 لإضافة نماذج أو ميزات جديدة. يُرجى إرسال طلب سحب إلينا وسنراجع المحتوى.