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

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

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

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

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

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

این راهنما به شما نشان می‌دهد که چگونه الگوهای بومی را در برنامه‌های iOS خود بارگیری، اضافه و استفاده کنید. فرض بر این است که قبلاً با موفقیت از SDK برای بار کردن آگهی بومی استفاده کرده‌اید.

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

دو اندازه الگو وجود دارد: کوچک و متوسط. هر الگو با یک کلاس نمایش داده می‌شود. کلاس‌ها GADTSmallTemplateView و GADTMediumTemplateView هستند. هر دو کلاس GADTTemplateView را گسترش می‌دهند. هر دو الگو نسبت ابعادی ثابتی دارند که فقط درصورت فراخوانی addHorizontalConstraintsToSuperviewWidth، برای پر کردن عرض نماهای والدشان مقیاس‌بندی می‌شوند. اگر addHorizontalConstraintsToSuperviewWidth را فراخوانی نکنید، هر الگو اندازه پیش‌فرض خود را ارائه خواهد داد.

GADTSmallTemplateView

الگوی کوچک برای سلول‌های UICollectionView یا UITableView ایده‌آل است. برای مثال، می‌توانید از آن برای آگهی‌های درون فید یا هرجایی که به نمای آگهی مستطیلی باریک نیاز دارید استفاده کنید. اندازه پیش‌فرض این الگو ۹۱ نقطه ارتفاع و ۳۵۵ نقطه عرض است.

GADTMediumTemplateView

الگوی متوسط برای نمای ۱/۲ تا ۳/۴ صفحه درنظر گرفته شده است. این برای صفحه‌های فرود یا صفحه‌های خوشامدگویی خوب است، اما می‌تواند در UITableViews نیز گنجانده شود. اندازه پیش‌فرض این الگو ۳۷۰ نقطه ارتفاع و ۳۵۵ نقطه عرض است.

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

درحال نصب الگوهای آگهی بومی

برای نصب «الگوهای بومی»، کافی است فایل zip را بارگیری کنید و آن را به پروژه Xcode خود بکشید. حتماً کپی کردن موارد درصورت نیاز را علامت بزنید.

استفاده از الگوهای آگهی بومی

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

آبجکتیو-سی

/// Step 1: Import the templates that you need.
#import "NativeTemplates/GADTSmallTemplateView.h"
#import "NativeTemplates/GADTTemplateView.h"
...

// STEP 2: Initialize your template view object.
GADTSmallTemplateView *templateView =
    [[NSBundle mainBundle] loadNibNamed:@"GADTSmallTemplateView" owner:nil options:nil]
      .firstObject;

// STEP 3: Template views are just GADNativeAdViews.
_nativeAdView = templateView;
nativeAd.delegate = self;

// STEP 4: Add your template as a subview of whichever view you'd like.
// This must be done before calling addHorizontalConstraintsToSuperviewWidth.
// Please note: Our template objects are subclasses of GADNativeAdView so
// you can insert them into whatever type of view you’d like, and don’t need to
// create your own.
[self.view addSubview:templateView];

// STEP 5 (Optional): Create your styles dictionary. Set your styles dictionary
// on the template property. A default dictionary is created for you if you do
// not set this. Note - templates do not currently respect style changes in the
// xib.

NSString *myBlueColor = @"#5C84F0";
NSDictionary *styles = @{
    GADTNativeTemplateStyleKeyCallToActionFont : [UIFont systemFontOfSize:15.0],
    GADTNativeTemplateStyleKeyCallToActionFontColor : UIColor.whiteColor,
    GADTNativeTemplateStyleKeyCallToActionBackgroundColor :
        [GADTTemplateView colorFromHexString:myBlueColor],
    GADTNativeTemplateStyleKeySecondaryFont : [UIFont systemFontOfSize:15.0],
    GADTNativeTemplateStyleKeySecondaryFontColor : UIColor.grayColor,
    GADTNativeTemplateStyleKeySecondaryBackgroundColor : UIColor.whiteColor,
    GADTNativeTemplateStyleKeyPrimaryFont : [UIFont systemFontOfSize:15.0],
    GADTNativeTemplateStyleKeyPrimaryFontColor : UIColor.blackColor,
    GADTNativeTemplateStyleKeyPrimaryBackgroundColor : UIColor.whiteColor,
    GADTNativeTemplateStyleKeyTertiaryFont : [UIFont systemFontOfSize:15.0],
    GADTNativeTemplateStyleKeyTertiaryFontColor : UIColor.grayColor,
    GADTNativeTemplateStyleKeyTertiaryBackgroundColor : UIColor.whiteColor,
    GADTNativeTemplateStyleKeyMainBackgroundColor : UIColor.whiteColor,
    GADTNativeTemplateStyleKeyCornerRadius : [NSNumber numberWithFloat:7.0],
};

