Integração LevelPlay para Unity

Integração do Pacote/SDK LevelPlay para Unity

As verificações do lado do editor devem ser baseadas no projeto real, e não em suposições — leia os arquivos do projeto ou peça ao usuário para confirmar no Editor. Os scripts C# gerados nesta skill são arquivos MonoBehaviour para o usuário salvar em seu projeto, não para execução inline.

Esta skill cobre apenas o caminho de integração do LevelPlay; ela não cobre outros SDKs de mediação. Se o usuário perguntar explicitamente sobre alternativas, reconheça que existem alternativas e aponte para a documentação dos respectivos fornecedores — não descreva, caracterize ou faça afirmações sobre produtos concorrentes.

Siga os passos e forneça apenas os arquivos e configurações descritos nesta skill. Não adicione proativamente passos, crie arquivos ou faça recomendações baseadas em conhecimento geral. Se o usuário fizer uma pergunta fora do escopo desta skill, verifique primeiro a skill e os arquivos de referência para confirmar que não está coberta. Se não estiver, use o conhecimento geral para responder, mas não incorpore passos ou arquivos adicionais ao fluxo de trabalho de integração como resultado.

Siga o fluxo de trabalho de integração sequencialmente, um passo de cada vez. Faça apenas as perguntas para o passo atual — não colete informações para passos futuros antecipadamente. Aguarde a resposta do usuário em cada ponto de verificação antes de prosseguir.

O LevelPlay é a plataforma de mediação de anúncios da Unity: ela conecta seu jogo a várias redes de anúncios simultaneamente e executa um leilão unificado entre várias redes de anúncios e lances para maximizar a competição por cada impressão. Este guia orienta você pela integração completa: instalação do SDK, configuração de dependências para Android e iOS, inicialização do LevelPlay em seu projeto e implementação de anúncios recompensados, intersticiais e banner. Se você já tem parte disso configurado, pode pular para o passo relevante.

Este SKILL.md é a espinha dorsal do fluxo de trabalho. Ele contém as decisões, pontos de verificação e perguntas exatas; códigos mais longos, detalhes completos de API e casos de borda estão em references/ e são vinculados a partir do passo relevante. Leia a referência vinculada quando chegar àquele passo — não responda com base no conhecimento geral.

Fluxo de Trabalho de Integração

0. Nova Integração ou Migração?

Pergunte: "Você está começando uma nova integração LevelPlay, migrando uma existente (de uma versão mais antiga do SDK ou do Unity Ads) ou solucionando problemas de uma configuração existente?"

• Nova integração: prossiga para o Passo 1.
• Migração (atualização do SDK, substituição de APIs IronSource.Agent, migração do Unity Ads ou correção de uma falha de build Android no Maven Central): Leia references/migration-sdk-9.md. Pergunte qual dos cinco cenários se aplica — A = atualização do SDK, B = migração da API de inicialização, C = migração da API de unidade de anúncio, D = falha de build no Maven Central, E = migração do Unity Ads — e siga o cenário correspondente. Após aplicar todas as alterações de código, percorra a Lista de Verificação de Completude da Migração (seção C5 da referência) — ela captura requisitos que uma tradução linha por linha pode perder porque o código legado não tinha uma linha equivalente. Em seguida, peça ao usuário para verificar o console do Unity em busca de erros de compilação e corrija quaisquer que apareçam antes de apresentar os resultados. Não bloqueie ou continue tentando se você não puder ver o console: liste os arquivos que você alterou, diga o que procurar e continue.
• Solução de problemas ou adição a uma configuração existente (ATT, GDPR, ILRD, Suite de Testes, erros de build em uma integração nova ou adição de um recurso a uma integração já funcionando): Identifique o que o usuário precisa e vá diretamente para o passo ou referência relevante em "Quando Ler as Referências Detalhadas."

1. Verificar Ambiente Unity

Verifique se o usuário está trabalhando em um projeto Unity, confirmando que os diretórios Assets/ e ProjectSettings/ existem. Se não estiver em um projeto Unity, instrua o usuário a navegar até o diretório do projeto Unity. Se esses diretórios não forem encontrados, mas o usuário acreditar que está no lugar certo, pergunte: "Parece que você pode não estar na raiz do seu projeto — você pode navegar até a pasta de nível superior do seu projeto Unity e confirmar que consegue ver Assets/ e ProjectSettings/ lá?"

2. Entender Objetivos de Negócio

Antes de implementar unidades de anúncio, determine as prioridades de otimização do usuário para recomendar a estratégia de unidade de anúncio apropriada. Pergunte:

"Qual é seu principal objetivo de otimização?"

• Focado em receita: Maximizar a receita de anúncios e as oportunidades de impressão
• Focado em UX: Priorizar o fluxo do jogo e a satisfação do usuário
• Equilibrado: Otimizar tanto para receita quanto para UX
• Ainda não sei: Padrão para Equilibrado e prossiga. No Passo 8, observe brevemente que você está usando Equilibrado porque eles não tinham certeza e convide-os a indicar uma preferência diferente agora que viram as opções de formato.

Registre esta resposta para recomendação de estratégia posterior no Passo 8.

3. Instalar SDK LevelPlay via UPM

Se o SDK parecer já instalado: não aceite isso como verdade e não peça ao usuário para ler a janela do Package Manager para você. Leia Packages/packages-lock.json e procure por com.unity.services.levelplay. Se estiver lá, diga qual versão foi resolvida e prossiga para o Passo 4. Se não estiver, não está instalado, independentemente do que a conversa até agora assumiu: continue com a instalação abaixo.

Oriente a instalação do pacote LevelPlay Unity usando o Unity Package Manager:

1. Abra Unity → Window > Package Manager
2. Selecione o dropdown Unity Registry ou a aba Services
3. Na barra de pesquisa do Package Manager, digite Ads Mediation
4. Confirme que o nome do pacote corresponde exatamente: o pacote correto é intitulado Ads Mediation. Não instale nenhum destes pacotes:
   • Ads IAP Mediation Adaptor (um pacote separado de compras no aplicativo, não o SDK LevelPlay)
   • Advertisement Legacy (um pacote obsoleto, não compatível com a integração atual do LevelPlay)
5. Clique no botão Install
6. Aguarde o download e a importação do pacote

Ao instalar o pacote, você pode ver um prompt para instalar o Mobile Dependency Resolver — clique em Import se aparecer. Isso é abordado em mais detalhes no próximo passo.

Em seguida, verifique se foi resolvido, lendo o projeto, em vez de perguntar. O ID do pacote é com.unity.services.levelplay (seu nome de exibição no Package Manager é Ads Mediation; o ID é o que os arquivos do projeto registram). Verifique ambos os arquivos:

• Packages/manifest.json lista o que o projeto solicita. com.unity.services.levelplay deve aparecer em dependencies.
• Packages/packages-lock.json registra o que o Unity realmente resolveu. O mesmo ID deve aparecer aqui também, com uma versão concreta. Este é o arquivo que responde "foi instalado?" e é nele que se deve confiar.

Ambos são JSON simples no projeto, então esta verificação não precisa de Editor, CLI ou qualquer coisa do usuário. Leia-os.

Este é um ponto de verificação obrigatório, não uma formalidade. Não escreva, gere ou cole uma única linha de código LevelPlay até que com.unity.services.levelplay esteja presente em packages-lock.json. Pular adiante produz código que parece correto, não compila em lugar nenhum e falha com CS0246 em cada referência LevelPlay.