Integrar 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 de publicidade usando a mediação, que abrange integrações em hierarquia. Ele aborda como adicionar Nend à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do Nend a um appAndroid .

A interface do painel do nend usa texto em japonês para rótulos, botões e descrições, e as capturas de tela exibidas abaixo não foram traduzidas. Neste guia, os rótulos e botões são mencionados pelos equivalentes em inglês. "URL 東キーム", por exemplo, é "Esquema de URL" e assim por diante.

Integrações e formatos de anúncio compatíveis

O AdMob adaptador de mediação para Nend tem os seguintes recursos:

Integração
Lances
Cachoeira
Formatos
Banner
Intersticial
Premiado
Nativo

Requisitos

• API do Android de nível 19 ou mais recente

• SDK dos anúncios para dispositivos móveis do Google mais recente

• Concluir o guia de iniciação de mediação

Etapa 1: configurar o Nend

Inscreva-se ou faça login na sua conta do Nend.

Para adicionar seu aplicativo ao painel do Nend, primeiro clique na guia Placement Management e, em seguida, selecione Site/App (Site/app). Clique no botão Add an app para adicionar seu app ao conjunto.

Criar um aplicativo

Insira o nome do aplicativo e escolha Android aplicativo como o tipo de aplicativo. Insira o URL e verifique se o app está no Google Play (consulte as perguntas frequentes sobre os apps inéditos, caso seu app ainda não tenha sido lançado). Selecione uma categoria para o app e clique em Criar quando terminar.

Seu aplicativo vai ser exibido no painel depois de criado.

Criar uma veiculação

Depois que o aplicativo for registrado, você poderá prosseguir para a criação de um canal. Para criar uma posição para anúncios de banner, acesse a guia Gerenciamento de posições e clique em Posição. Em seguida, clique no botão Criar uma nova posição.

Selecione seu app no menu suspenso. Depois, siga as instruções abaixo que correspondem ao seu formato de anúncio preferido.

Banner

Escolha Imagem estática para o Tipo de anúncio e Banner para o Tipo de inventário. Depois disso, insira um nome de posição, preencha a Introdução ao inventário, escolha um Formato de inventário e, por fim, escolha o Tamanho do inventário desejado. Quando terminar, clique no botão Criar para gerar sua posição.

Observação: o tamanho do banner escolhido aqui precisa corresponder ao tamanho solicitado pelo app.

Intersticial

Escolha Imagem estática para o Tipo de anúncio e Intersticial para o Tipo de inventário. Depois, insira o Nome da posição, preencha a Introdução ao inventário e selecione a Frequência de exibição de anúncios desejada na lista suspensa. Quando terminar, clique no botão Criar para gerar 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, insira o nome da posição, preencha a Introdução ao inventário e escolha uma Categoria adequada na lista suspensa. Quando terminar, clique no botão Criar para gerar sua posição.

Premiado

Escolha Vídeo para o Tipo de anúncio e Recompensa para o Tipo de inventário. Depois, 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 o Conteúdo do prêmio desejado na lista suspensa e insira o Nome da moeda virtual de sua preferência. Quando terminar, clique no botão Criar para gerar sua posição.

Nativo

Escolha Imagem estática para o Tipo de anúncio e Nativo para o Tipo de inventário. Depois, insira um Nome de posição, preencha a Introdução ao inventário e escolha a Seleção de imagem do anúncio desejada. Quando terminar, clique no botão Criar para gerar sua posição.

Observação: recomendamos usar a imagem de publicidade grande horizontal (5: 3) como a Seleção de imagem do anúncio, já que ela inclui os recursos de anúncios nativos que devem ser renderizados.

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, 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 a Orientação do anúncio em vídeo e o Tipo de anúncio nativo na lista. Quando terminar, clique no botão Criar para gerar 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 apiKey e 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 está na guia Ferramentas.

Etapa 2: definir as configurações de mediação para seu AdMob bloco de anúncios

Em seguida, você precisa adicionar a palavra-chave à configuração de mediação do seu bloco de anúncios. Primeiro, faça login na sua conta da AdMob.

Acesse a guia Mediação. Se você quiser modificar um grupo de mediação, clique no nome dele para fazer a edição e prossiga para Adicionar nova geração como origem de anúncios.

Para criar um novo grupo de mediação, selecione Criar grupo de mediação.

