چیدمان‌های آگهی را با الگوهای بومی سبک‌بندی کنید

پلاتفرم را انتخاب کنید: iOS Flutter Android (Legacy)

بارگیری الگوهای بومی

بااستفاده از آگهی‌های بومی می‌توانید آگهی‌هایتان را سفارشی‌سازی کنید که این کار منجر به تجربه کاربری بهتر می‌شود. تجربه کاربری بهتر می‌تواند تعامل را افزایش دهد و بازده کلی شما را بهبود بخشد.

برای اینکه بیشترین بهره را از آگهی‌های بومی ببرید، مهم است که چیدمان آگهی‌تان را به‌گونه‌ای طراحی کنید که مانند افزونه‌ای طبیعی از برنامه‌تان به‌نظر برسد. برای کمک به شما در شروع کار، «الگوهای بومی» را ایجاد کرده‌ایم.

«الگوهای بومی» نماهای کد کامل برای آگهی‌های بومی شما هستند که برای پیاده‌سازی سریع و اصلاح آسان طراحی شده‌اند. با «الگوهای بومی»، می‌توانید اولین آگهی بومی‌تان را فقط در چند دقیقه پیاده‌سازی کنید و می‌توانید به‌سرعت ظاهر و حس آن را بدون کدنویسی زیاد سفارشی‌سازی کنید. می‌توانید این الگوها را در هر جایی که می‌خواهید قرار دهید، مثلاً در نمای بازیافت‌کننده که در فید اخبار استفاده می‌شود، در کادر گفتگو، یا هر جای دیگری در برنامه‌تان.

الگوهای بومی ما به‌عنوان یک ماژول Android Studio ارائه می‌شوند، بنابراین به‌راحتی می‌توانید آن‌ها را در پروژه خود بگنجانید و به هر شکلی که دوست دارید از آن‌ها استفاده کنید.

اندازه‌های الگو

دو الگو وجود دارد: کوچک و متوسط. هر دو از کلاس 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, "/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 ما مشارکت کنید تا الگوها یا ویژگی‌های جدیدی اضافه شود. درخواست کشیدن برای ما ارسال کنید تا آن را بررسی کنیم.