Integrar a maio com a mediação

Selecione a plataforma: Android iOS Unity Flutter Android (legada)

Este guia mostra como usar Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da maio usando 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 Flutter.

A interface do painel da maio usa texto em japonês para marcadores, botões e descrições, e as capturas de tela neste guia não foram traduzidas. No entanto, nas descrições e instruções aqui, os marcadores e botões são mencionados pelos equivalentes em inglês. "esquema de 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
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado
Nativo

Pré-requisitos

Antes de continuar, verifique o seguinte:

  • Versão mais recente do Google Mobile Ads Flutter Plugin.
  • Versão 3.7.0 ou mais recente da estrutura do Flutter.
  • Para implantação no Android
    • API Android nível 24 ou mais recente.
  • Para implantação no iOS
    • Destino de implantação do iOS 15.0 ou mais recente.
  • Um projeto do Flutter em funcionamento configurado com Google Mobile Ads Flutter Plugin. Consulte Configurar Google Mobile Ads Flutter Plugin para mais detalhes.
  • Configure a mediação.

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

    Primeiro, inscreva-se ou faça login na sua conta da maio. Clique no botão Application management na barra lateral esquerda e em New app.

    Selecione a guia correspondente ao tipo de anúncio preferido.

    Intersticial

    Insira o Name do seu app, selecione a plataforma e forneça o URL do aplicativo. Selecione Video interstitial como o tipo de anúncio e, em seguida, clique em Update.

    Android

    iOS

    Premiado

    Insira o Name do seu app, selecione a plataforma e forneça o URL do aplicativo. Selecione Video Rewards como o tipo de anúncio e clique em Update.

    Android

    iOS

    Na página Application Management, anote o código da mídia. Ele é necessário para configurar o bloco de anúncios do Ad Manager na próxima seção.

    Android

    iOS

    Na página Zone Management, anote o Zone ID. Ele também será necessário para configurar o bloco de anúncios do Ad Manager na próxima seção.

    Android

    iOS

    (Somente em cascata) Além do código da mídia e do Zone ID, você vai precisar do API ID e chave de API para configurar o ID do bloco de anúncios para mediação. Na página Reporting API, anote o API ID e a chave de 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

    Android

    Para instruções, consulte a etapa 2 no guia para Android.

    iOS

    Para instruções, consulte a etapa 2 no guia para iOS.

    Etapa 3: importar o SDK e o adaptador da maio

    Integração pelo pub.dev

    (Somente Android) Adicione os seguintes repositórios ao arquivo build.gradle dentro do diretório android do seu projeto:

      repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://imobile-maio.github.io/maven")
      }
  }

    Adicione a seguinte dependência com as versões mais recentes do SDK e do adaptador da maio no arquivo pubspec.yaml do pacote:

    dependencies:
  gma_mediation_maio: ^1.1.8

    Integração manual

    Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para maio, extraia o arquivo baixado e adicione a pasta do plug-in extraído (e o conteúdo dela) ao seu projeto do Flutter. Em seguida, faça referência ao plug-in no arquivo pubspec.yaml adicionando a seguinte dependência:

    dependencies:
  gma_mediation_maio:
    path: path/to/local/package

    Etapa 4: adicionar o código necessário

    Android

    Nenhum código adicional é necessário para a integração da maio.

    iOS

    Integração da SKAdNetwork

    Siga a documentação da maio para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do seu projeto.

    Etapa 5: testar a implementação

    Ativar anúncios de teste

    Certifique-se de registrar seu dispositivo de teste para Ad Manager.

    Os editores que usam a versão 7.26.0 ou mais recente de Google Mobile Ads Flutter Plugin 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 do erro

    Se o adaptador não receber um anúncio da maio, os editores poderão verificar o erro subjacente na resposta do anúncio usando ResponseInfo nas seguintes classes:

    Android

    Formato Nome da classe
    Intersticial jp.maio.sdk.android.mediation.admob.adapter.Interstitial
    Premiado jp.maio.sdk.android.mediation.admob.adapter.Rewarded

    iOS

    Formato Nome da classe
    Intersticial GADMMaioInterstitialAdapter
    Premiado GADMMaioRewardedAdapter

    Confira os códigos e as mensagens correspondentes gerados pelo adaptador da maio quando um anúncio não é carregado:

    Android

    Código do erro Motivo
    0-10 A maio retornou um erro específico do SDK. Consulte o código e a documentação da maio para mais detalhes.
    101 A maio não tem um anúncio disponível.
    102 Parâmetros de servidor inválidos (por exemplo, ID de lugar ausente).
    103 O contexto usado para carregar um anúncio não era uma instância `Activity`.

    iOS

    Código do erro Motivo
    0-10 A maio retornou um erro específico do SDK. Consulte o código da maio para mais detalhes.
    101 A maio ainda não tem um anúncio disponível.
    102 Parâmetros de servidor inválidos (por exemplo, ID de lugar ausente).
    103 O adaptador da maio não oferece suporte ao formato do 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 Flutter

    Versão 1.1.8

    • Oferece suporte à versão 2.0.9.1 do adaptador da maio para Android .
    • Oferece suporte à versão 2.2.3.0 do adaptador da maio para iOS .
    • Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.1.7

    • Atualizado para oferecer suporte à versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.
    • Adicionamos suporte ao Gerenciador de Pacotes do Swift.
    • Oferece suporte à versão 2.0.9.0 do adaptador da maio para Android.
    • Oferece suporte à versão 2.2.2.0 do adaptador da maio para iOS.
    • Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.1.6

    • Oferece suporte à versão 2.0.9.0 do adaptador da maio para Android.
    • Oferece suporte à versão 2.2.1.2 do adaptador da maio para iOS .
    • Criado e testado com a versão 9.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.1.5

    • Oferece suporte à versão 2.0.8.2 do adaptador da maio para Android .
    • Oferece suporte à versão 2.2.1.2 do adaptador da maio para iOS .
    • Criado e testado com a versão 8.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.1.4

    • Atualizamos a versão mínima do Flutter para 3.38.1.
    • Atualizado para oferecer suporte à versão 8.0.0 do plug-in do Google Mobile Ads para Flutter.
    • Oferece suporte à versão 2.0.8.2 do adaptador da maio para Android .
    • Oferece suporte à versão 2.2.1.1 do adaptador da maio para iOS .
    • Criado e testado com a versão 8.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.1.3

    • Oferece suporte à versão 2.0.7.0 do adaptador da maio para Android.
    • Oferece suporte à versão 2.2.0.3 do adaptador da maio para iOS .
    • Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.1.2

    • Atualizamos a versão mínima do Flutter para 3.35.1
    • Atualizado para oferecer suporte à versão 7.0.0 do plug-in do Google Mobile Ads para Flutter
    • Oferece suporte à versão 2.0.8.0 do adaptador da maio para Android .
    • Oferece suporte à versão 2.2.0.1 do adaptador da maio para iOS.

    Versão 1.1.1

    • Oferece suporte à versão 2.0.7.0 do adaptador da maio para Android.
    • Oferece suporte à versão 2.2.0.1 do adaptador da maio para iOS.
    • Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.1.0

    • Oferece suporte à versão 2.0.6.0 do adaptador da maio para Android.
    • Oferece suporte à versão 2.2.0.0 do adaptador da maio para iOS .
    • Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.0.3

    • Oferece suporte à versão 2.0.5.0 do adaptador da maio para Android .
    • Oferece suporte à versão 2.1.6.1 do adaptador da maio para iOS .
    • Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.0.2

    • Oferece suporte à versão 2.0.4.0 do adaptador da maio para Android.
    • Oferece suporte à versão 2.1.6.1 do adaptador da maio para iOS .
    • Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.0.1

    • Oferece suporte à versão 2.0.3.1 do adaptador da maio para Android .
    • Oferece suporte à versão 2.1.6.1 do adaptador da maio para iOS .
    • Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.0.0

    • Versão inicial.
    • Oferece suporte à versão 2.0.3.0 do adaptador da maio para Android .
    • Oferece suporte à versão 2.1.6.0 do adaptador da maio para iOS .
    • Criado e testado com a versão 5.3.1 do plug-in do Google Mobile Ads para Flutter.