Antes de começar
Requisitos
O plug-in Vungle Unity é compatível com o editor Unity versão 2017 e superior e contém as seguintes versões do Vungle SDK.
iOS SDK v6.8.0
- iOS 9 ou superior
Android SDK v6.8.0
- Android 4.0 (Ice Cream Sandwich - API versão 14 ou superior)
- Amazon OS 5.4 e superior
- Requer Java 1.7 ou superior para Android
Windows SDK v6.8.0
- Windows 10 UWP e Universal 8.1
Baixar o plug-in
Baixe o plug-in Vungle para Unity aqui:https://publisher.vungle.com/sdk/plugins/unity
Referência: aplicativo de amostra
Consulte o aplicativo de exemplo que fornecemos ao fazer a integração: https://github.com/Vungle/Unity-Plugin
Etapa 1. Configurar o projeto Unity com o plug-in Vungle Unity
Adicione o plug-in Vungle Unity ao seu projeto Unity
Com seu projeto aberto em Unity, dê um duplo clique no arquivo VunglePlugin.unitypackage baixado e adicione o plug-in Vungle Unity ao seu aplicativo. Quando a janela Importação do pacote Unity abrir, clique em Todos para selecionar tudo antes da importação.
Direcione para a plataforma correta em suas definições de build
Para evitar erros de compilação durante a próxima etapa, certifique-se de que as configurações de Compilação do seu projeto (cmd + Shift + B) visam a plataforma iOS, Android ou Universal Windows.
Amazon Appstore
O Vungle SDK para Android é compatível com Amazon OS 5.4 e superior. Você pode enviar o Android APK à Amazon Appstore, com a configuração adicional da Unity Amazon Appstore. Consulte as instruções do Unity.
Google Play Services
Ao incluir o Google Play Services no seu projeto, você permite que o Vungle ofereça ao usuário final uma experiência mais personalizada em relação aos anúncios, mas isso não é obrigatório. Recomendamos o uso da versão 16.0.0 ou superior.
Para incluir o Google Play Services, recomendamos o Guia de configuração do Google no portal do desenvolvedor. No seu aplicativo, verifique se o dispositivo tem uma versão suficientemente atualizada do Google Play Services.
Dependências do Android
O Vungle SDK para Android exige que você inclua uma das seguintes dependências na compilação. Adicione-as manualmente ou inclua-as em um modelo do Gradle, caso use o Gradle.
implementation 'androidx.appcompat:appcompat:1.2.0'
// When appcompat is not used, core and localbroadcastmanager can be used instead
// implementation "androidx.core:core:1.3.1"
// implementation "androidx.localbroadcastmanager:localbroadcastmanager:1.0.0"Adicionar hardwareAccelerated para Android (Unity 2018.1 e inferior)
hardwareAccelerated é necessário para que o Vungle SDK exiba anúncios MREC de maneira adequada. O Unity força essa propriedade a ser false, mesmo se estiver definida como true em AndroidManifest.xml, dentro do projeto do Unity. O plug-in Vungle irá configurá-lo para true usando o script de pós-processador Gradle, que está disponível para 2018.2 e superior. Para editores usando 2018.1 e inferior, incluindo 2017, será necessário exportar o projeto para o Android Studio e adicionar a configuração hardwareAccelerated com um valor de true.
Código de exemplo:
<application android:hardwareAccelerated="true" ...>Configuração de projeto da plataforma universal do Windows
Siga as instruções em nosso artigo Preparando o plug-in Vungle Unity para o SDK do Windows e configure um projeto UWP.
Etapa 2: adicionar código
Nesta apresentação, inicializamos todo o código relacionado com Vungle em um script anexado ao Objeto do jogo principal. Você pode chamar o plug-in Vungle Unity de quaisquer scripts que julgue apropriado.
Inicializar o SDK
Inicialize o SDK assim que o aplicativo for iniciado a fim de que o SDK tenha tempo suficiente para colocar em cache um anúncio. Para inicializar o SDK, você precisará dos IDs do aplicativo das plataformas as quais deseja oferecer suporte. Você pode encontrar estes IDs no painel do Vungle (consulte “Configuração e relatório sobre posicionamentos”).
Um posicionamento padrão é automaticamente criado para cada aplicativo. Você deve fornecer o ID de posicionamento nesta etapa de inicialização, independentemente se planeja ou não aproveitar a funcionalidade de posicionamentos. Se criar vários posicionamentos, forneça todos os IDs de posicionamento.
Código de exemplo:
public class VungleScript : MonoBehaviour {
string appID = "";
string iosAppID = "ios_app_id";
string androidAppID = "android_app_id";
string windowsAppID = "windows_app_id";
#if UNITY_IPHONE
appID = iosAppID;
#elif UNITY_ANDROID
appID = androidAppID;
#elif UNITY_WSA_10_0 || UNITY_WINRT_8_1 || UNITY_METRO
appID = windowsAppID;
#endif
Vungle.init(appID);
}Quando o SDK for inicializado com sucesso, ele chama o seguinte evento:
public static event Action onInitializeEvent;Consulte a seção de manipulação de eventos de um artigo de formato de anúncio de sua escolha.
Entre em contato com o gerente da conta sobre os posicionamentos otimizados em cache para maximizar o desempenho do cache.
Depois que um anúncio é armazenado em cache com sucesso, o evento adPlayableEvent é chamado com o ID de referência de veiculação correspondente à sua veiculação. Consulte o artigo sobre formato de anúncio de sua escolha para obter mais detalhes.
Integrar formatos de anúncio
Conclua sua integração de plug-in para cada formato de anúncio que você planeja exibir em seu aplicativo. Consulte nossas instruções para cada formato de anúncio:
Personalizar ainda mais seus anúncios
Siga as instruções em nosso artigo Configurações avançadas para ajustar a integração do seu aplicativo com opções de configuração adicionais, como a RGPD, implementação da CCPA e muitas outras configurações.