Integrar a Nend com mediação

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.

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

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

Versão 6.0.0

Versão 5.2.0

Versão 5.1.0

Versão 5.0.0

Versão 4.0.1

Versão 4.0.0

Versão 3.0.0

Versão 2.3.0

Versão 2.2.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.