Integrar anúncios no formato MERC

Visão geral

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

A partir do Vungle SDK v6.4.11, 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 básica completa

Para integrar anúncios MREC em seu aplicativo Android ou Amazon, siga 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 ouvintes de eventos

Implementar ouvintes de evento

Você pode usar callbacks genéricas, implementando LoadAdCallback para eventos de carregamento de anúncios e PlayAdCallback para eventos de reprodução de anúncios, ou usar callbacks em linhas ao invocar loadAd e playAd.

LoadAdCallback

6.5.0 e acima Legado
private final LoadAdCallback vungleLoadAdCallback = new LoadAdCallback() { 
  @Override
  public void onAdLoad(String id) { 
    // Ad has been successfully loaded for the placement
  } 

  @Override 
  public void onError(String id, VungleException exception) { 
    // Ad has failed to load for the placement
  }
};
Métodos substituíveis Descrição
onAdLoad(String id) Chamado quando o anúncio é carregado com sucesso e reproduzido para a veiculação
onError(String id) Chamado quando ocorre um erro ao tentar reproduzir um anúncio. Você poderá verificar a mensagem de erro de getLocalizedMessage de VungleExceptione usar getExceptionCode para depuração.

PlayAdCallback

6.6.0 e acima Legado
private final PlayAdCallback vunglePlayAdCallback = new PlayAdCallback() {
  @Override
  public void onAdStart(String id) { 
    // Ad experience started
  }

  @Override
  public void onAdEnd(String id) {
    // Ad experience ended
  }

  @Override
  public void onAdClick(String id) {
    // User clicked on ad
} @Override public void onAdRewarded(String id) { // User earned reward for watching an ad } @Override public void onAdLeftApplication(String id) { // User has left app during an ad experience } @Override public void onError(String id, VungleException exception) { // Ad failed to play } };
Métodos substituíveis Descrição
onAdStart(String id) Invocado quando o anúncio é lançado com sucesso e exibido no dispositivo.
onAdEnd(String id) Invocado quando toda a experiência do anúncio é concluída, pouco antes de o controle retornar ao aplicativo de origem.
onAdClick(String id) Invocado quando o usuário clica em um anúncio em vídeo ou botão de download.
onAdRewarded(String id) Invocado quando o usuário concluiu 80% do vídeo com recompensa e deve ser recompensado. Recompensar o usuário deve ocorrer aqui e só será acionado para veiculações com recompensa.
onAdLeftApplication(String id) Invocado quando o usuário sai do aplicativo antes que a experiência do anúncio seja concluída, como abrir a página da Loja do anúncio.
onAdError(String id, VungleException exception) Chamado quando ocorre um erro ao tentar reproduzir um anúncio. Você poderá verificar a mensagem de erro de getLocalizedMessage de VungleExceptione usar getExceptionCode para depuração.

Etapa 3. Carregar, exibir e fechar um anúncio MREC

Carregar um anúncio MREC

Carregar um anúncio MREC é o mesmo que carregar um anúncio de tela cheia. Contudo, o posicionamento deve ser configurado para suportar um feed MREC. Contate seu gerente de conta da Vungle para ativar o MREC para veiculação.

Exibir um anúncio MREC

Como o tamanho da visualização é fixo, o local usado para exibir o anúncio MREC deve ser especificado como 300 dp x 250 dp, e a visualização pode ser colocada em qualquer lugar da tela. Este local é um RelativeLayOut.

Você pode colocar esse RelativeLayout em qualquer lugar da tela. Você deve então chamar AdConfig.setAdSize para especificar o tamanho do anúncio a ser AdConfig.AdSize.VUNGLE_MREC e passar esse objeto ao chamar o Vungle.getNativeAd para obter o objeto de anúncio MREC.

Por fim, chame a função addView para associar o local ao anúncio MREC. O Vungle MREC reproduz com o som habilitado como padrão, mas você pode definir a opção setMuted para true para iniciar o vídeo sem som.

private RelativeLayout mrecContainer = findViewById(...);

AdConfig adConfig = new AdConfig();
adConfig.setAdSize(AdConfig.AdSize.VUNGLE_MREC);
adConfig.setMuted(true);

VungleNativeAd vungleNativeAd = Vungle.getNativeAd("MREC_ID", adConfig, vunglePlayAdCallback);
View nativeAdView = vungleNativeAd.renderNativeView();
mrecContainer.addView(nativeAdView);

Fechar um anúncio MREC

Como você adicionou o anúncio MREC à visualização do local, ela também deve ser removida se a visualização do anúncio desaparecer da tela, se a atividade ou fragmento for destruído ou se o local de exibição principal for reciclado ou destruído. Se você tentar reproduzir outro anúncio MREC sem fechar o anúncio anterior, isso causará um comportamento inesperado no seu aplicativo. Portanto, chame finishDisplayingAd para encerrar o anúncio. Também recomendamos que você remova o evento de visualização onAdEnd.

private VungleNativeAd vungleNativeAd;

// Calling finishDisplayingAd when you want to finish displaying MREC Ad
// will trigger onAdEnd and will tell you when you can remove the child
// MREC view container 
vungleNativeAd.finishDisplayingAd();

// And removing empty ad view from container
@Override 
public void onAdEnd(String id, boolean completed) {
    …
    parentView.removeView(nativeAdView);
    vungleNativeAd = null;
    …
}

Anexar e desanexar o estado de um anúncio MREC

Se o usuário fizer rolagem até o ponto em que o anúncio em vídeo não é mais visível na tela, você deve pausar o vídeo e continuar quando estiver visível novamente. Para controlar os estados de pausa e continuação, chame setAdVisibility na instância VungleNativeAd, e defina-o como true se o vídeo estiver visível e como false se o vídeo sair da tela. O setAdVisibility não deve ser confundido com a visibilidade da Visualização: esse configurador informa o Vungle SDK se a visualização do anúncio MREC está visível ou não, e conforme o caso, o SDK pausa/continua a reprodução do vídeo.

  • Pausar um anúncio MREC:
    vungleNativeAd.setAdVisibility(false);
  • Retomar um anúncio MREC:
    vungleNativeAd.setAdVisibility(true);

 

Etapa 4. Personalizar anúncios MREC (opcional)

Você tem a opção de personalizar anúncios individuais que reproduz, fornecendo um novo objeto adConfig para o playAd. Quando o objeto AdConfig é nulo, o anúncio é reproduzido com as configurações padrão; quando não é nulo, suas configurações substituem as do AdConfig. A seguir está um exemplo de como usar o AdConfig:

Vungle.playAd(placementReferenceID, adConfig, vunglePlayAdCallback);

O exemplo acima usa o objeto adConfig, que contém opções de configuração personalizadas. Defina o objeto AdConfig como mostrado:

objeto
AdConfig adConfig = new AdConfig();
adConfig.setAdOrientation(AdConfig.AUTO_ROTATE);
adConfig.setMuted(true);
Vungle.playAd(placementReferenceID, adConfig, vunglePlayAdCallback);

A tabela a seguir lista as opções disponíveis do AdConfig para anúncios MREC:

Opção Descrição

setMuted

‘false’ se o vídeo começar com as configurações de áudio correspondentes à do aplicativo em questão, ‘true’ se começar mudo

setOrdinal

tem um valor inteiro ordinal para rastrear o número de anúncios que foram reproduzidos na mesma sessão

Observação: você pode usar o mesmo objeto AdConfig para vários anúncios.

Questions?

Need further assistance, feel free to reach out to us, we’re here to help!

Esse artigo foi útil?