Integrar maio à mediação

Selecione a plataforma: Android (Beta) Novo Android iOS Unity Flutter

Este guia mostra como usar Google Mobile Ads SDK para carregar e exibir anúncios da maio usando a mediação, incluindo 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 13.0 ou mais recente.

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 de sua preferência.

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. Ele é necessário para configurar seu 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 seu bloco de anúncios do Ad Manager 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 do Ad Manager

Definir 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 seu 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 Aplicativo para dispositivos móveis a que você quer 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 novo parceiro de rendimento.

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

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

Depois de selecionar o Parceiro de rendimento, escolha Mediação de SDK para dispositivos móveis como o Tipo de integração, iOS como a Plataforma e Ativo como o Status. Insira o ID da mídia e o ID da zona obtidos 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

Usar o Swift Package Manager

Antes de continuar, você precisa ter a versão mínima compatível do adaptador 2.2.0.0.

Para adicionar uma dependência de pacote ao seu projeto, siga estas etapas:

  1. No Xcode, navegue até Arquivo > Adicionar dependências do pacote….

  2. No comando que aparece, pesquise o seguinte URL do pacote:

    https://github.com/googleads/googleads-mobile-ios-mediation-maio.git

  3. Em Regra de dependência, selecione Ramificação.

  4. No campo de texto, digite main.

Usar o CocoaPods

  • 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 de download no Registro de mudanças e vincule maioAdapter.framework no seu projeto.

Etapa 4: adicionar o código necessário

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

Os editores que usam a versão 7.26.0 ou mais recente do Google Mobile Ads SDK vão receber 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

Versão 2.2.1.0 (em andamento)

Versão 2.2.0.3

  • Adicionamos suporte para anúncios de banner em hierarquia.
  • Atualizamos a dependência do SDK dos anúncios para dispositivos móveis do Google para a versão 13.0.0.

Criado e testado com:

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

Versão 2.2.0.2

  • Atualizamos a versão mínima do iOS do CocoaPods para 13.0.

Criado e testado com:

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

Versão 2.2.0.1

  • A implementação de lances foi removida porque o Maio não oferece mais suporte a lances.
  • Atualize o adaptador para usar o protocolo GADMediationAdapter.

Criado e testado com:

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

Versão 2.2.0.0

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

Criado e testado com:

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

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ímos 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.
  • A compatibilidade com a arquitetura armv7 foi removida.
  • 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.
  • Flexibilizamos a dependência 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 mostrado.
  • 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.
  • Foi corrigido 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.