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

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

بارگیری کردن «الگوهای بومی»

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

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

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

این راهنما نحوه بارگیری، افزودن، و استفاده از «الگوهای بومی» در برنامه‌های iOS را به شما نشان می‌دهد. فرض می‌کند که قبلاً از «کیت توسعه نرم‌افزار» برای بار کردن آگهی بومی باموفقیت استفاده کرده‌اید.

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

دو اندازه الگو وجود دارد: کوچک و متوسط. هر الگو با یک کلاس نشان داده می‌شود. کلاس‌ها 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 با آن‌ها آشنا باشید. اگر ترجیح می‌دهید آگهی‌های بومی‌تان را از ابتدا بسازید، به راهنمای «پیشرفته بومی» ما مراجعه کنید.
چرا وقتی سبک‌هایم را در xib تنظیم می‌کنم، به‌روز نمی‌شوند؟
درحال‌حاضر، همه سبک‌های xib را با فرهنگ لغت سبک‌های پیش‌فرض در GADTTemplateView.m ملغی می‌کنیم.

همیاری

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