Integrar a maio com a mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da maio usando a Mediação da AdMob, incluindo as integrações em hierarquia. Ele explica como adicionar a maio à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da maio a um app iOS.

A interface do painel do maio usa texto em japonês para rótulos, botões e descrições, e 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 seus equivalentes em inglês. "URL スキーム", por exemplo, é "URL Scheme".

Integrações e formatos de anúncio aceitos

O adaptador de mediação da 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 todo o guia para iniciantes da mediação.

Etapa 1: definir as configurações na interface da maio

Primeiro, inscreva-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ê prefere.

Intersticial

Insira o Nome do app, selecione a plataforma e forneça 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 forneça o URL do app. Selecione Vídeos premiados como o Tipo de anúncio e clique em Atualizar.

Na página Gerenciamento de aplicativos, anote o ID da mídia. Ela é necessária para 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 em cascata) 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 da maio na interface da AdMob

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

Adicione a maio à configuração de mediação do seu bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Navegue até a guia Mediação. Se você tiver um grupo de mediação que quer modificar, clique no nome dele para editar e pule para Adicionar a maio como uma origem de anúncios.

Para criar um grupo de mediação, selecione Criar grupo de mediação.

Insira o formato e a plataforma do anúncio, depois 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 dos seus blocos de anúncios da AdMob. Clique em Concluído.

O card "Blocos de anúncios" vai aparecer com os blocos selecionados:

Adicionar a maio como uma origem de anúncios


No card Hierarquia da seção Origens de anúncios, selecione Adicionar origem do anúncio.

Selecione maio e ative a chave Otimizar. Insira o ID da API e a CHAVE DE API obtidos na seção anterior para configurar a otimização da origem de anúncios para a maio. Em seguida, insira um valor de eCPM para a 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 obtidos 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 do maio.
  • Faça o download da versão mais recente do adaptador maio usando o link na lista de mudanças e vincule maioAdapter.framework no 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 recebem automaticamente anúncios de teste da 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 da maio, os editores podem verificar o erro na 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 geradas pelo adaptador da 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 de servidor inválidos (por exemplo, ID da posição ausente).
103 O adaptador da maio não é compatível com o formato de anúncio solicitado.
104 Um anúncio já está carregado para essa configuração de rede.

Registro de alterações do adaptador de mediação da maio para iOS

Próxima versão

  • Ative -fobjc-arc e -fstack-protector-all.

Versão 2.1.6.1

  • Agora requer a versão 12.0.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

  • Versão 12.0.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 2.1.6 do SDK da Maio.

Versão 2.1.6.0

  • Compatibilidade verificada com a versão 2.1.6 do SDK da maio.

Criado e testado com:

  • Versão 11.13.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 2.1.6 do SDK da Maio.

Versão 2.1.5.1

  • Atualizamos o CFBundleShortVersionString para ter três componentes em vez de quatro.

Criado e testado com:

  • Versão 11.10.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 2.1.5 do SDK da Maio.

Versão 2.1.5.0

  • Compatibilidade verificada com a versão 2.1.5 do SDK da maio.

Criado e testado com:

  • Versão 11.6.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 2.1.5 do SDK da Maio.

Versão 2.1.4.0

  • Compatibilidade verificada com a versão 2.1.4 do SDK da maio.

Criado e testado com:

  • Versão 11.2.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 2.1.4 do SDK da Maio.

Versão 2.1.3.0

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

Criado e testado com:

  • Versão 11.1.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 2.1.3 do SDK da Maio.

Versão 2.1.2.1

  • Agora requer a versão 11.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
  • Incluído Info.plist nas estruturas em MaioAdapter.xcframework.

Criado e testado com:

  • Versão 11.0.1 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 2.1.2 do SDK da Maio.

Versão 2.1.2.0

  • Compatibilidade verificada com a versão 2.1.2 do SDK da maio.

Criado e testado com:

  • Versão 10.14.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 2.1.2 do SDK da Maio.

Versão 2.1.1.0

  • Compatibilidade verificada com a versão 2.1.1 do SDK da maio.

Criado e testado com:

  • Versão 10.12.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 2.1.1 do SDK da Maio.

Versão 2.0.0.0

  • Compatibilidade verificada com a versão 2.0.0 do SDK da maio.
  • A dependência de MaioOB SDK foi removida.
  • O suporte à arquitetura armv7 foi removido.
  • Agora requer 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:

  • Versão 10.10.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 2.0.0 do SDK da 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:

  • Versão 10.0.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.6.3 do SDK da Maio.
  • Versão 2.0.0-alpha do SDK da MaioOB.

Versão 1.6.3.0

  • Atualizamos o adaptador para usar a API didRewardUser.
  • Agora requer 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 da maio e a versão 2.0.0-alpha do SDK da maioOB.

Criado e testado com:

  • Versão 9.12.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.6.3 do SDK da Maio.
  • Versão 2.0.0-alpha do SDK da MaioOB.

Versão 1.6.2.0

  • Compatibilidade verificada com a versão 1.6.2 do SDK da maio e a versão 2.0.0-alpha do SDK da maioOB.

