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 da AdMob, cobrindo integrações de hierarquia. Ele aborda como adicionar o maio à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do 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 no idioma 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
Leia o Guia explicativo de mediação
Etapa 1: configurar as configurações na interface do 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 seu aplicativo, selecione a plataforma e forneça o URL do aplicativo. 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 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 cascata) Além do ID da mídia e do ID da zona, você precisará do ID de API e da CHAVE de 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 maio na AdMob interface
Definir as configurações de mediação para seu bloco de anúncios
Você precisa adicionar maio à configuração de mediação do seu bloco de anúncios.
Primeiro, faça login na sua conta da AdMob. Em seguida, acesse a guia Mediação. Se você quiser modificar um grupo de mediação, clique no nome dele para editá-lo e prossiga para Adicionar maio como uma origem de anúncios.
Para criar um novo grupo de mediação, selecione Criar grupo de mediação.
Insira a plataforma e o formato 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 e clique em Adicionar blocos de anúncios.
Associe esse grupo de mediação a um ou mais dos seus blocos de anúnciosAdMob existentes. Em seguida, clique em Concluído.
Agora você verá o card de blocos de anúncios preenchido com os blocos selecionados:
Adicionar maio como uma origem de anúncios
No card Cascata, na seção Origens de anúncios, selecione Adicionar origem do anúncio. Em seguida, selecione maio.
Selecione maio e ative a chave Otimizar. Insira o API ID and API KEY recebido na seção anterior para configurar a otimização da origem de anúncios para maio. Em seguida, insira um valor de eCPM para maio e clique em Continuar.Se você já tem um mapeamento para maio, pode selecioná-lo. Caso contrário, clique em Adicionar mapeamento.
Em seguida, insira o Media ID and Zone ID recebido na seção anterior. Em seguida, clique em Concluído.
Etapa 3: importar o SDK e o adaptador da maio
Como usar 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 necessá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 | pode ter retornado 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.
- Versão 2.1.5 do SDK de maio.
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 a versão 2.1.4 do SDK de maio.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.2.0.
- SDK do Maio versão 2.1.4.
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.
- Versão 2.1.3 do SDK de maio.
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 a versão 2.1.1 do SDK de maio.
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. - A compatibilidade com a arquitetura
armv7
foi removida. - 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 o SDK maio versão 1.6.3 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.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 a versão 1.6.1 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.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 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:
- 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 o SDK maio versão 1.6.0 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 8.13.0.
- Agora exige 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 reduzida 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.
- Versão 1.5.8 do SDK de maio.
- 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 usar o SDK dos anúncios para dispositivos móveis do Google versão 8.3.0 ou mais recente.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 8.3.0.
- SDK do Maio versão 1.5.6.
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.
- SDK do Maio versão 1.5.6.
Versão 1.5.5.0
- Compatibilidade verificada com a versão 1.5.5 do SDK de maio.
- Agora é necessário ter a versão 7.64.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 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.
- Versão 1.5.4 do SDK de maio.
Versão 1.5.3.1
- Para limitar os tempos limite, as solicitações de anúncios vão falhar imediatamente se maio não tiver um anúncio pronto para exibição.
- 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 o SDK de maio versão 1.5.3.
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.
- SDK do Maio versão 1.5.1.
Versão 1.5.0.0
- Compatibilidade verificada com a versão 1.5.0 do SDK de maio.
Desenvolvido 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.
- Atualizamos o adaptador para usar a nova API de recompensa.
- 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 a versão 1.4.0 do SDK de maio.
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.