Собственные шаблоны

Загрузить собственные шаблоны

Ключевой момент: прежде чем продолжить, узнайте, как загрузить нативное объявление .

Используя нативную рекламу, вы можете настроить свою рекламу, что сделает ее более удобной для пользователей. Улучшение пользовательского опыта может повысить вовлеченность и повысить общую доходность.

Чтобы получить максимальную отдачу от нативной рекламы, важно стилизовать макеты объявлений так, чтобы они выглядели естественным продолжением вашего приложения. Чтобы помочь вам начать работу, мы создали собственные шаблоны.

Нативные шаблоны — это представления нативной рекламы с полным кодом, предназначенные для быстрого внедрения и простоты модификации. С помощью нативных шаблонов вы можете реализовать свое первое нативное объявление всего за несколько минут и быстро настроить внешний вид без большого количества кода. Вы можете разместить эти шаблоны где угодно, например в TableView, используемом в ленте новостей, в диалоговом окне или где-либо еще в вашем приложении.

Примечание. Если вы заинтересованы в разработке собственных собственных макетов с нуля, вместо этого вернитесь к документации Native Advanced .

Это руководство покажет вам, как загружать, включать и использовать собственные шаблоны в ваших приложениях для iOS. Предполагается, что вы уже успешно использовали SDK для загрузки нативного объявления.

Размеры шаблонов

Есть два размера шаблонов: маленький и средний. Каждый шаблон представлен классом. Это классы GADTSmallTemplateView и GADTMediumTemplateView . Оба класса расширяют GADTTemplateView . Оба шаблона имеют фиксированное соотношение сторон, которое будет масштабироваться, чтобы заполнить ширину родительских представлений, только если вы вызовете addHorizontalConstraintsToSuperviewWidth . Если вы не вызовете addHorizontalConstraintsToSuperviewWidth , каждый шаблон будет отображать свой размер по умолчанию.

GADTSmallTemplateView

Небольшой шаблон идеально подходит для ячеек UICollectionView или UITableView . Например, вы можете использовать его для рекламы в ленте или везде, где вам нужен тонкий прямоугольный вид рекламы. Размер этого шаблона по умолчанию составляет 91 пункт в высоту и 355 пунктов в ширину.

GADTMediumTemplateView

Средний шаблон рассчитан на просмотр от 1/2 до 3/4 страницы. Это хорошо для целевых страниц или заставок, но также может быть включено в UITableViews . Размер этого шаблона по умолчанию составляет 370 пунктов в высоту и 355 пунктов в ширину.

Все наши шаблоны поддерживают авторазметку, поэтому не стесняйтесь экспериментировать с размещением. Конечно, вы также можете изменить исходный код и файлы xib в соответствии с вашими требованиями.

Установка шаблонов нативных объявлений

Чтобы установить собственные шаблоны, просто загрузите zip-архив и перетащите его в свой проект 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» подкласса.

Как я могу дополнительно настроить эти шаблоны?

Эти шаблоны представляют собой просто xib со связанными объектами представления, как и любой другой xib и пользовательский класс представления, к которому вы, возможно, привыкли при разработке iOS. Если вы предпочитаете создавать нативную рекламу с нуля, ознакомьтесь с нашим расширенным руководством по нативной рекламе .

Почему мои стили не обновляются, когда я устанавливаю их в xib?

В настоящее время мы переопределяем все стили xib словарем стилей по умолчанию в GADTTemplateView.m .

Способствовать

Мы создали нативные шаблоны, которые помогут вам быстро разработать нативную рекламу. Мы будем рады, если вы внесете свой вклад в наш репозиторий GitHub , добавив новые шаблоны или функции. Отправьте нам запрос на вытягивание, и мы посмотрим.