Modelos de anúncios nativos

Fazer o download de modelos nativos

Ao usar anúncios nativos, você pode personalizar seus anúncios, resultando em uma melhor experiência do usuário. Experiências melhores podem aumentar o engajamento e melhorar seu rendimento geral.

Para aproveitar ao máximo os anúncios nativos, é importante definir o estilo dos layouts dos seus anúncios para que eles pareçam uma extensão natural do seu aplicativo. Criamos modelos nativos para ajudar você a começar a usá-los.

Os modelos nativos são visualizações completas dos seus anúncios nativos que foram criadas para agilizar a implementação e facilitar a modificação. Com esses modelos, é possível implementar seu primeiro anúncio nativo em apenas alguns minutos, e você pode personalizar a aparência rapidamente, sem precisar de muito código. Você pode colocar esses modelos onde quiser, como em uma TableView usada em um feed de notícias, em uma caixa de diálogo ou em qualquer outro lugar do seu app.

Este guia mostra como fazer o download, incluir e usar modelos nativos em apps para iOS. Partimos do princípio que você já usou o SDK para carregar um anúncio nativo.

Tamanhos de modelo

Existem dois tamanhos de modelo: pequeno e médio. Cada modelo é representado por uma classe. As classes são GADTSmallTemplateView e GADTMediumTemplateView. Ambas as classes estendem GADTTemplateView. Ambos têm uma proporção fixa, que será dimensionada para preencher a largura das visualizações pais somente se você chamar addHorizontalConstraintsToSuperviewWidth. Se você não chamar addHorizontalConstraintsToSuperviewWidth, cada modelo renderizará o tamanho padrão.

Visualização de modelo GADTSmall

O modelo pequeno é ideal para células UICollectionView ou UITableView. Por exemplo, é possível usá-lo para anúncios In-feed ou onde você precisar de uma visualização retangular fina. O tamanho padrão do modelo é 91 pontos de altura por 355 pontos de largura.

Visualização de modelo do GADTMédia

O modelo médio deve ser uma visualização de 1/2 a 3/4 páginas. Isso é bom para páginas de destino ou apresentação, mas também pode ser incluído no UITableViews. O tamanho padrão desse modelo é 370 pontos de altura, com 355 pontos de largura.

Todos os nossos modelos são compatíveis com o layout automático. Fique à vontade para testar o posicionamento. É claro que você também pode alterar o código-fonte e os arquivos xib para atender aos seus requisitos.

Como instalar os modelos de anúncios nativos

Para instalar os modelos nativos, basta fazer o download do zip e arrastá-lo para seu projeto do Xcode. Marque a opção Copiar itens, se necessário.

Como usar modelos de anúncio nativo

Depois de adicionar a pasta ao projeto e incluir a classe relevante no arquivo, siga este roteiro para usar um modelo: A única maneira de mudar as propriedades de fonte e estilo é usando o dicionário de estilos. Atualmente, modificamos qualquer estilo definido no xib.

Objective-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 = [[GADTSmallTemplateView alloc] init];

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

Definir o estilo das chaves do dicionário

A maneira mais rápida de personalizar seus modelos é criar um dicionário com as seguintes chaves:

Objective-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;

Perguntas frequentes

Por que recebo uma exceção quando tento instanciar o objeto de modelo?
Isso poderá acontecer se você tiver alterado o tamanho da visualização no arquivo xib, mas não tiver mudado o tamanho do frame criado no método "setup" da subclasse.
Como posso personalizar ainda mais esses modelos?
Esses modelos são apenas xibs com objetos de visualização associados, como qualquer outra classe de visualização xib e personalizada que você já conhece do desenvolvimento para iOS. Se você preferir criar seus anúncios nativos do zero, consulte nosso guia nativo avançado.
Por que meus estilos não estão sendo atualizados quando eu defini-los no xib?
Modificamos atualmente todos os estilos xib pelo dicionário de estilos padrão em GADTTemplateView.m.

Contribua

Criamos modelos nativos para ajudar você a desenvolver anúncios nativos rapidamente. Queremos que você contribua com nosso repositório do GitHub para adicionar novos modelos ou recursos. Envie uma solicitação de envio para que possamos observá-la.