Integrar maio à mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios de maio usando a mediação, 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 do Ad Manager na próxima seção.

Na página Gerenciamento de zonas, anote o ID da zona. Também será necessário configurar o bloco de anúncios do Ad Manager 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 máxima na interface do Ad Manager

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

Faça login na sua conta do Ad Manager.

Acesse Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento.

Insira um Nome exclusivo para o grupo de rendimento, defina o Status como Ativo, selecione o Formato do anúncio e defina o Tipo de inventário como App para dispositivos móveis. Na seção Segmentação > Inventário, selecione o bloco de anúncios em Inventário e App para dispositivos móveis para adicionar a mediação.

Em seguida, clique no botão Adicionar parceiro de rendimento.

Se você já tiver um parceiro de rendimento para maio, selecione-o. Caso contrário, selecione Criar um parceiro de rendimento.

Selecione maio como a rede de publicidade, insira um nome exclusivo e ative a Mediação.

Ative a Coleta de dados automática e insira o ID da API e a CHAVE DA API recebidos na seção anterior.

Depois de selecionar o Parceiro de rendimento, escolha Mediação do SDK para dispositivos móveis como Tipo de integração, iOS como Plataforma e Ativo como Status. Insira o ID da mídia e o ID da zona recebidos na seção anterior. Em seguida, insira um valor de CPM padrão.

Clique em Salvar na parte de baixo da página quando terminar.

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 no Ad Manager.

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.