Insira o formato e a plataforma do anúncio e clique em Continuar.

Atribua um nome ao seu grupo de mediação e selecione locais para segmentar. Em seguida, defina o status do grupo de mediação como Ativado. Em seguida, clique em Adicionar blocos de anúncios.

Associe esse grupo de mediação a um ou mais dos seus blocos de anúncios atuais da AdMob. Clique em Concluído.

Agora você verá o card de blocos de anúncios preenchido com os blocos selecionados, conforme mostrado abaixo:

Adicionar Nend como uma origem de anúncios

No card Origens de anúncios, selecione Adicionar rede de anúncios.

Selecione nend e ative a chave Optimize. Insira sua chave de API para coleta de dados recebida do Nend anteriormente como a Chave da API Reporting para configurar a otimização da origem de anúncios para o Nend. Em seguida, insira um valor de eCPM para o Nend e clique em Continuar.

Observação :basta configurar a otimização da origem de anúncios uma vez por rede.

Se você já tem um mapeamento para nend, basta selecioná-lo. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira um Nome de mapeamento, o ID do Spot e a Chave de API obtidos na seção anterior. Clique em Concluído.

Observação :a otimização da origem de anúncios leva alguns dias para coletar dados e calcular com precisão o eCPM de uma rede de mediação. Enquanto isso, o status de otimização da origem de anúncios vai ser "PENDENTE". Portanto, você precisa definir manualmente um valor de eCPM para a rede. Depois que o eCPM for calculado, a otimização da origem de anúncios começará a atualizar automaticamente o eCPM em seu nome.

Etapa 3: importar o SDK e o adaptador do Nend

Integração com o Android Studio (recomendada)

Adicione o seguinte repositório Maven do Nend e as dependências de implementação com a versão mais recente do SDK e do adaptador do Nend no arquivo build.gradle no nível do app:

repositories {
    google()
    mavenCentral()
    maven {
        url 'https://fan-adn.github.io/nendSDK-Android-lib/library'
    }
}

...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:22.4.0'
    implementation 'com.google.ads.mediation:nend:9.0.1.0'
}
...

Integração manual

1. Faça o download da versão mais recente do SDK do Android Nend e adicione-a ao seu projeto.

2. Navegue até os artefatos do adaptador do Nend no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo .aar do adaptador Nend e adicione-o ao projeto.

Etapa 4: código extra necessário

Nenhum código adicional é necessário para a integração de Nend.

Etapa 5: testar a implementação

Para testar anúncios de banner, intersticiais e premiados, a Nend recomenda o uso das chaves de API e dos IDs de Spot fornecidos na página nender blocos de anúncios de teste . Eles podem ser inseridos como as chaves de API e os IDs de Spot dos blocos de anúncios da AdMob durante o teste. Depois, eles podem ser substituídos por uma chave de API e um ID do Spot reais quando o app estiver pronto para produção.

Etapas opcionais

Parâmetros específicos da rede

O adaptador Nend é compatível com outros parâmetros de solicitação para anúncios intersticiais, que podem ser transmitidos ao adaptador usando a classe NendExtrasBundleBuilder. Essa classe inclui os seguintes métodos:

• setUserId(String): define o UserID de um anúncio intersticial de geração específico.
• setInterstitialType(InterstitialType): o Nend oferece a opção de selecionar TYPE_NORMAL para anúncios intersticiais regulares ou TYPE_VIDEO para anúncios intersticiais em vídeo.

• setNativeAdsType(nativeAdsType): o Nend oferece a opção de selecionar TYPE_NORMAL para anúncios nativos normais ou TYPE_VIDEO para anúncios em vídeo nativos.

Java

Bundle bundle = new NendAdapter.NendExtrasBundleBuilder()
                        .setUserId("userId")
                        .setInterstitialType(InterstitialType.TYPE_NORMAL)
                        .setNativeAdsType(FormatType.TYPE_NORMAL)
                        .build();

AdRequest adRequest = new AdRequest.Builder().addNetworkExtrasBundle(
  NendAdapter.class, bundle).build();

adLoader.loadAd(adRequest);

Kotlin

val bundle = NendAdapter.NendExtrasBundleBuilder()
                     .setUserId("userId")
                     .setInterstitialType(InterstitialType.TYPE_NORMAL)
                     .setNativeAdsType(FormatType.TYPE_NORMAL)
                     .build()

