Visão geral
Sobre anúncios intersticiais
Anúncios intersticiais são anúncios em tela cheia que cobrem a interface do seu aplicativo. Eles normalmente são exibidos em pontos de transição naturais no fluxo do seu aplicativo, como entre atividades ou durante a pausa entre os níveis em um jogo. Alguns anúncios intersticiais são anúncios com recompensa.
Sobre anúncios com recompensa
Anúncios com recompensa proporcionam uma ótima experiência do usuário, oferecendo aos usuários algo de valor em troca de assistir ou interagir com um anúncio. Normalmente, essa troca é uma recompensa em seu aplicativo, como vidas extras em um jogo, moeda virtual ou uma dica em um quebra-cabeça (você determina a natureza e o valor da recompensa). Exibidos em intervalos naturais no aplicativo, os anúncios em vídeo com recompensa oferecem alta receita, especialmente se você seguir nossa recomendação de torná-los impossíveis de pular.
Observe que anúncios com recompensa são, às vezes, chamados de anúncios incentivados; ambos os termos sempre se referem ao mesmo tipo de anúncio. No entanto, “recompensado” é o termo preferido. No código do SDK e em nossa API de relatórios, usamos o termo "incentivado".
Existem duas maneiras de integrar anúncios com recompensa: recompensas no aplicativo (recomendadas e descritas abaixo) ou retornos de callback de servidor para servidor (consulte o artigo de perguntas frequentes sobre este tópico). Com recompensas no aplicativo, quando um usuário conclui com sucesso uma exibição de anúncio ou clica no botão de download, você pode recompensá-lo diretamente no seu aplicativo. O principal benefício dessa abordagem é que é simples de implementar. Se você está procurando algo rápido e não está preocupado com ataques de repetição, isso deve servir.
Agora o Vungle oferece diversos formatos de anúncio com os Modelos dinâmicos (Dynamic Template ads). Diferentemente do formato de anúncio tradicional, no qual a reprodução consiste em reproduzir um vídeo e depois um cartão final, oferecemos modelos com o botão de chamada para ação (CTA) já disponível durante a reprodução do vídeo. Os usuários que assistem todo o anúncio e os que clicam no botão devem ser recompensados.
Etapa 1. Integração Completa do Plug-in Básico
Para integrar anúncios intersticiais e premiados em seu aplicativo do Unity, comece seguindo as instruções do artigo sobre integração básica de pug-in . 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;
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 umplacementID
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 e reproduzir um anúncio
Carregar um anúncio para um posicionamento
Em todos os posicionamentos, chame o método loadAd()
para carregar um anúncio.
public static void loadAd(string placementID)
Certifique-se de que você esteja usando o placementID
vinculado à plataforma correta.
Código de exemplo:
string placementID;
#if UNITY_IPHONE
placementID = "ios_placement_id";
#elif UNITY_ANDROID
placementID = "android_placement_id";
#elif UNITY_WSA_10_0 || UNITY_WINRT_8_1 || UNITY_METRO
placementID = "windows_placement_id";
#endif
Vungle.loadAd(placementID);
Verificar a disponibilidade do anúncio para um posicionamento
Uma vez que o SDK finalize o armazenamento em cache de um anúncio para um posicionamento, o seguinte evento é chamado:
public static event Action<string, bool> adPlayableEvent;
Código de exemplo:
Vungle.adPlayableEvent += (placementID, adPlayable) => {
if(placementID == "ios_placement_id") {
playButtonPlacement1.enabled = adPlayable;
}
};
Observação: Nos posicionamentos otimizados em cache, este evento é chamado apenas quando um anúncio se torna disponível. Os posicionamentos otimizados tentam preencher automaticamente sem ação adicional. Para todos os outros posicionamentos, este evento também é chamado no caso de “Falha de carregamento” (adPlayable
retorna false
neste caso).
Você também pode verificar a disponibilidade de anúncio para um posicionamento com o seguinte método:
public static bool isAdvertAvailable(string placementID);
Reproduzir um anúncio
Importante: Não reproduza um anúncio até que a função adPlayableEvent
descrita acima retorne “true”. Se tentar reproduzir um anúncio antes de que a função adPlayableEvent
retorne “true”, a experiência do usuário será prejudicada enquanto o anúncio tenta ser carregado. Se a implantação estiver sendo feita no Android, use o valor retornado de isAdvertAvailable()
para garantir que o anúncio esteja disponível (visto que o adPlayableEvent
não retornará “false” quando não houver nenhum anúncio disponível).
Quando um anúncio está pronto para um posicionamento, você pode reproduzir o anúncio com o seguinte método:
public static void playAd(string placementID);
Código de exemplo:
Vungle.playAd(placementID);