Integração do plugin Mobile Ads Unity
Sistema: YAN e Adfox
Mobile Ads Unity é um plugin para a plataforma de jogos Unity3d compatível com o Yandex Mobile Ads SDK.
Configuração preliminar
Para preparar seu aplicativo, siga os passos nas próximas seções.
Requisitos do aplicativo
- Para executar o SDK, você precisa de um nível desejado da API versão 31 ou superior.
- Para carregar anúncios de qualquer tipo, você precisa do iOS 15 ou posterior.
- Use Xcode 16.4 ou superior.
Configure o aplicativo na sua conta da Yandex Advertising Network
Registre seu aplicativo como app Yandex Advertising Network seguindo estes passos:
- Faça login na sua conta ou cadastre-se para Yandex Advertising Network.
- Registre seu aplicativo na Yandex Advertising Network.
Configure seu aplicativo
-
Baixe o diretório yandex-ads-unity-plugin e adicione o pacote
yandex-mobileads-lite-8.5.0.unitypackage. Será solicitado que você instale o resolvedor do Google com ele. Se o resolvedor do Google já tiver sido adicionado ao projeto, desmarque a caixa de seleção.Selecione um plugin (Assets → Import Package → Custom Package), depois clique em Import.
-
Use o resolvedor do Google para definir dependências: ative a resolução automática ou selecione Assets → External Dependency Manager → Android Resolver → Resolve no menu.
-
Para corrigir isso, ative modelos personalizados para o projeto que você está gerando. Acesse Build Settings → Player Settings → Publishing Settings → Build e ative Custom Main Gradle Template.
Recomendamos que você sempre use Custom Main Gradle Template e Custom Gradle Properties Template ao criar um aplicativo Unity para evitar outros erros potenciais.
-
Para testar o plugin Mobile Ads Unity, use um script de exemplo do diretório samples no repositório yandex-ads-unity-plugin. Copie o script para o diretório do projeto e adicione-o como um Component à câmera principal.
Configuração específica por plataforma
Redução do nível desejado da API
Para reduzir o nível desejado da API para 30, adicione a redução explícita para mainTemplate.gradle e launcherTemplate.gradle (se você usar launcherTemplate no projeto):
configurations.all {
resolutionStrategy {
force 'androidx.core:core:1.6.0'
force 'androidx.core:core-ktx:1.6.0'
}
}
No entanto, recomendamos que você atualize para o nível desejado da API 31, pois o Google tem restrições para liberar atualizações para aplicativos que utilizam uma versão desatualizada do nível desejado da API. Saiba mais neste artigo.
Suporte ao SKAdNetwork
Adicione os identificadores das redes de anúncios ao arquivo Info.plist do seu aplicativo. Para mais informações, consulte SKAdNetwork.
Teste da integração do SDK
Você pode verificar o sucesso da integração da biblioteca usando a ferramenta de teste de integração embutida no SDK.
Para isso, após adicionar a dependência e inicializar o SDK, recompile o projeto.
Inicie o Logcat e procure a palavra-chave "Yandex Ads".
O comando produz os logs de status da integração. Você verá uma mensagem indicando se a integração foi ou não bem-sucedida. Se houver algum problema, você verá uma descrição detalhada, ao lado de providências para resolvê-lo. Saída do exemplo de comando:
mobileads$ adb logcat | grep 'Yandex Ads' -i
[Yandex Ads] I Yandex Mobile Ads 8.5.0 integrated successfully
[Yandex Ads] I Yandex Mobile Ads 8.5.0 initialized successfully
O log mostra dois eventos distintos:
integrated successfully: verificação da integração (o SDK ainda não foi inicializado).initialized successfully: inicialização do SDK com sucesso.
Você pode verificar os logs para garantir que sua integração do SDK está correta.
Para ver os logs, acesse a ferramenta Console e defina Subsystem = com.mobile.ads.ads.sdk. Você pode filtrar os logs por categoria, deixando apenas aqueles relacionados à integração do SDK de anúncios. Defina Category = Integration. Salve a consulta e selecione-a na linha de filtro sempre que precisar fazer uma depuração.
Você verá mensagens sobre a integração bem-sucedida: ativação do YandexMobileAdsBundle.bundle, inicialização do SDK e conexão do SKAdNetwork e dos adaptadores de mediação móvel (se você os utilizar em seu projeto).
Se houver algum problema durante a integração do SDK, você verá um relatório detalhado do problema.
Próximos passos
Você integrou o Mobile Ads Unity Plugin com êxito. Portanto, você já pode implementar formatos de anúncios.
Escolha o tipo de anúncio mais adequado para seu aplicativo:
|
Formato de anúncio |
YAN |
Adfox |
Descrição |
|
|
|
Um banner adaptativo inline é um formato flexível de anúncio em banner que otimiza o tamanho do anúncio em cada dispositivo, garantindo máxima eficiência. A altura do banner é ajustada automaticamente e pode alcançar a altura da tela do dispositivo. Normalmente, esse formato é usado em aplicativos baseados em feed ou contextos em que é aceitável focar principalmente no anúncio. |
|
|
|
|
Um banner adaptativo fixo é um anúncio pequeno, atualizado automaticamente, situado na parte de baixo ou no alto da tela do aplicativo. Ele não sobrepõe o conteúdo principal do aplicativo e costuma ser usado em aplicativos de jogos. A altura de um banner fixo é determinada automaticamente, adaptando-se ao tamanho da tela do dispositivo e não ocupando mais de 15% da altura da tela. |
|
|
|
|
A publicidade intersticial é um formato de anúncio em tela cheia incorporado ao conteúdo do aplicativo durante pausas naturais, como a transição entre níveis de jogo ou a conclusão de uma ação-alvo. Ao renderizar anúncios intersticiais, a atenção do usuário está totalmente focada nos seus anúncios, por isso o custo por impressão é maior. Se você usar esse formato com muita frequência, a interação do usuário pode ser afetada. |
|
|
|
|
Anúncios com recompensa são um formato de anúncio em tela cheia de grande popularidade, no qual os usuários recebem incentivos para assistir aos anúncios. As impressões dos anúncios são opcionais: os usuários podem iniciá-las, por exemplo, para receber um bônus ou vidas extras em um jogo. A forte motivação para os usuários faz com que esse formato de anúncio seja o mais popular e lucrativo em aplicativos gratuitos. |
|
|
|
|
Os anúncios de abertura de aplicativos são um formato de anúncio especial para monetizar as telas de carregamento do seu app. Esses anúncios podem ser fechados a qualquer momento e foram criados para serem veiculados:
|
