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 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 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

  • 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 seu Tipo de anúncio preferido.

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 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

  • 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 principal.
  • Faça o download da versão mais recente do adaptador de maio no link de download da Changelog e vincule maioAdapter.framework ao seu projeto.

Etapa 4: adicionar o código necessário

Integração com 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 em AdMob

Os editores que usam a versão 7.26.0 ou posterior do SDK dos anúncios para dispositivos móveis do Google receberão automaticamente os anúncios de teste 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 do maio, ative os testes de uma única origem no Ad Inspector usando as maio (Waterfall) origens de anúncios.

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 esta 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 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 o SDK de maio versão 2.1.2.

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 o SDK de maio versão 2.0.0.
  • A dependência de MaioOB SDK foi removida.
  • A compatibilidade com a arquitetura armv7 foi removida.
  • Agora exige 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:

  • 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.
  • SDK do Maio versão 1.6.3.
  • SDK do MaioOB versão 2.0.0-alpha.

Versão 1.6.3.0

  • O adaptador foi atualizado para usar a API didRewardUser.
  • Agora é necessário ter 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 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.
  • SDK do Maio versão 1.6.2.
  • 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.
  • SDK do Maio versão 1.6.1.
  • 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.
  • SDK do Maio versão 1.6.0.
  • 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 de erro e mensagens 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 ter a versão 7.68.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.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.
  • SDK do Maio versão 1.5.5.

Versão 1.5.4.0

  • Compatibilidade verificada com o SDK de maio versão 1.5.4.
  • 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 da compatibilidade com a 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.
  • SDK do Maio versão 1.5.3.

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.
  • SDK do Maio versão 1.5.2.

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.
  • SDK do Maio versão 1.5.2.

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 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 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 o SDK de maio versão 1.3.0.

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!
  • Agora é possível usar intersticiais e anúncios em vídeo premiados.