Integrar a maio com a mediação

Selecione a plataforma: Android (Beta) Android iOS Unity Flutter

Este guia mostra como usar Google Mobile Ads SDK para carregar e exibir anúncios da maio usando a Mediação da AdMob, incluindo integrações em hierarquia. Ele explica como adicionar a maio à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da maio a um app iOS.

A interface do painel do maio usa texto em japonês para rótulos, botões e descrições, e as capturas de tela neste guia não foram traduzidas. No entanto, nas descrições e instruções deste guia, os rótulos e botões são referenciados com seus equivalentes em inglês. "URL スキーム", por exemplo, é "URL Scheme".

Integrações e formatos de anúncio aceitos

O adaptador de mediação da maio tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

Requisitos

• Destino de implantação do iOS 13.0 ou mais recente.

• Última Google Mobile Ads SDK.

• Leia todo o guia para iniciantes da mediação.

Etapa 1: definir as configurações na interface da maio

Primeiro, inscreva-se ou faça login na sua conta do maio. Clique no botão Gerenciamento de aplicativos na barra lateral esquerda e em Novo app.

Selecione a guia correspondente ao Tipo de anúncio de sua preferência.

Intersticial

Insira o Nome do app, selecione a plataforma e forneça o URL do app. Selecione Intersticial em vídeo como o Tipo de anúncio e clique em Atualizar.

Observação:os anúncios intersticiais da maio são puláveis por padrão.

Premiado

Insira o Nome do app, selecione a plataforma e forneça o URL do app. Selecione Vídeos premiados como o Tipo de anúncio e clique em Atualizar.

Observação:os anúncios em vídeo premiado da maio NÃO são puláveis por padrão.

Na página Gerenciamento de aplicativos, anote o ID da mídia. Ele é necessário para configurar seu bloco de anúncios da AdMob na próxima seção.

Na página Gerenciamento de zonas, anote o ID da zona. Também será necessário configurar seu bloco de anúncios da AdMob na próxima seção.

(Somente em cascata) Além do ID da mídia e do ID da zona, você vai precisar do ID da API e da CHAVE DA API para configurar o ID do bloco de anúncios para mediação. Na página da API Reporting, anote o ID da API e a CHAVE DA API.

Observação: (somente em cascata) Se esta for a primeira vez que você configura sua conta do maio, talvez seja necessário entrar em contato com a equipe de suporte do maio para que seu ID da API e sua CHAVE DE API sejam emitidos para você.

Etapa 2: configurar a demanda da maio na interface da AdMob

Definir as configurações de mediação do bloco de anúncios

Adicione a maio à configuração de mediação do seu bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Navegue até a guia Mediação. Se você tiver um grupo de mediação que quer modificar, clique no nome dele para editar e pule para Adicionar a maio como uma origem de anúncios.

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

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

Dê um nome ao grupo de mediação e selecione os locais de segmentação. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.

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

O card "Blocos de anúncios" vai aparecer com os blocos selecionados:

Adicionar a maio como uma origem de anúncios

No card Hierarquia da seção Origens de anúncios, selecione Adicionar origem do anúncio.

Selecione maio e ative a chave Otimizar. Insira o ID da API e a CHAVE DE API obtidos na seção anterior para configurar a otimização da origem de anúncios para a maio. Em seguida, insira um valor de eCPM para a maio e clique em Continuar.

Observação: só é necessário configurar a otimização da origem de anúncios uma vez por rede.

Se você já tiver um mapeamento para a maio, selecione-o. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira o ID da mídia e o ID da zona obtidos na seção anterior. Em seguida, clique em Concluído.

Importante: o ID da mídia precisa ser associado ao app segmentado, como na interface da maio.

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

Etapa 3: importar o SDK e o adaptador da maio

Observação: a falha na integração das versões compatíveis do maio e do Google Mobile Ads SDK pode causar problemas de build.

Usar o Swift Package Manager

