Integrar a maio com a mediação

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

Este guia mostra como usar o Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da maio usando a mediação, abrangendo 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 do Flutter.

A interface do painel da 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 aqui, os rótulos 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 do framework do Flutter.
  • Para implantar no Android
    • API Android nível 24 ou mais recente.
  • Para implantar 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 o 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 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 aplicativo. Selecione Intersticial em vídeo como o Tipo de anúncio e clique em Atualizar.

    Android

    iOS

    Premiado

    Insira o Nome do app, selecione a plataforma e informe o URL do aplicativo. Selecione Vídeo premiado como o Tipo de anúncio e clique em Atualizar.

    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 Gerenciamento de zonas, anote o ID da zona. Ele também será necessário para configurar o bloco de anúncios do Ad Manager na próxima seção.

    Android

    iOS

    (Somente hierarquia) Além do código da mídia e do ID da zona, você vai precisar do ID da API e da chave de API para configurar o ID do bloco de anúncios para mediação. Na página API Reporting, anote o ID da API 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 para Android) Adicione os seguintes repositórios ao arquivo build.gradle no 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 seu 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

    Não é necessário nenhum código adicional para a integração do 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

    Registre seu dispositivo de teste no Ad Manager.

    Os publishers que usam a versão 7.26.0 ou mais recente do 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 de erro

    Se o adaptador não receber um anúncio da maio, os publishers 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 de "Activity".

    iOS

    Código do erro Motivo
    0-10 A maio retornou um erro específico do SDK. Consulte o código do 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 do maio não é compatível com o 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 da maio para Flutter

    Versão 1.1.8

    Versão 1.1.7

    Versão 1.1.6

    Versão 1.1.5

    Versão 1.1.4

    Versão 1.1.3

    Versão 1.1.2

    Versão 1.1.1

    Versão 1.1.0

    Versão 1.0.3

    Versão 1.0.2

    Versão 1.0.1

    Versão 1.0.0