val adRequest = AdRequest.Builder().addNetworkExtrasBundle(
  NendAdapter.class, bundle).build()

adLoader.loadAd(adRequest)

Como usar anúncios nativos

Renderização do anúncio

O adaptador Nend retorna os anúncios nativos como objetos NativeAd . Ele preenche os seguintes descrições de campos de anúncios nativos para um NativeAd.

Campo	Preenchido pelo adaptador Nend
Título
Imagem	1
Body
Ícone do app	2
Call-to-action
Nome do anunciante
Star rating
Armazenar
Preço

¹ O Nend oferece apenas um recurso de imagem para posições nativas configuradas com uma Seleção de imagem do anúncio definida como Imagem de publicidade grande horizontal (5: 3).

² O Nend não fornece um recurso de ícone para posições nativas configuradas com uma Seleção de imagem do anúncio definida como Sem imagem (somente texto).

Códigos de erro

Se o adaptador não receber um anúncio do Nend, os editores podem verificar o erro subjacente da resposta do anúncio usando ResponseInfo.getAdapterResponse() nas seguintes classes:

Formato	Nome da classe
Banner	com.google.ads.Mediation.nend.NendAdapter
Intersticial	com.google.ads.Mediation.nend.NendAdapter
Premiado	com.google.ads.Mediation.nend.NendRewardedAdapter
Nativo	com.google.ads.mediação.nend.NendMediationAdapter

Veja os códigos e as mensagens complementares geradas pelo adaptador Nend quando um anúncio não é carregado:

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 back-end configurados na interface do AdMob estão ausentes/inválidos.
103	com.google.ads.Mediation.nend	anúncio novo ainda não está pronto para ser exibido.
104	com.google.ads.Mediation.nend	não conseguiu reproduzir o anúncio.
105	com.google.ads.Mediation.nend	O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível.
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	Nend retornou um erro de carregamento do anúncio intersticial. Consulte 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. Consulte o código para mais detalhes.
400-499	net.nend.android	Nend retornou um erro de anúncio. Consulte o código para mais detalhes.
101	com.google.media.nend	nend retornou um callback de falha de carregamento sem informações adicionais sobre o erro.
102	com.google.media.nend	O SDK do Nend retornou um callback de falha de exibição sem informações adicionais sobre o erro.
103	com.google.media.nend	Os parâmetros do servidor do back-end configurados na interface do AdMob estão ausentes/inválidos.
104	com.google.media.nend	Falha ao carregar os recursos de imagem dos anúncios nativos.
105	com.google.media.nend	Falha ao mostrar anúncios novos porque eles não estão prontos.
106	com.google.media.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 retornou um erro. Consulte o documento da Nend para mais detalhes.

Gerar registro de alterações do adaptador de mediação do Android

Próxima versão

• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 22.4.0.

Versão 9.0.1.0

• O adaptador foi atualizado para usar a nova classe VersionInfo.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 22.0.0.
• Foi verificada compatibilidade com o SDK Nend 9.0.1.

Criado e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
• SDK do Nend versão 9.0.1.

Versão 9.0.0.0

• Foi verificada compatibilidade com o SDK Nend 9.0.0.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 21.2.0.

Criado e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 21.2.0.
• SDK do Nend versão 9.0.0

Versão 8.2.0.0

• Foi verificada compatibilidade com o SDK Nend 8.2.0.

Criado e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
• SDK do Nend versão 8.2.0.

Versão 8.1.0.1

• compileSdkVersion e targetSdkVersion foram atualizados para o nível 31 da API
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 21.0.0.

Criado e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
• SDK do Nend versão 8.1.0.

Versão 8.1.0.0

• Foi verificada compatibilidade com o SDK Nend 8.1.0.
• Correção de uma falha de NullPointerException quando o Nend retorna um URL de logotipo ou imagem do anúncio null
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.5.0.

Criado e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 20.5.0.
• SDK do Nend versão 8.1.0.

Versão 8.0.1.0

• Foi verificada compatibilidade com o SDK Nend 8.0.1.
• Correção de um bug em que alguns objetos AdError eram retornados usando o domínio incorreto.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 20.4.0.

Criado e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 20.4.0.
• SDK do Nend versão 8.0.1.

