Integrar banners e anúncios MREC

Visão geral

O Vungle suporta os seguintes três tamanhos de banner e o tamanho MREC padrão.

Sobre anúncios de banner

O Vungle Banner está atualmente em fase BETA. Entre em contato com seu gerente de conta diretamente para obter acesso e garantir um lançamento bem-sucedido.

O plug-in Vungle Unity oferece suporte a anúncios em banner e MREC com base no Vungle SDK for Unity v6.7.0.0. Este formato de anúncio não requer tela inteira; em vez disso, o editor determina a localização do contêiner do anúncio em seu aplicativo. No entanto, o tamanho do contêiner do banner deve ser 320 x 50, 300 x 50 ou 728 x 90 (para tablets). Você pode definir anúncios de banner em qualquer lugar da tela, e o usuário pode continuar usando o aplicativo enquanto o anúncio está sendo reproduzido. O Enum listando os diferentes tamanhos de banner pode ser encontrado no arquivo  VungleSDK.h  (também descrito na tabela abaixo).

Você não está limitado ao número de anúncios não em tela cheia a qualquer momento, mas o plug-in não verifica se vários anúncios estão sendo exibidos em uma posição. Certifique-se de que você esteja chamando um anúncio para qualquer posição fornecida por nosso plug-in e também certifique-se de que eles não se sobreponham se você estiver exibindo mais de um.

O tipo de posicionamento para anúncios de banner deve ser do tipo "Banner" no painel do Vungle. Sinta-se à vontade para entrar em contato com seu gerente de conta para habilitar a colocação de banner no painel.

Sobre anúncios MREC

A partir do Vungle SDK v.6.4.3, o Vungle oferece suporte a anúncios em vídeo MREC. MREC é uma abreviatura para anúncios de "retângulo médio". Ao contrário dos anúncios intersticiais, os anúncios MREC não exigem exibição em tela inteira. Semelhante aos anúncios de banner, os anúncios em vídeo MREC são anúncios retangulares que ocupam um local em qualquer lugar dentro do layout do aplicativo, normalmente exibidos na parte superior ou inferior da tela, para que o usuário possa continuar a interagir com o aplicativo enquanto o anúncio é reproduzido. O tamanho do local para renderizar um anúncio MREC é o padrão do setor: 300x250.

Etapa 1. Integração Completa do Plug-in Básico

Para integrar banner e anúncios MREC em seu aplicativo do Unity, comece seguindo as instruções no artigo de integração básica . Este artigo contém informações complementares e pressupõe que você tenha concluído a integração básica.

Etapa 2. Implementar manipuladores de eventos (opcional)

Você pode configurar manipuladores de eventos para os cinco eventos do Vungle SDK desta apresentação de anúncio.

• O seguinte evento é lançado quando o SDK começa a reproduzir um anúncio em vídeo. Isso é ideal para pausar jogos, efeitos sonoros, animações, etc.
  

  public static event Action onAdStartedEvent;

• O seguinte evento é lançado quando o SDK fecha um anúncio. Isso é ideal para recompensar os usuários e retomar jogos, efeitos sonoros, animações, etc.
  

  public static event Action<string, AdFinishedEventArgs> onAdFinishedEvent;

  O tipo de código AdFinishedEventArgs é composto pelas seguintes propriedades para verificar o resultado da reprodução do anúncio:
  

  public class AdFinishedEventArgs : EventArgs
  {
    //Represents a BOOL whether or not the user clicked the download button.
    public bool WasCallToActionClicked{ get; set;}
  
    //Represents a bool whether or not the video can be considered a completed view.
    public bool IsCompletedView{ get; set;}
  }

• O seguinte evento é lançado quando o SDK alterou o status de disponibilidade do anúncio. O booliano isAdPlayable denota a nova habilidade de reproduzir um placementID específico.
  

  public static event Action<string, bool> adPlayableEvent;

• O seguinte evento é lançado quando o SDK é inicializado com sucesso.
  

  public static event Action onInitializeEvent;

Código de exemplo:

void initializeEventHandlers()
{
    Vungle.onAdStartedEvent += (placementID) => {
        DebugLog ("Ad " + placementID + " is starting!  Pause your game  animation or sound here.");
    };

    Vungle.onAdFinishedEvent += (placementID, args) => {
        DebugLog ("Ad finished - placementID " + placementID + ", was call to action clicked:" + args.WasCallToActionClicked +  ", is completed view:"
                  + args.IsCompletedView);
    };

    Vungle.adPlayableEvent += (placementID, adPlayable) => {
        DebugLog ("Ad's playable state has been changed! placementID " + placementID + ". Now: " + adPlayable);
    };

    Vungle.onInitializeEvent += () => {
        adInited = true;
        DebugLog ("SDK initialized");
    };
}

Etapa 3. Carregar, reproduzir e fechar um anúncio

Carregar um anúncio

Carregar um anúncio que não é em tela cheia funciona de maneira diferente dos anúncios em tela cheia e há uma API específica loadBanner que você usa para carregar. Você deve especificar o tamanho e a posição do anúncio não em tela cheia que deseja carregar, e o SDK irá atualizá-lo automaticamente com o intervalo de tempo que você configurou no painel. Você deve usar posicionamentos criados especificamente para banners ou anúncios MREC.

Carregue um anúncio que não seja de tela inteira chamando o método loadBanner:

Vungle.loadBanner("PLACEMENT_ID", Vungle.VungleBannerSize.VungleAdSizeBanner, Vungle.VungleBannerPosition.BottomCenter);

Exibir um anúncio

Os anúncios que não são de tela inteira serão exibidos na posição do tamanho que você especificou no momento de invocar loadBanner ao chamar showBanner.

Vungle.showBanner("PLACEMENT_ID");

Recomendamos que você verifique a disponibilidade do anúncio antes de tentar reproduzir qualquer anúncio e isAdvertAvailable pode ser usado como anúncios de tela inteira. No entanto, para anúncios que não são de tela inteira, você precisaria passar VungleBannerSize além da ID de posicionamento do anúncio que deseja exibir.

Vungle.isAdvertAvailable("PLACEMENT_ID", Vungle.VungleBannerSize.VungleAdSizeBanner);

Fechar um anúncio

Você pode chamar closeBanner quando quiser dispensar um anúncio que não seja de tela inteira.

Vungle.closeBanner("PLACEMENT_ID");