الگوهای بومی

پلتفرم مورد نظر: اندروید، iOS و فلاتر

دانلود قالب‌های بومی

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

برای اینکه بیشترین بهره را از تبلیغات بومی ببرید، مهم است که طرح‌بندی تبلیغات خود را طوری طراحی کنید که مانند یک افزونه طبیعی از برنامه شما به نظر برسند. برای کمک به شما در شروع کار، ما قالب‌های بومی ایجاد کرده‌ایم.

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

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

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

دو قالب وجود دارد: کوچک و متوسط. هر دو از کلاس TemplateView استفاده می‌کنند و هر دو نسبت ابعاد ثابتی دارند. آن‌ها برای پر کردن عرض ویوهای والد خود، مقیاس‌بندی می‌شوند.

قالب کوچک

@layout/gnt_small_template_view

این قالب کوچک برای نماهای بازیافتی یا هر زمانی که به یک نمای تبلیغ مستطیلی بلند نیاز دارید، ایده‌آل است. به عنوان مثال، می‌توانید از آن برای تبلیغات درون فید استفاده کنید.

الگوی متوسط

@layout/gnt_medium_template_view

قالب متوسط ​​برای نمایش نیم تا سه چهارم صفحه در نظر گرفته شده است، اما می‌تواند در فیدها نیز استفاده شود. این قالب برای صفحات فرود یا صفحات اسپلش مناسب است.

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

نصب قالب‌های تبلیغات بومی

برای نصب قالب‌های بومی، کافیست فایل زیپ را دانلود کنید (با استفاده از گزینه Clone یا دانلود در GitHub) و ماژول را به پروژه اندروید استودیوی موجود خود وارد کنید.

  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 سنتی layout و استفاده از شیء NativeTemplateStyle.Builder ما. نمونه کد بالا نحوه استفاده از شیء NativeTemplateStyle.Builder را برای تنظیم رنگ پس‌زمینه اصلی نشان می‌دهد، اما گزینه‌های متنوع دیگری نیز وجود دارد. در اینجا تمام متدهای سازنده موجود آمده است. سازنده یک شیء NativeTemplateStyle را برمی‌گرداند که هرگونه استایل‌بندی طرح‌بندی XML را لغو می‌کند. طرح‌بندی‌های XML gnt_small_template.xml و gnt_medium_template.xml از همان پارامترهای استایل‌بندی اندروید استفاده می‌کنند که قبلاً با آنها آشنا هستید.

متدهای سازنده برای سبک قالب بومی
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

رنگ اصلی زمینه.

مشارکت

ما قالب‌های بومی (Native Templates) را برای کمک به شما در توسعه سریع تبلیغات بومی (Native Ads) ایجاد کرده‌ایم. ما دوست داریم ببینیم که شما در مخزن گیت‌هاب ما مشارکت می‌کنید تا قالب‌ها یا ویژگی‌های جدیدی اضافه کنید. یک درخواست pull برای ما ارسال کنید تا بررسی کنیم.