Banner

Os anúncios de banner são anúncios retangulares de imagem ou texto que ocupam um espaço dentro do layout do aplicativo. Eles permanecem na tela enquanto os usuários interagem com o app e podem ser atualizados automaticamente após um determinado período de tempo. Se você é novo em publicidade mobile, eles são uma excelente opção para começar.

Integração

Os banners são integrados adicionando o widget WortiseBanner ao layout do app. Abaixo, você encontra um exemplo simples de integração:

import { RNWortiseAdSize, WortiseBanner } from '@wortise/react-native-sdk';

/* ... */

const bannerRef = useRef(null);

return (
  <View style={styles.container}>
    <Button
      onPress={bannerRef.current?.loadAd()}
      title="Carregar Banner"
    />
    <WortiseBanner
      ref={bannerRef}
      adSize={RNWortiseAdSize.HEIGHT_50}
      adUnitId="Ad Unit ID da Wortise"
    />
  </View>
);

O widget tem suporte aos seguintes parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição
adUnitId	String	Sim	O ID do ad unit a ser atribuído ao banner
adSize	String	Não	Tamanho máximo (altura) do banner. Os valores possíveis para este parâmetro estão declarados no objeto `RNWortiseAdSize`
autoRefreshTime	Integer	Não	Valor em segundos que representa o tempo que deve transcorrer para carregar um novo anúncio de banner
onClicked	Function	Não	Função que será invocada quando o banner for clicado
onFailedToLoad	Function	Não	Função que será invocada quando o banner não conseguir carregar um anúncio
onImpression	Function	Não	Função que será invocada quando o banner gerar uma impressão
onLoaded	Function	Não	Função que será invocada quando o banner carregar um anúncio
onRevenuePaid	Function	Não	Função que será invocada quando o banner gerar receita
onSizeChange	Function	Não	Função que será invocada quando o tamanho do banner mudar
requestParameters	Object	Não	Parâmetros extras para a solicitação do anúncio, como a posição do banner colapsável

Banners adaptativos

Os banners adaptativos são um novo formato de banner em que o tamanho dos anúncios se adapta ao dispositivo e à interface do app, com o objetivo de maximizar o desempenho.

Atualmente há suporte para dois tipos de banners adaptativos:

Ancorados

Este tipo de banner foi projetado para substituir os banners tradicionais de 320x50 e ser posicionado na parte superior ou inferior da tela.

Para usar este formato, um AdSize gerado da seguinte forma deve ser passado ao widget BannerAd:

import { RNWortiseAdSize } from '@wortise/react-native-sdk';

// Você precisa especificar a largura do banner
RNWortiseAdSize.getAnchoredAdaptiveBannerAdSize(width);

Inline

Este outro tipo de banner, em comparação com o ancorado, foi projetado para ter altura variável e ser posicionado dentro de um conteúdo rolável.

Neste caso, um AdSize deve ser gerado desta forma:

import { RNWortiseAdSize } from '@wortise/react-native-sdk';

// Você precisa especificar a largura do banner. A altura máxima é um
// parâmetro opcional (passando 0 ou um valor negativo)
RNWortiseAdSize.getInlineAdaptiveBannerAdSize(width, maxHeight);

Banners colapsáveis

Os banners colapsáveis são banners ancorados que inicialmente são exibidos como uma sobreposição maior, com um botão que os recolhe ao tamanho declarado. Eles têm como objetivo melhorar o desempenho dos banners ancorados sem ocupar mais espaço de forma permanente.

Para solicitar um, passe a posição desejada por meio da propriedade requestParameters:

<WortiseBanner
  adSize={adSize}
  adUnitId="Ad Unit ID da Wortise"
  requestParameters={{ collapsible: 'bottom' }}
/>

A posição determina onde o anúncio expandido é ancorado, e deve corresponder à posição do banner dentro do layout do app:

Valor	Descrição
`'bottom'`	O banner é posicionado na parte inferior da tela
`'top'`	O banner é posicionado na parte superior da tela