الگوهای بومی

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

نکته کلیدی: قبل از ادامه، بدانید که چگونه یک تبلیغ بومی را بارگیری کنید .

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

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

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

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

این راهنما به شما نحوه دانلود، گنجاندن و استفاده از الگوهای Native را در برنامه های iOS خود نشان می دهد. فرض بر این است که شما قبلاً با موفقیت از SDK برای بارگیری یک تبلیغ بومی استفاده کرده اید.

اندازه های قالب

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

GADTSmallTemplateView

قالب کوچک برای سلول های UICollectionView یا UITableView ایده آل است. به عنوان مثال می توانید از آن برای تبلیغات درون فید یا هر جایی که نیاز به یک نمای مستطیلی نازک تبلیغاتی دارید استفاده کنید. اندازه پیش فرض این قالب 91 امتیاز ارتفاع در 355 نقطه عرض است.

GADTMMediumTemplateView

الگوی متوسط ​​به معنای نمایش 1/2 تا 3/4 صفحه است. این برای صفحات فرود یا چلپ چلوپ خوب است، اما می تواند در UITableViews نیز گنجانده شود. اندازه پیش فرض این قالب 370 امتیاز ارتفاع در 355 نقطه عرض است.

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

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

برای نصب Native Templates، به سادگی فایل فشرده را دانلود کرده و آن را به پروژه Xcode خود بکشید. در صورت نیاز حتما موارد کپی را بررسی کنید.

استفاده از قالب های تبلیغاتی بومی

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

هدف-C

/// 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];

کلیدهای فرهنگ لغت سبک

سریع‌ترین راه برای سفارشی‌سازی قالب‌ها، ساختن فرهنگ لغت با کلیدهای زیر است:

هدف-C

/// 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 تغییر داده باشید اما اندازه فریم ایجاد شده در روش "setup" زیر کلاس را تغییر نداده باشید، ممکن است اتفاق بیفتد.

چگونه می توانم این قالب ها را بیشتر سفارشی کنم؟

این الگوها فقط xibs با اشیاء نمای مرتبط هستند، مانند هر کلاس دیگر xib و نمای سفارشی که ممکن است در توسعه iOS به آن عادت کرده باشید. اگر ترجیح می دهید تبلیغات بومی خود را از ابتدا بسازید، به راهنمای پیشرفته بومی ما مراجعه کنید.

چرا وقتی استایل های من را در xib تنظیم می کنم به روز نمی شوند؟

ما در حال حاضر همه سبک‌های xib را توسط فرهنگ لغت سبک‌های پیش‌فرض در GADTTemplateView.m لغو می‌کنیم.

مشارکت کنید

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

،

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

نکته کلیدی: قبل از ادامه، بدانید که چگونه یک تبلیغ بومی را بارگیری کنید .

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

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

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

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

این راهنما به شما نحوه دانلود، گنجاندن و استفاده از الگوهای Native را در برنامه های iOS خود نشان می دهد. فرض بر این است که شما قبلاً با موفقیت از SDK برای بارگیری یک تبلیغ بومی استفاده کرده اید.

اندازه های قالب

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

GADTSmallTemplateView

قالب کوچک برای سلول های UICollectionView یا UITableView ایده آل است. به عنوان مثال، می توانید از آن برای تبلیغات درون فید یا هر جایی که به یک نمای تبلیغاتی مستطیلی نازک نیاز دارید استفاده کنید. اندازه پیش فرض این قالب 91 امتیاز ارتفاع در 355 نقطه عرض است.

GADTMMediumTemplateView

قالب متوسط ​​برای نمایش 1/2 تا 3/4 صفحه در نظر گرفته شده است. این برای صفحات فرود یا چلپ چلوپ خوب است، اما می تواند در UITableViews نیز گنجانده شود. اندازه پیش فرض این قالب 370 امتیاز ارتفاع در 355 نقطه عرض است.

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

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

برای نصب Native Templates، به سادگی فایل فشرده را دانلود کرده و آن را به پروژه Xcode خود بکشید. در صورت نیاز حتما موارد کپی را بررسی کنید.

استفاده از قالب های تبلیغاتی بومی

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

هدف-C

/// 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];

کلیدهای فرهنگ لغت سبک

سریع‌ترین راه برای سفارشی‌سازی قالب‌ها، ساختن فرهنگ لغت با کلیدهای زیر است:

هدف-C

/// 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 تغییر داده باشید اما اندازه فریم ایجاد شده در روش "setup" زیر کلاس را تغییر نداده باشید، ممکن است اتفاق بیفتد.

چگونه می توانم این قالب ها را بیشتر سفارشی کنم؟

این الگوها فقط xibs با اشیاء نمای مرتبط هستند، مانند هر کلاس دیگر xib و نمای سفارشی که ممکن است در توسعه iOS به آن عادت کرده باشید. اگر ترجیح می دهید تبلیغات بومی خود را از ابتدا بسازید، به راهنمای پیشرفته بومی ما مراجعه کنید.

چرا وقتی استایل های من را در xib تنظیم می کنم به روز نمی شوند؟

ما در حال حاضر همه سبک‌های xib را توسط فرهنگ لغت سبک‌های پیش‌فرض در GADTTemplateView.m لغو می‌کنیم.

مشارکت کنید

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