Adicionar banners de anúncio e anúncios retangulares de tamanho médio a um app Unity

O Audience Network permite que você monetize apps para Android e iOS usando os anúncios do Facebook. Este guia explica como adicionar banners de anúncio ao seu app.

Certifique-se de ter concluído os guias de Introdução do Audience Network e de Introdução do Unity antes de continuar.

Etapas para banners de anúncio e anúncios retangulares de tamanho médio

Etapa 1: criar um objeto de banner

Etapa 2: adicionar eventos de retorno de chamada

Etapa 3: carregar um anúncio

Etapa 4: exibir o anúncio

A primeira etapa para exibir um banner de anúncio é criar um objeto AdView em um script C# anexado a um GameObject.

...
using AudienceNetwork;
...

public class AdViewTest : MonoBehaviour
{
    ...
    private AdView adView;
    ...

    public void LoadBanner()
    {
        if (this.adView) {
            this.adView.Dispose();
        }

        this.adView = new AdView("YOUR_PLACEMENT_ID", AdSize.BANNER_HEIGHT_50);
        this.adView.Register(this.gameObject);

        // Set delegates to get notified on changes or when the user interacts with the ad.
        this.adView.AdViewDidLoad = (delegate() {
            Debug.Log("Banner loaded.");
            this.adView.Show(100);
        });
        adView.AdViewDidFailWithError = (delegate(string error) {
            Debug.Log("Banner failed to load with error: " + error);
        });
        adView.AdViewWillLogImpression = (delegate() {
            Debug.Log("Banner logged impression.");
        });
        adView.AdViewDidClick = (delegate() {
            Debug.Log("Banner clicked.");
        });

        // Initiate a request to load an ad.
        adView.LoadAd();
    }
    ...
}

O construtor de um AdView tem os seguintes parâmetros:

  • placementId: a identificação do posicionamento do Audience Network para a unidade de banner de anúncio.
  • size: o tamanho do banner de anúncio, especificado pelos valores de enumeração de AdSize.

Etapa 2: adicionar eventos de retorno de chamada

Em seguida, é possível implementar alguns retornos de chamada para assinar os eventos do ciclo de vida do anúncio em banner. Acompanhe esses eventos registrando um delegado para o evento, como exibido no exemplo abaixo:

...
// Set delegates to get notified on changes or when the user interacts with the ad.
this.adView.AdViewDidLoad = (delegate() {
    Debug.Log("Banner loaded.");
    this.adView.Show(100);
});
adView.AdViewDidFailWithError = (delegate(string error) {
    Debug.Log("Banner failed to load with error: " + error);
});
adView.AdViewWillLogImpression = (delegate() {
    Debug.Log("Banner logged impression.");
});
adView.AdViewDidClick = (delegate() {
    Debug.Log("Banner clicked.");
});
...

Etapa 3: carregar um anúncio

Depois que o AdView é iniciado, a próxima etapa é carregar um anúncio. Isso é feito com o método loadAd() na classe AdView.

No exemplo exibido acima, veja como carregar um anúncio:

...
adView.LoadAd();
...

Etapa 4: exibir o anúncio

Por fim, quando o banner for carregado, você poderá chamar o método Show para renderizar o anúncio na tela. Por exemplo, é possível exibir o anúncio quando ele terminar de carregar com o retorno de chamada AdViewDidLoad:

this.adView.AdViewDidLoad = (delegate() {
    Debug.Log("Banner loaded.");
    this.adView.Show(100);
});

Há três tipos diferentes de método Show na classe AdView que podem ser usados para renderizar a unidade de banner de anúncio:

  • public bool Show(AdPosition position): renderiza a unidade de banner de anúncio em locais predefinidos. As opções disponíveis são: AdPosition.TOP (renderiza o anúncio na parte superior da tela) e AdPosition.BOTTOM (renderiza o anúncio na parte inferior da tela).
  • public bool Show(double y): renderiza a unidade de banner de anúncio nas coordenadas (0, y) da tela.
  • public bool Show(double x, double y): renderiza a unidade de banner de anúncio nas coordenadas (x, y) da tela.

Tamanhos do banner de anúncio

O Audience Network é compatível com três tamanhos de anúncio que podem ser usados em AdView. A largura da unidade Banner é flexível, com um mínimo de 320 pixels, e apenas a altura é definida.

Formato do anúncio Referência de AdSize Tamanho Recomendação

Banner padrão

BANNER_50

320 x 50

Este banner é o mais apropriado para celulares

Banner grande

BANNER_90

320 x 90

Este banner é o mais apropriado para tablets e dispositivos grandes

Retângulo médio

RECTANGLE_HEIGHT_250

300 x 250

Este formato é o mais apropriado para feeds com rolagem ou telas no final de níveis

Próximas etapas

Siga nossos guias para integrar diferentes formatos de anúncio no seu aplicativo Unity:

Quando estiver pronto para lançar seu aplicativo e monetizar, envie o aplicativo para análise após garantir que ele cumpre as Políticas do Audience Network e os Padrões da Comunidade do Facebook.