Criado e testado com:

  • Versão 9.5.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.6.2 do SDK da Maio.
  • Versão 2.0.0-alpha do SDK da MaioOB.

Versão 1.6.1.0

  • Compatibilidade verificada com a versão 1.6.1 do SDK da maio e a versão 2.0.0-alpha do SDK da maioOB.

Criado e testado com:

  • Versão 9.2.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.6.1 do SDK da Maio.
  • Versão 2.0.0-alpha do SDK da MaioOB.

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:

  • Versão 9.0.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.6.0 do SDK da Maio.
  • Versão 2.0.0-alpha do SDK da MaioOB.

Versão 1.6.0.0

  • Compatibilidade verificada com a versão 1.6.0 do SDK da maio e a versão 2.0.0-alpha do SDK da maioOB.

Criado e testado com:

  • Versão 8.13.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Agora requer a versão mínima do iOS 10.0.
  • Versão 1.6.0 do SDK da Maio.
  • Versão 2.0.0-alpha do SDK da MaioOB.

Versão 1.5.8.0

  • Compatibilidade verificada com a versão 1.5.8 do SDK da maio e a versão 2.0.0-alpha do SDK da maioOB.
  • Adicionamos a capacidade de lances ao adaptador para formatos de anúncio intersticial e premiado.
  • Dependência flexível da versão 8.0.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

  • Versão 8.7.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.5.8 do SDK da Maio.
  • Versão 2.0.0-alpha do SDK da MaioOB.

Versão 1.5.6.1

  • Adicionamos códigos e mensagens de erro padronizados do adaptador.
  • Atualizamos o adaptador 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 requer a versão 8.3.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

  • Versão 8.3.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.5.6 do SDK da Maio.

Versão 1.5.6.0

  • Compatibilidade verificada com a versão 1.5.6 do SDK da maio.
  • Agora requer a versão 7.68.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

  • Versão 7.68.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.5.6 do SDK da Maio.

Versão 1.5.5.0

  • Compatibilidade verificada com a versão 1.5.5 do SDK da maio.
  • Agora requer a versão 7.64.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

  • Versão 7.64.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.5.5 do SDK da Maio.

Versão 1.5.4.0

  • Compatibilidade verificada com a versão 1.5.4 do SDK da maio.
  • Agora requer a versão 7.60.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

  • Versão 7.60.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.5.4 do SDK da Maio.

Versão 1.5.3.1

  • Para limitar os tempos limite, as solicitações de anúncio agora vão falhar imediatamente se o maio não tiver um anúncio pronto para ser veiculado.
  • A compatibilidade com a arquitetura i386 foi removida.

Criado e testado com:

  • Versão 7.58.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.5.3 do SDK da Maio.

Versão 1.5.3.0

  • Compatibilidade verificada com a versão 1.5.3 do SDK da maio.

Criado e testado com:

  • Versão 7.55.1 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.5.3 do SDK da Maio.

Versão 1.5.2.1

  • Correção de um problema em que o adaptador não invocava o callback -rewardedAdDidPresent:.

Criado e testado com:

  • Versão 7.53.1 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.5.2 do SDK da Maio.

Versão 1.5.2.0

  • Compatibilidade verificada com a versão 1.5.2 do SDK da maio.

Criado e testado com:

  • Versão 7.53.1 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.5.2 do SDK da Maio.

Versão 1.5.1.0

  • Compatibilidade verificada com a versão 1.5.1 do SDK da maio.

Criado e testado com:

  • Versão 7.52.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.5.1 do SDK da Maio.

Versão 1.5.0.0

  • Compatibilidade verificada com a versão 1.5.0 do SDK da maio.

Criado e testado com

  • Versão 7.51.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 1.5.0 do SDK do Maio Ads.

Versão 1.4.8.0

  • Compatibilidade verificada com a versão 1.4.8 do SDK da maio.

Versão 1.4.6.0

  • Compatibilidade verificada com a versão 1.4.6 do SDK da maio.
  • Atualizamos o adaptador para usar a nova API Rewarded.
  • Agora requer 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 da maio.

Versão 1.4.1.0

  • Compatibilidade verificada com a versão 1.4.1 do SDK da maio.
  • Correção de um problema em que o adaptador do maio podia 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 da maio.

Versão 1.3.2.0

  • Compatibilidade verificada com a versão 1.3.2 do SDK da maio.

Versão 1.3.1.1

  • Adição do callback adapterDidCompletePlayingRewardBasedVideoAd: ao adaptador.

Versão 1.3.1.0

  • Compatibilidade verificada com a versão 1.3.1 do SDK da maio.

Versão 1.3.0.0

  • Compatibilidade verificada com a versão 1.3.0 do SDK da maio.

Versão 1.2.19.0

  • Compatibilidade verificada com a versão 1.2.19 do SDK da maio.

Versão 1.2.18.0

  • Primeira versão!
  • Adicionamos suporte para anúncios intersticiais e vídeos premiados.