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
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
}
};
// 6.4.x & below
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, Throwable throwable) {
// 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 VungleException e usar getExceptionCode para depuração. |
PlayAdCallback
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
}
};
// 6.5.x & below
private final PlayAdCallback vunglePlayAdCallback = new PlayAdCallback() {
@Override
public void onAdStart(String placementReferenceId) {
// Ad experience started
}
// Deprecated
@Override
public void onAdEnd(String placementReferenceId, boolean completed, boolean isCTAClicked) {
// Invoked when the ad experience is completed
// isCTAClicked flag indicates whether CTA download button has been triggered
// completed flag will indicate whether user has watched 80% of video or longer.
}
@Override
public void onError(String placementReferenceId, 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 VungleException e 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:
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 |
|
‘false’ se o vídeo começar com as configurações de áudio correspondentes à do aplicativo em questão, ‘true’ se começar mudo |
|
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.