Antes de continuar, você precisa ter a versão mínima compatível do adaptador 2.2.0.0.

Para adicionar uma dependência de pacote ao seu projeto, siga estas etapas:

1. No Xcode, navegue até Arquivo > Adicionar dependências do pacote….

2. No comando que aparece, pesquise o seguinte URL do pacote:

   https://github.com/googleads/googleads-mobile-ios-mediation-maio.git
   

3. Em Regra de dependência, selecione Ramificação.

4. No campo de texto, digite main.

Usar o CocoaPods

• Adicione a seguinte linha ao Podfile do seu projeto:

  pod 'GoogleMobileAdsMediationMaio'
  

• Na linha de comando, execute:

  pod install --repo-update

Integração manual

• Faça o download da versão mais recente do SDK do maio.
• Faça o download da versão mais recente do adaptador maio usando o link de download no Registro de mudanças e vincule maioAdapter.framework no seu projeto.

Etapa 4: adicionar o código necessário

Implementar a SKAdNetwork

Siga a documentação do maio 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 na AdMob.

Os editores que usam a versão 7.26.0 ou mais recente do Google Mobile Ads SDK vão receber automaticamente anúncios de teste da maio em smartphones e tablets registrados como dispositivos de teste ao fazer solicitações.

Importante: desative o modo de teste para a AdMob e a maio antes de lançar o app.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste da maio, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios maio (hierarquia).

Códigos de erro

Se o adaptador não receber um anúncio da maio, os editores podem verificar o erro na resposta do anúncio usando GADResponseInfo.adNetworkInfoArray nas seguintes classes:

Formato	Nome da classe
Intersticial	GADMMaioInterstitialAdapter
Premiado	GADMMaioRewardedAdapter

Confira os códigos e as mensagens geradas pelo adaptador da maio quando um anúncio não é carregado:

Código do erro	Motivo
0-10	maio retornou um erro específico do SDK. Consulte o código de maio para mais detalhes.
101	maio ainda não tem um anúncio disponível.
102	Parâmetros de servidor inválidos (por exemplo, ID da posição ausente).
103	O adaptador da maio não é compatível com o formato de anúncio solicitado.
104	Um anúncio já está carregado para essa configuração de rede.

Registro de alterações do adaptador de mediação da maio para iOS

Versão 2.2.1.0 (em andamento)

Versão 2.2.0.3

• Adicionamos suporte para anúncios de banner em hierarquia.
• Atualizamos a dependência do SDK dos anúncios para dispositivos móveis do Google para a versão 13.0.0.

Criado e testado com:

• Versão 13.0.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.2.0 do SDK da Maio.

Versão 2.2.0.2

• Atualizamos a versão mínima do iOS do CocoaPods para 13.0.

Criado e testado com:

• Versão 13.0.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.2.0 do SDK da Maio.

Versão 2.2.0.1

• A implementação de lances foi removida porque o Maio não oferece mais suporte a lances.
• Atualize o adaptador para usar o protocolo GADMediationAdapter.

Criado e testado com:

• Versão 12.11.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.2.0 do SDK da Maio.

Versão 2.2.0.0

• Compatibilidade verificada com a versão 2.2.0 do SDK da maio.

Criado e testado com:

• Versão 12.11.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.2.0 do SDK da Maio.

Versão 2.1.6.1

• Agora requer a versão 12.0.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

• Versão 12.0.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.1.6 do SDK da Maio.

Versão 2.1.6.0

• Compatibilidade verificada com a versão 2.1.6 do SDK da maio.

Criado e testado com:

• Versão 11.13.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.1.6 do SDK da Maio.

Versão 2.1.5.1

• Atualizamos o CFBundleShortVersionString para ter três componentes em vez de quatro.

Criado e testado com:

• Versão 11.10.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.1.5 do SDK da Maio.

Versão 2.1.5.0

• Compatibilidade verificada com a versão 2.1.5 do SDK da maio.

