Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios de maio usando mediação, cobrindo integrações de hierarquia. Ele aborda como adicionar maio à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador de maio a um appiOS .
A interface do painel para maio usa texto em japonês nos rótulos, botões e descrições. 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 os equivalentes em inglês. Por exemplo, "URL スキーム" é "URL Scheme".
Integrações e formatos de anúncio compatíveis
O adaptador de mediação para maio tem os seguintes recursos:
Integração | |
---|---|
Lances | |
Cascata | |
Formatos | |
Banner | |
Intersticial | |
Premiado | |
Nativo |
Requisitos
- Destino de implantação do iOS 12.0 ou mais recente
SDK dos anúncios para dispositivos móveis do Google mais recente
Concluir o Guia explicativo de mediação
Etapa 1: definir configurações na interface de maio
Primeiro, cadastre-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 que você quer.
Intersticial
Insira o nome do app, selecione a plataforma e informe o URL do app. Selecione Intersticial em vídeo como o Tipo de anúncio e clique em Atualizar.
Premiado
Insira o nome do app, selecione a plataforma e informe o URL do app. Selecione Recompensas de vídeo como o Tipo de anúncio e clique em Atualizar.
Na página Gerenciamento de aplicativos, anote o ID da mídia. É necessário configurar o bloco de anúncios da AdMob na próxima seção.
Na página Gerenciamento de zona, anote o ID da zona. Também será necessário configurar seu bloco de anúncios da AdMob na próxima seção.
(Somente hierarquia) 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.Etapa 2: configurar a demanda de maio na Ad Manager interface
Etapa 3: importar o SDK e o adaptador da maio
Usando o CocoaPods (recomendado)
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 no link de download no
Changelog
e vincule
maioAdapter.framework
ao seu projeto.
Etapa 4: adicionar o código obrigatório
Integração da 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 SDK dos anúncios para dispositivos móveis do Google vão receber anúncios de teste automaticamente a partir de maio em smartphones e tablets registrados como dispositivos de teste ao fazer solicitações.
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 de maio,
os editores poderão verificar o erro subjacente da 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 exibidas pelo adaptador 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 do servidor inválidos (por exemplo, ID da posição ausente). |
103 | O adaptador maio não oferece suporte ao formato de anúncio solicitado. |
104 | Um anúncio já foi carregado para essa configuração de rede. |
Registro de alterações do adaptador de mediação para iOS de maio
Versão 2.1.5.1
CFBundleShortVersionString
foi atualizado para ter três componentes em vez de quatro.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.10.0.
- SDK do Maio versão 2.1.5.
Versão 2.1.5.0
- Compatibilidade verificada com a versão 2.1.5 do SDK de maio.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.6.0.
- Versão 2.1.5 do SDK de maio.
Versão 2.1.4.0
- Compatibilidade verificada com o SDK de maio versão 2.1.4.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.2.0.
- Versão 2.1.4 do SDK de maio.
Versão 2.1.3.0
- Compatibilidade verificada com o SDK de maio versão 2.1.3.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.1.0.
- SDK do Maio versão 2.1.3.
Versão 2.1.2.1
- Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 11.0 ou mais recente.
- Incluiu
Info.plist
nos frameworks emMaioAdapter.xcframework
.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.0.1.
- Versão 2.1.2 do SDK de maio.
Versão 2.1.2.0
- Compatibilidade verificada com a versão 2.1.2 do SDK de maio.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.14.0.
- Versão 2.1.2 do SDK de maio.
Versão 2.1.1.0
- Compatibilidade verificada com o SDK de maio versão 2.1.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.12.0.
- SDK do Maio versão 2.1.1.
Versão 2.0.0.0
- Compatibilidade verificada com a versão 2.0.0 do SDK de maio.
- A dependência de
MaioOB SDK
foi removida. - Remoção da compatibilidade com a arquitetura
armv7
. - Agora requer a versão mínima do iOS 12.0.
- Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 10.4.0 ou mais recente.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.10.0.
- Versão 2.0.0 do SDK de 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:
- SDK dos anúncios para dispositivos móveis do Google versão 10.0.0.
- Versão 1.6.3 do SDK de maio.
- SDK do MaioOB versão 2.0.0-alpha.
Versão 1.6.3.0
- Atualizamos o adaptador para usar a API
didRewardUser
. - Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 9.8.0 ou mais recente.
- Compatibilidade verificada com a versão 1.6.3 do SDK do Maio e a versão 2.0.0-alpha do SDK do MaioOB.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.12.0.
- Versão 1.6.3 do SDK de maio.
- SDK do MaioOB versão 2.0.0-alpha.
Versão 1.6.2.0
- Compatibilidade verificada com o SDK maio versão 1.6.2 e o SDK maioOB versão 2.0.0-alpha.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.5.0.
- Versão 1.6.2 do SDK de maio.
- SDK do MaioOB versão 2.0.0-alpha.
Versão 1.6.1.0
- Compatibilidade verificada com o SDK maio versão 1.6.1 e o SDK maioOB versão 2.0.0-alpha.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.2.0.
- Versão 1.6.1 do SDK de maio.
- SDK do MaioOB versão 2.0.0-alpha.
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 é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 9.0.0 ou mais recente.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.0.0.
- SDK do Maio versão 1.6.0.
- SDK do MaioOB versão 2.0.0-alpha.
Versão 1.6.0.0
- Compatibilidade verificada com a versão 1.6.0 do SDK do Maio e a versão 2.0.0-alpha do SDK do MaioOB.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 8.13.0.
- Agora requer a versão mínima do iOS 10.0.
- Versão 1.6.0 do SDK de maio.
- SDK do MaioOB versão 2.0.0-alpha.
Versão 1.5.8.0
- Compatibilidade verificada com a versão 1.5.8 do SDK do Maio e a versão 2.0.0-alpha do SDK do MaioOB.
- Foi adicionado o recurso de lances ao adaptador para formatos de anúncios intersticiais e premiados.
- Dependência relaxada do SDK dos anúncios para dispositivos móveis do Google versão 8.0.0 ou mais recente.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 8.7.0.
- SDK do Maio versão 1.5.8.
- SDK do MaioOB versão 2.0.0-alpha.
Versão 1.5.6.1
- Foram adicionados códigos e mensagens de erro padronizados do adaptador.
- O adaptador foi atualizado 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 é necessário ter a versão 8.3.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 8.3.0.
- Versão 1.5.6 do SDK de maio.
Versão 1.5.6.0
- Compatibilidade verificada com a versão 1.5.6 do SDK de maio.
- Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 7.68.0 ou mais recente.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 7.68.0.
- Versão 1.5.6 do SDK de maio.
Versão 1.5.5.0
- Compatibilidade verificada com o SDK de maio versão 1.5.5.
- Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 7.64.0 ou mais recente.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 7.64.0.
- Versão 1.5.5 do SDK de maio.
Versão 1.5.4.0
- Compatibilidade verificada com a versão 1.5.4 do SDK de maio.
- Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 7.60.0 ou mais recente.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 7.60.0.
- SDK do Maio versão 1.5.4.
Versão 1.5.3.1
- Para limitar os tempos limite, as solicitações de anúncio vão falhar imediatamente se não houver um anúncio pronto para ser exibido.
- Remoção do suporte à arquitetura i386.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 7.58.0.
- Versão 1.5.3 do SDK de maio.
Versão 1.5.3.0
- Compatibilidade verificada com a versão 1.5.3 do SDK de maio.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 7.55.1.
- Versão 1.5.3 do SDK de maio.
Versão 1.5.2.1
- Correção de um problema em que o adaptador não estava invocando o callback
-rewardedAdDidPresent:
.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 7.53.1.
- Versão 1.5.2 do SDK de maio.
Versão 1.5.2.0
- Compatibilidade verificada com a versão 1.5.2 do SDK de maio.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 7.53.1.
- Versão 1.5.2 do SDK de maio.
Versão 1.5.1.0
- Compatibilidade verificada com a versão 1.5.1 do SDK de maio.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 7.52.0.
- Versão 1.5.1 do SDK de maio.
Versão 1.5.0.0
- Compatibilidade verificada com a versão 1.5.0 do SDK de maio.
Criado e testado com
- SDK dos anúncios para dispositivos móveis do Google versão 7.51.0.
- SDK do Google Ads versão 1.5.0.
Versão 1.4.8.0
- Compatibilidade verificada com a versão 1.4.8 do SDK de maio.
Versão 1.4.6.0
- Compatibilidade verificada com a versão 1.4.6 do SDK de maio.
- O adaptador foi atualizado para usar a nova API premiada.
- Agora é necessário ter 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 de maio.
Versão 1.4.1.0
- Compatibilidade verificada com a versão 1.4.1 do SDK de maio.
- Correção de um problema em que o adaptador de maio poderia falhar se vários MediaIds fossem fornecidos pela AdMob.
Versão 1.4.0.0
- Compatibilidade verificada com o SDK de maio versão 1.4.0.
Versão 1.3.2.0
- Compatibilidade verificada com a versão 1.3.2 do SDK de maio.
Versão 1.3.1.1
- O callback
adapterDidCompletePlayingRewardBasedVideoAd:
foi adicionado ao adaptador.
Versão 1.3.1.0
- Compatibilidade verificada com a versão 1.3.1 do SDK de maio.
Versão 1.3.0.0
- Compatibilidade verificada com a versão 1.3.0 do SDK de maio.
Versão 1.2.19.0
- Compatibilidade verificada com a versão 1.2.19 do SDK de maio.
Versão 1.2.18.0
- Primeira versão!
- Adição de suporte para anúncios intersticiais e em vídeo premiados.