Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios usando a mediação, que abrange integrações em hierarquia. Ele aborda como adicionar a referência à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do Nend a um app Unity.
A interface do painel do Nend usa texto em japonês para os rótulos, botões e descrições. As capturas de tela abaixo não foram traduzidas. No texto deste guia, no entanto, os rótulos e botões são referenciados pelos nomes em inglês. "URL キーム", por exemplo, é "Esquema de URL" e assim por diante.
Integrações e formatos de anúncio compatíveis
Integração | |
---|---|
Lances | |
Cascata | |
Formatos | |
Banner | |
Intersticial | |
Premiado |
Requisitos
- Unity 4 ou mais recente
- SDK dos anúncios para dispositivos móveis do Google mais recente
- Para implantar no Android
- Android API de nível 19 ou mais recente
- Para implantar no iOS:
- Meta de implantação do iOS 12.0 ou mais recente
- Um projeto do Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Concluir o Guia explicativo sobre mediação
Etapa 1: definir as configurações na interface do usuário
Inscreva-se ou faça login em sua conta do Nend.
Para adicionar seu aplicativo ao painel do Nend, primeiro clique na guia Gerenciamento de canais e, em seguida, selecione Site/Aplicativo. Clique no botão Adicionar um aplicativo para incluir seu aplicativo.
Criar um aplicativo
Digite o nome do aplicativo e escolha a plataforma dele como o tipo de aplicativo. Insira o URL e verifique se o app está disponível na app store apropriada
Consulte as Perguntas frequentes sobre apps inéditos do Nend se o seu app ainda não tiver sido lançado. Selecione uma categoria para o app e clique em Criar quando terminar.
Android
iOS
Seu aplicativo será exibido no painel assim que for criado.
Android
iOS
Criar uma veiculação
Depois que o aplicativo for registrado, você poderá criar uma posição. Para criar um posicionamento para anúncios de banner, acesse a guia Gerenciamento de canais e clique em Posição. Em seguida, clique no botão Criar um novo canal.
Selecione seu app no menu suspenso. Então, siga as instruções abaixo que correspondem a seu formato de anúncio preferido.
Banner
Escolha Imagem estática como o Tipo de anúncio e Banner como o Tipo de inventário. Depois disso, insira o Nome da posição, preencha a Introdução ao inventário, escolha um Formato de inventário e, por fim, escolha um Tamanho de inventário. Ao terminar, clique no botão Criar para criar sua posição.
Intersticial
Escolha Imagem estática para o Tipo de anúncio e Intersticial para o Tipo de inventário. Depois disso, insira o Nome da posição, preencha a Introdução ao inventário e selecione uma Frequência de exibição de anúncios na lista suspensa. Ao terminar, clique no botão Criar para criar sua posição.
Para anúncios intersticiais em vídeo, escolha Vídeo para o Tipo de anúncio e Intersticial para o Tipo de inventário. Depois disso, insira o Nome da posição, preencha a Introdução ao inventário e escolha uma Categoria adequada na lista suspensa. Ao terminar, clique no botão Criar para criar sua posição.
Premiado
Escolha Vídeo como o Tipo de anúncio e Prêmio como o Tipo de inventário. Depois disso, insira o Nome da posição, preencha a Introdução ao inventário e escolha uma Categoria adequada na lista suspensa.
Em Configurações do prêmio, selecione um Conteúdo do prêmio na lista suspensa e insira o Nome da moeda virtual que você preferir. Ao terminar, clique no botão Criar para criar sua posição.
Nativo
Escolha Imagem estática em Tipo de anúncio e Nativo em Tipo de inventário. Depois, insira o Nome da posição, preencha a Introdução ao inventário e selecione uma Seleção de imagem do anúncio. Ao terminar, clique no botão Criar para criar sua posição.
Para anúncios em vídeo nativos, escolha Vídeo para o Tipo de anúncio e Nativo (personalizado) para o Tipo de inventário. Depois disso, insira o Nome da posição, preencha a Introdução ao inventário e escolha uma Categoria adequada na lista suspensa.
Em Configurações nativas, selecione uma Orientação do anúncio em vídeo e Tipo de anúncio nativo na lista. Ao terminar, clique no botão Criar para criar sua posição.
Para configurar seu bloco de anúncios AdMob na próxima seção, você precisará da apiKey e do spotID de cada posição. Para localizá-los, acesse a guia Gerenciamento de posições e selecione o botão SDK abaixo do nome do app.
Anote a apiKey e o spotID.
Você também precisará da sua chave de API para a API de relatórios do Nend, que é chamada de chave de API para cópia. Ele fica na guia Ferramentas.
Etapa 2: configurar a demanda de AdMob na interface
Definir as configurações de mediação para seu bloco de anúncios
Android
Para conferir instruções, consulte a etapa 2 no guia para Android.
iOS
Para instruções, consulte a etapa 2 no guia para iOS.
Etapa 3: importar o SDK e o adaptador do Nend
Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para nend
no link de download no Registro de mudanças
e extraia o pacote GoogleMobileAdsNendMediation.unitypackage
do
arquivo zip
.
No editor de projetos do Unity, selecione Assets > Import Package > Custom
Package e encontre o arquivo GoogleMobileAdsNendMediation.unitypackage
que você
fez o download. Verifique se todos os arquivos estão selecionados e clique em Import.
Em seguida, selecione Assets > Play Services Resolver > Android Resolver >
Force Resolve. A biblioteca do resolvedor do Play Services do Unity vai realizar
a resolução de dependência do zero e copiar as dependências declaradas para o
diretório Assets/Plugins/Android
do seu app Unity.
Etapa 4: adicionar o código necessário
Android
Nenhum código adicional é necessário para a integração do Nend.
iOS
Integração da SKAdNetwork
Siga a documentação
do Nend (em inglês)
para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist
do projeto.
Etapa 5: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste em AdMob Para testar anúncios de banner, intersticiais e premiados, a Nend recomenda usar as chaves de API e os IDs de Spot fornecidos na página nendendo blocos de anúncios de teste . Eles podem ser inseridos como chaves de API e IDs de Spot para seus blocos de anúncios da AdMob durante o teste e, em seguida, substituídos por uma chave de API e um ID do Spot reais quando o app estiver pronto para produção.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do nend, ative os testes de uma única origem no Ad Inspector usando as nend (Waterfall) origens de anúncios.
Códigos de erro
Se o adaptador não receber um anúncio do Nend, os editores poderão verificar o
erro subjacente da resposta do anúncio usando
ResponseInfo
nas
seguintes classes:
Android
com.google.ads.mediation.nend.NendAdapter
com.google.ads.mediation.nend.NendRewardedAdapter
com.google.ads.mediation.nend.NendMediationAdapter
iOS
GADMAdapterNend
GADMAdapterNend
GADMAdapterNendRewarded
GADMediationAdapterNend
Aqui estão os códigos e as mensagens associadas geradas pelo adaptador Nend quando um anúncio não é carregado:
Android
Código do erro | Domínio | Motivo |
---|---|---|
101 | com.google.ads.mediation.nend | nend requer um contexto de atividade para carregar e mostrar anúncios. |
102 | com.google.ads.mediation.nend | Os parâmetros do servidor do servidor Nend configurados na AdMob interface estão ausentes/inválidos. |
103 | com.google.ads.mediation.nend | nend o anúncio ainda não está pronto para ser exibido. |
104 | com.google.ads.mediation.nend | não foi possível reproduzir o anúncio. |
105 | com.google.ads.mediation.nend | O tamanho de anúncio solicitado não corresponde a um tamanho de banner suportado. |
106 | com.google.ads.mediation.nend | A referência do objeto Context é null e/ou foi liberada recentemente da memória. |
200-299 | net.nend.android | O SDK do Nend retornou um erro de carregamento do anúncio intersticial. Confira o código para mais detalhes. |
300-399 | net.nend.android | O SDK do Nend retornou um erro de exibição de anúncio intersticial. Confira o código para mais detalhes. |
400-499 | net.nend.android | Nend SDK retornou um erro de anúncio. Confira o código para mais detalhes. |
iOS
Código do erro | Domínio | Motivo |
---|---|---|
101 | com.google.mediation.nend | O SDK do Nend retornou um callback de falha de carregamento sem informações adicionais sobre o erro. |
102 | com.google.mediation.nend | O SDK do Nend retornou um callback de falha de exibição sem informações adicionais do erro. |
103 | com.google.mediation.nend | Os parâmetros do servidor do servidor Nend configurados na AdMob interface estão ausentes/inválidos. |
104 | com.google.mediation.nend | Falha ao carregar os recursos de imagem dos anúncios nativos. |
105 | com.google.mediation.nend | Falha ao exibir anúncios porque ele não está pronto. |
106 | com.google.mediation.nend | O tamanho do anúncio de banner solicitado não corresponde a um tamanho de banner compatível. |
200-699 | Enviado pelo SDK do Nend. | Nend SDK retornou um erro. Consulte o documento da revisão para mais detalhes. |
Inserir o registro de alterações do plug-in de mediação do Unity
Versão 8.0.0
- Compatível com o adaptador Android Nend versão 10.0.0.0.
- Compatível com o adaptador iOS Nend versão 8.2.0.0.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.6.0.
Versão 7.0.0
- O conteúdo do adaptador foi movido para
GoogleMobileAds/Mediation/Nend/
. - O namespace do adaptador foi refatorado para usar
GoogleMobileAds.Mediation.Nend
- Oferece suporte ao Adaptador Android Nend versão 9.0.1.0.
- Compatível com o adaptador iOS Nend versão 8.0.1.0.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.1.0.
Versão 6.0.1
- Compatível com o adaptador Android Nend versão 9.0.0.0.
- Compatível com o adaptador iOS Nend versão 7.4.0.1.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.4.1.
Versão 6.0.0
- Compatível com o adaptador Android Nend versão 9.0.0.0.
- Compatível com o adaptador iOS Nend versão 7.4.0.0.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.2.0.
Versão 5.2.0
- Compatível com o adaptador Android Nend versão 8.1.0.1.
- Compatível com o adaptador iOS Nend versão 7.3.0.0.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.2.
Versão 5.1.0
- Compatível com o adaptador Nend para Android versão 8.1.0.0.
- Compatível com o adaptador iOS Nend versão 7.2.0.0.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.0.
Versão 5.0.0
- Oferece suporte ao adaptador Nend para Android versão 8.0.1.0.
- Compatível com o adaptador iOS Nend versão 7.1.0.0.
Versão 4.0.1
- Compatível com o adaptador Android Nend versão 7.0.3.0.
- Compatível com o adaptador iOS Nend versão 7.0.5.0.
Versão 4.0.0
- Compatível com o adaptador Android Nend versão 7.0.0.0.
- Compatível com o adaptador iOS Nend versão 7.0.0.0.
Versão 3.0.0
- Oferece suporte ao adaptador Nend para Android versão 6.0.1.0.
- Compatível com o adaptador iOS Nend versão 6.0.1.0.
Versão 2.3.0
- Compatível com o adaptador Android Nend versão 5.4.2.0.
- Compatível com o adaptador iOS Nend versão 5.4.1.0.
Versão 2.2.0
- Oferece suporte ao adaptador do Android Nend versão 5.3.0.0.
- Compatível com o adaptador iOS Nend versão 5.3.0.0.
Versão 2.1.0
- Atualização do plug-in para oferecer suporte à nova API Premiada.
- Oferece suporte ao adaptador Android Nend versão 5.1.0.2.
- Compatível com o adaptador para iOS do Nend versão 5.1.1.0.
Versão 2.0.3
- Oferece suporte ao adaptador Android Nend versão 5.0.2.1.
- Compatível com o adaptador para iOS do Nend versão 5.0.2.0.
Versão 2.0.2
- Oferece suporte ao adaptador Android Nend versão 5.0.2.0.
- Compatível com o adaptador para iOS do Nend versão 5.0.2.0.
Versão 2.0.1
- Oferece suporte ao adaptador Android Nend versão 5.0.2.0.
- Oferece suporte ao adaptador iOS Nend versão 5.0.1.0.
Versão 2.0.0
- Oferece suporte ao adaptador Android Nend versão 5.0.0.0.
- Compatível com o adaptador para iOS do Nend versão 5.0.0.0.
Versão 1.0.2
- Oferece suporte ao adaptador Android Nend versão 4.0.5.0.
- Compatível com o adaptador para iOS do Nend versão 4.0.6.0.
Versão 1.0.1
- Oferece suporte à versão 4.0.4 do SDK do Android Nend.
- Compatível com o Nend para iOS SDK versão 4.0.4.
Versão 1.0.0
- Primeira versão!
- Oferece suporte à versão 4.0.2 do SDK do Android Nend.
- Compatível com o Nend para iOS SDK versão 4.0.2.