Criado e testado com:

• Versão 11.6.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.1.5 do SDK da Maio.

Versão 2.1.4.0

• Compatibilidade verificada com a versão 2.1.4 do SDK da maio.

Criado e testado com:

• Versão 11.2.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.1.4 do SDK da Maio.

Versão 2.1.3.0

• Compatibilidade verificada com a versão 2.1.3 do SDK da maio.

Criado e testado com:

• Versão 11.1.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.1.3 do SDK da Maio.

Versão 2.1.2.1

• Agora requer a versão 11.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
• Incluímos Info.plist nas estruturas em MaioAdapter.xcframework.

Criado e testado com:

• Versão 11.0.1 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.1.2 do SDK da Maio.

Versão 2.1.2.0

• Compatibilidade verificada com a versão 2.1.2 do SDK da maio.

Criado e testado com:

• Versão 10.14.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.1.2 do SDK da Maio.

Versão 2.1.1.0

• Compatibilidade verificada com a versão 2.1.1 do SDK da maio.

Criado e testado com:

• Versão 10.12.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.1.1 do SDK da Maio.

Versão 2.0.0.0

• Compatibilidade verificada com a versão 2.0.0 do SDK da maio.
• A dependência de MaioOB SDK foi removida.
• A compatibilidade com a arquitetura armv7 foi removida.
• Agora requer a versão mínima do iOS 12.0.
• Agora requer a versão 10.4.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

• Versão 10.10.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.0.0 do SDK da Maio.

Versão 1.6.3.1

• Agora requer a versão 10.0.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

• Versão 10.0.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.6.3 do SDK da Maio.
• Versão 2.0.0-alpha do SDK da MaioOB.

Versão 1.6.3.0

• Atualizamos o adaptador para usar a API didRewardUser.
• Agora requer a versão 9.8.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
• Compatibilidade verificada com a versão 1.6.3 do SDK da maio e a versão 2.0.0-alpha do SDK da maioOB.

Criado e testado com:

• Versão 9.12.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.6.3 do SDK da Maio.
• Versão 2.0.0-alpha do SDK da MaioOB.

Versão 1.6.2.0

• Compatibilidade verificada com a versão 1.6.2 do SDK da maio e a versão 2.0.0-alpha do SDK da maioOB.

Criado e testado com:

• Versão 9.5.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.6.2 do SDK da Maio.
• Versão 2.0.0-alpha do SDK da MaioOB.

Versão 1.6.1.0

• Compatibilidade verificada com a versão 1.6.1 do SDK da maio e a versão 2.0.0-alpha do SDK da maioOB.

Criado e testado com:

• Versão 9.2.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.6.1 do SDK da Maio.
• Versão 2.0.0-alpha do SDK da MaioOB.

Versão 1.6.0.1

• Compatibilidade verificada com a versão 9.0.0 do SDK dos anúncios para dispositivos móveis do Google.
• Agora requer a versão 9.0.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

• Versão 9.0.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.6.0 do SDK da Maio.
• Versão 2.0.0-alpha do SDK da MaioOB.

Versão 1.6.0.0

• Compatibilidade verificada com a versão 1.6.0 do SDK da maio e a versão 2.0.0-alpha do SDK da maioOB.

Criado e testado com:

• Versão 8.13.0 do SDK dos anúncios para dispositivos móveis do Google.
• Agora requer a versão mínima do iOS 10.0.
• Versão 1.6.0 do SDK da Maio.
• Versão 2.0.0-alpha do SDK da MaioOB.

Versão 1.5.8.0

• Compatibilidade verificada com a versão 1.5.8 do SDK da maio e a versão 2.0.0-alpha do SDK da maioOB.
• Adicionamos a capacidade de lances ao adaptador para formatos de anúncio intersticial e premiado.
• Flexibilizamos a dependência da versão 8.0.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