templateView.styles = styles;

// STEP 6: Set the ad for your template to render.
templateView.nativeAd = nativeAd;

// STEP 7 (Optional): If you'd like your template view to span the width of your
// superview call this method.
[templateView addHorizontalConstraintsToSuperviewWidth];
[templateView addVerticalCenterConstraintToSuperview];

کلیدهای واژه‌نامه سبک

سریع‌ترین راه برای سفارشی‌سازی الگوها این است که واژه‌نامه‌ای با کلیدهای زیر بسازید:

آبجکتیو-سی

/// Call to action font. Expects a UIFont.
GADTNativeTemplateStyleKeyCallToActionFont

/// Call to action font color. Expects a UIColor.
GADTNativeTemplateStyleKeyCallToActionFontColor;

/// Call to action background color. Expects a UIColor.
GADTNativeTemplateStyleKeyCallToActionBackgroundColor;

/// The font, font color and background color for the first row of text in the
/// template.

/// All templates have a primary text area which is populated by the native ad's
/// headline.

/// Primary text font. Expects a UIFont.
GADTNativeTemplateStyleKeyPrimaryFont;

/// Primary text font color. Expects a UIFont.
GADTNativeTemplateStyleKeyPrimaryFontColor;

/// Primary text background color. Expects a UIColor.
GADTNativeTemplateStyleKeyPrimaryBackgroundColor;

/// The font, font color and background color for the second row of text in the
/// template.

/// All templates have a secondary text area which is populated either by the
/// body of the ad, or by the rating of the app.

/// Secondary text font. Expects a UIFont.
GADTNativeTemplateStyleKeySecondaryFont;

/// Secondary text font color. Expects a UIColor.
GADTNativeTemplateStyleKeySecondaryFontColor;

/// Secondary text background color. Expects a UIColor.
GADTNativeTemplateStyleKeySecondaryBackgroundColor;

/// The font, font color and background color for the third row of text in the
/// template. The third row is used to display store name or the default
/// tertiary text.

/// Tertiary text font. Expects a UIFont.
GADTNativeTemplateStyleKeyTertiaryFont;

/// Tertiary text font color. Expects a UIColor.
GADTNativeTemplateStyleKeyTertiaryFontColor;

/// Tertiary text background color. Expects a UIColor.
GADTNativeTemplateStyleKeyTertiaryBackgroundColor;

/// The background color for the bulk of the ad. Expects a UIColor.
GADTNativeTemplateStyleKeyMainBackgroundColor;

/// The corner rounding radius for the icon view and call to action. Expects an
/// NSNumber.
GADTNativeTemplateStyleKeyCornerRadius;

پرسشگان

چرا وقتی می‌خواهم شیء الگو را نمونه‌سازی کنم، استثنا دریافت می‌کنم؟
این مشکل زمانی رخ می‌دهد که اندازه نما را در فایل xib تغییر داده باشید اما اندازه قاب ایجادشده در روش «راه‌اندازی» زیرکلاس را تغییر نداده باشید.
چگونه می‌توانم این الگوها را بیشتر سفارشی‌سازی کنم؟
این الگوها فقط xib با اشیاء نمای مرتبط هستند، مانند هر کلاس نمای سفارشی و xib دیگری که ممکن است از توسعه iOS به آن عادت کرده باشید. اگر ترجیح می‌دهید آگهی‌های بومی‌تان را از ابتدا بسازید، راهنمای Native Advanced ما را ببینید.
چرا وقتی سبک‌هایم را در xib تنظیم می‌کنم، به‌روز نمی‌شوند؟
درحال‌حاضر همه سبک‌های xib را با واژه‌نامه سبک‌های پیش‌فرض در GADTTemplateView.m لغو می‌کنیم.

همیاری

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