Versão 7.1.0.0

• Foi verificada compatibilidade com o SDK Nend 7.1.0.
• Os códigos de erro foram atualizados para capturar o erro de Nend UNSUPPORTED_DEVICE.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 20.2.0.

Criado e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 20.2.0.
• SDK do Nend versão 7.1.0.

Versão 7.0.3.0

• Foi verificada compatibilidade com o SDK Nend 7.0.3.
• Foram adicionados códigos de erro descritivos e motivos para falhas no carregamento/exibição do adaptador.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 20.0.0.

Criado e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 20.0.0.
• SDK do Nend versão 7.0.3.

Versão 7.0.0.0

• Foi verificada compatibilidade com o SDK Nend 7.0.0.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.4.0.

Criado e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 19.4.0.
• SDK do Nend versão 7.0.0.

Versão 6.0.1.0

• Foi verificada compatibilidade com o SDK Nend 6.0.1.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.3.0.

Criado e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 19.3.0.
• SDK do Nend versão 6.0.1.

Versão 6.0.0.0

• Foi verificada compatibilidade com o SDK Nend 6.0.0.
• A versão mínima do SDK do Android foi atualizada para a API 19.

Criado e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 19.2.0.
• SDK do Nend versão 6.0.0.

Versão 5.4.2.1

• O adaptador foi atualizado para oferecer suporte a solicitações de banner adaptativo inline.
• Correção de uma falha rara de disputa que pode acontecer quando anúncios de banner inteligente são destruídos.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.2.0.

Criado e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 19.2.0.
• SDK do Nend versão 5.4.2.

Versão 5.4.2.0

• Agora é possível usar anúncios nativos.
• Foi verificada compatibilidade com o SDK Nend 5.4.2.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 19.0.0.

Criado e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 19.0.0.
• SDK do Nend versão 5.4.2.

Versão 5.3.0.0

• Foi verificada compatibilidade com o SDK Nend 5.3.0.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 18.2.0.

Criado e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 18.2.0.
• SDK do Nend versão 5.3.0.

Versão 5.2.0.0

• Foi verificada compatibilidade com o SDK Nend 5.2.0.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 18.1.1.

Versão 5.1.0.4

• Correção de um problema em que anúncios intersticiais e de banner não encaminhavam o evento onAdClicked().
• Foi corrigido um problema em que uma NullPointerException era gerada quando um anúncio de banner Nend era destruído.
• Migração do adaptador para o AndroidX.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 18.0.0.

Versão 5.1.0.3

• Adição de implementação para exibir uma parte do banner Nend no SmartBanner Tamanho adequado para o SmartBanner
  • Retrato e paisagem
    • Smartphones: 320×50
    • Tablets: 728 × 90 ou 320 × 50

Versão 5.1.0.2

• Agora é possível usar tamanhos de anúncio de banner flexíveis.

Versão 5.1.0.1

• O adaptador foi atualizado para oferecer suporte à nova API Premiada em versão Beta aberta.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 17.2.0.

Versão 5.1.0.0

• Foi verificada compatibilidade com o SDK Nend 5.1.0.

Versão 5.0.2.1

• Remoção da função que encaminha recursos do usuário porque os métodos abaixo foram descontinuados no AdRequest.Builder.
  • setGender()
  • setBirthday()
  • setIsDesignedForFamiles()

Versão 5.0.2.0

• Foi verificada compatibilidade com o SDK Nend 5.0.2.

Versão 5.0.1.0

• Foi verificada compatibilidade com o SDK Nend 5.0.1.

Versão 5.0.0.0

• Foi verificada compatibilidade com o SDK Nend 5.0.0.

Versão 4.0.5.0

• Foi verificada compatibilidade com o SDK Nend 4.0.5.

Versão 4.0.4.1

• Compatível com o método onRewardedVideoConcluído() de RewardedVideoAdListener.

Versão 4.0.4.0

• Foi verificada compatibilidade com o SDK Nend 4.0.4.

Versão 4.0.2.1

• Foi adicionada a capacidade de criar um Bundle de extras de mediação usando a classe NendExtrasBundleBuilder.

Versão 4.0.2.0

• Primeira versão no projeto de código aberto da Mediação de anúncios para dispositivos móveis do Google.
• Agora é possível usar anúncios em vídeo premiados, intersticiais e de banner.