Integrar maio 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 maio usando a mediação da AdMob, cobrindo integrações em 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 app iOS.

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 para iniciantes 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 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 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 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 interface da AdMob

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

É necessário adicionar maio à configuração de mediação do bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Em seguida, navegue até a guia Mediation. Se você tiver um grupo de mediação que gostaria de modificar, clique no nome dele para editá-lo e pule para Adicionar a maio como uma 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.

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 blocos de anúncios da AdMob. Clique em Concluído.

O card "Blocos de anúncios" vai ser preenchido com os blocos que você selecionou:

Adicionar maio como uma origem de anúncios


No card Hierarquia, na seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione maio.

Selecione maio e ative a chave Optimize. Insira o ID da API e a CHAVE DE API obtida 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á tiver um mapeamento para "maio", selecione-o. Caso contrário, clique em Adicionar mapeamento.

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


Etapa 3: importar o SDK e o adaptador da maio

  • Adicione a seguinte linha ao Podfile do 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 do 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.
  • Versão 2.1.4 do SDK de maio.

Versão 2.1.3.0

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

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 em MaioAdapter.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.
  • Versão 2.1.1 do SDK de maio.

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 é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 10.0.0 ou mais recente.

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 do Maio versão 1.6.2 e o SDK do 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 é 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.
  • Versão 1.6.0 do SDK de maio.
  • 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.
  • 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.
  • 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 a versão 1.5.5 do SDK de maio.
  • 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.
  • 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úncio agora 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.

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 usar o SDK dos anúncios para dispositivos móveis do Google versão 7.42.2 ou mais recente.

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 maio poderia falhar se vários MediaIds fossem fornecidos pelo 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.