Integrar o myTarget com a Mediação

Selecione a plataforma: Android Novo Android iOS Unity Flutter

Este guia mostra como usar Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da myTarget usando mediação, incluindo integrações em hierarquia. Ele explica como adicionar a myTarget à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da myTarget a um app Flutter.

Integrações e formatos de anúncio aceitos

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Intersticial premiado
Nativo

Requisitos

  • Mais recente Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 ou versão mais recente
  • Para implantação no Android
    • API Android nível da API 23 ou mais recente
  • Para implantação no iOS
    • Destino de implantação do iOS 13.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.
  • Configurar a Mediação da AdMob.

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

Faça login na sua conta da myTarget. Acesse a página "Apps" clicando em APPS no cabeçalho. Adicione seu app clicando em ADICIONAR APP.

Se o app for compatível com as plataformas Android e iOS, você precisará configurar cada uma delas separadamente.

Android

Em seguida, forneça o URL do Google Play do seu app.

iOS

Em seguida, forneça o URL do iTunes** do seu app.

Ao adicionar um app, a myTarget exige que você crie um bloco de anúncios antes de concluir o processo.

Selecione BANNER nos formatos de anúncio disponíveis e clique no botão ADICIONAR BLOCO DE ANÚNCIOS.

Intersticial

Selecione INTERSTICIAL nos formatos de anúncio disponíveis e clique no botão ADICIONAR BLOCO DE ANÚNCIOS.

Premiado

Selecione VÍDEO PREMIADO nos formatos de anúncio disponíveis e clique no botão ADICIONAR BLOCO DE ANÚNCIOS.

Nativo

Selecione NATIVO nos formatos de anúncio disponíveis e clique em ADICIONAR BLOCO DE ANÚNCIOS.

Na página de detalhes do bloco de anúncios, anote o ID do slot, que pode ser encontrado nas configurações do bloco de anúncios como slot_id. Esse ID do slot será usado para configurar o bloco de anúncios da AdMob na próxima seção.

Além do slot_id, você também vai precisar do token de acesso permanente da myTarget para configurar o ID do bloco de anúncios da AdMob. Acesse a guia Perfil e selecione Tokens de acesso. Clique em Criar token ou Mostrar token para conferir seu token de acesso permanente da myTarget.

Atualizar o app-ads.txt

Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita de publicidade, implemente um arquivo app-ads.txt. Se ainda não fez isso, configure um arquivo app-ads.txt para seu app.

Para implementar app-ads.txt na myTarget, consulte Como criar e publicar um arquivo.

Ativar o modo de teste

Siga as instruções na documentação da myTarget para adicionar e configurar um dispositivo de teste na interface da myTarget.

Etapa 2: configurar a demanda da myTarget na interface da AdMob

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.

Adicionar a Mail.ru à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA

Siga as etapas em Configurações das regulamentações europeias e Configurações das regulamentações estaduais dos EUA para adicionar a Mail.ru à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface da AdMob.

Etapa 3: importar o SDK e o adaptador da myTarget

Integração pelo pub.dev

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

dependencies:
  gma_mediation_mytarget: ^1.9.0

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 myTarget, 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 dependência abaixo:

dependencies:
  gma_mediation_mytarget:
    path: path/to/local/package

Etapa 4: implementar configurações de privacidade no SDK da myTarget

Para instruções, consulte a etapa 4 no guia para Android e iOS.

Etapa 5: adicionar o código necessário

Android

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

iOS

Integração da SKAdNetwork

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

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste na AdMob e ative o modo de teste na interface da myTarget.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste da myTarget, ative o teste de uma única origem de anúncios no Ad Inspector usando as myTarget (hierarquia) origens de anúncios.

Códigos de erro

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

Android

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

iOS

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

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

Android

Código do erro Motivo
100 O SDK da myTarget retornou um erro.
101 Os parâmetros do servidor da myTarget configurados na interface da AdMob estão ausentes ou são inválidos.
102 O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com a myTarget.
103 A solicitação de anúncio não é uma solicitação de anúncio nativo unificado.
104 O anúncio nativo carregado da myTarget é diferente do solicitado.
105 O anúncio nativo carregado da myTarget não tem alguns recursos obrigatórios (por exemplo, imagem ou ícone).

iOS

Código do erro Motivo
100 O SDK da myTarget ainda não tem um anúncio disponível.
101 Os parâmetros do servidor da myTarget configurados na interface da AdMob estão ausentes ou são inválidos.
102 O adaptador da myTarget não oferece suporte ao formato de anúncio solicitado.
103 Tentativa de mostrar um anúncio da myTarget que não está carregado.
104 O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com a myTarget.
105 Faltam recursos obrigatórios do anúncio nativo.

Registro de alterações do adaptador de mediação da myTarget para Flutter

Versão 1.9.0

  • Versão mínima do Flutter atualizada para 3.38.1.
  • Atualizado para oferecer suporte à versão 8.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
  • Oferece suporte à versão 5.27.4.1 do adaptador da myTarget para Android .
  • Oferece suporte à versão 5.39.1.0 do adaptador da myTarget para iOS .
  • Criado e testado com a versão 8.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.8.0

  • Oferece suporte à versão 5.27.4.1 do adaptador da myTarget para Android .
  • Oferece suporte à versão 5.39.1.0 do adaptador da myTarget para iOS .
  • Criado e testado com a versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.7.1

  • Versão mínima do Flutter atualizada para 3.35.1
  • Atualizado para oferecer suporte à versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter
  • Oferece suporte à versão 5.27.4.0 do adaptador da myTarget para Android .
  • Oferece suporte à versão 5.38.0.0 do adaptador da myTarget para iOS .
  • Criado e testado com a versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.7.0

  • Oferece suporte à versão 5.27.4.0 do adaptador da myTarget para Android .
  • Oferece suporte à versão 5.38.0.0 do adaptador da myTarget para iOS .
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.6.0

  • Oferece suporte à versão 5.27.4.0 do adaptador da myTarget para Android .
  • Oferece suporte à versão 5.37.1.0 do adaptador da myTarget para iOS .
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.5.0

Versão 1.4.0

  • Oferece suporte à versão 5.27.2.0 do adaptador da myTarget para Android .
  • Oferece suporte à versão 5.33.0.0 do adaptador da myTarget para iOS .
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.3.0

  • Oferece suporte à versão 5.27.1.1 do adaptador da myTarget para Android .
  • Oferece suporte à versão 5.31.1.0 do adaptador da myTarget para iOS .
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.2.0

  • Oferece suporte à versão 5.27.1.1 do adaptador da myTarget para Android .
  • Oferece suporte à versão 5.29.1.0 do adaptador da myTarget para iOS .
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.1.0

  • Oferece suporte à versão 5.27.1.1 do adaptador da myTarget para Android .
  • Oferece suporte à versão 5.28.0.0 do adaptador da myTarget para iOS .
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.0.0

  • Versão inicial.
  • Oferece suporte à versão 5.27.1.0 do adaptador da myTarget para Android .
  • Oferece suporte à versão 5.24.1.0 do adaptador da myTarget para iOS .
  • Criado e testado com a versão 5.3.1 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.