• Versão 8.7.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.5.8 do SDK da Maio.
• Versão 2.0.0-alpha do SDK da MaioOB.

Versão 1.5.6.1

• Adicionamos códigos e mensagens de erro padronizados do adaptador.
• Atualizamos o adaptador para usar o formato .xcframework.
• Correção de um bug em que os eventos de anúncios premiados às vezes não eram encaminhados.
• Agora requer a versão 8.3.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

• Versão 8.3.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.5.6 do SDK da Maio.

Versão 1.5.6.0

• Compatibilidade verificada com a versão 1.5.6 do SDK da maio.
• Agora requer a versão 7.68.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

• Versão 7.68.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.5.6 do SDK da Maio.

Versão 1.5.5.0

• Compatibilidade verificada com a versão 1.5.5 do SDK da maio.
• Agora requer a versão 7.64.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

• Versão 7.64.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.5.5 do SDK da Maio.

Versão 1.5.4.0

• Compatibilidade verificada com a versão 1.5.4 do SDK da maio.
• Agora requer a versão 7.60.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

• Versão 7.60.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.5.4 do SDK da Maio.

Versão 1.5.3.1

• Para limitar os tempos limite, as solicitações de anúncio agora vão falhar imediatamente se o maio não tiver um anúncio pronto para ser mostrado.
• A compatibilidade com a arquitetura i386 foi removida.

Criado e testado com:

• Versão 7.58.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.5.3 do SDK da Maio.

Versão 1.5.3.0

• Compatibilidade verificada com a versão 1.5.3 do SDK da maio.

Criado e testado com:

• Versão 7.55.1 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.5.3 do SDK da Maio.

Versão 1.5.2.1

• Correção de um problema em que o adaptador não invocava o callback -rewardedAdDidPresent:.

Criado e testado com:

• Versão 7.53.1 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.5.2 do SDK da Maio.

Versão 1.5.2.0

• Compatibilidade verificada com a versão 1.5.2 do SDK da maio.

Criado e testado com:

• Versão 7.53.1 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.5.2 do SDK da Maio.

Versão 1.5.1.0

• Compatibilidade verificada com a versão 1.5.1 do SDK da maio.

Criado e testado com:

• Versão 7.52.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.5.1 do SDK da Maio.

Versão 1.5.0.0

• Compatibilidade verificada com a versão 1.5.0 do SDK da maio.

Criado e testado com

• Versão 7.51.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.5.0 do SDK do Maio Ads.

Versão 1.4.8.0

• Compatibilidade verificada com a versão 1.4.8 do SDK da maio.

Versão 1.4.6.0

• Compatibilidade verificada com a versão 1.4.6 do SDK da maio.
• Atualizamos o adaptador para usar a nova API Rewarded.
• Agora requer a versão 7.42.2 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Versão 1.4.2.0

• Compatibilidade verificada com a versão 1.4.2 do SDK da maio.

Versão 1.4.1.0

• Compatibilidade verificada com a versão 1.4.1 do SDK da maio.
• Foi corrigido um problema em que o adaptador do maio podia falhar se vários MediaIds fossem fornecidos pela AdMob.

Versão 1.4.0.0

• Compatibilidade verificada com a versão 1.4.0 do SDK da maio.

Versão 1.3.2.0

• Compatibilidade verificada com a versão 1.3.2 do SDK da maio.

Versão 1.3.1.1

• Adição do callback adapterDidCompletePlayingRewardBasedVideoAd: ao adaptador.

Versão 1.3.1.0

• Compatibilidade verificada com a versão 1.3.1 do SDK da maio.

Versão 1.3.0.0

• Compatibilidade verificada com a versão 1.3.0 do SDK da maio.

Versão 1.2.19.0

• Compatibilidade verificada com a versão 1.2.19 do SDK da maio.

Versão 1.2.18.0

• Primeira versão!
• Adicionamos suporte para anúncios intersticiais e vídeos premiados.