Este guia mostra como usar o Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da myTarget usando a 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 do Flutter.
Integrações e formatos de anúncio aceitos
| 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 13.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.
Etapa 1: definir as configurações na interface da myTarget
Faça login na sua conta do myTarget. Acesse a página "Apps" clicando em APPS no cabeçalho. Clique em ADICIONAR APP.

Se o app for compatível com as plataformas Android e iOS, configure cada uma delas separadamente.
Android
Em seguida, informe o URL do Google Play do seu app.

iOS
Em seguida, informe o URL do iTunes** do seu app.

Ao adicionar um app, o myTarget exige que você crie um bloco de anúncios antes de concluir o processo.
Banner
Selecione BANNER entre os formatos de anúncio disponíveis e clique no botão ADICIONAR BLOCO DE ANÚNCIOS.

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

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

Nativo
Selecione NATIVO entre os 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 espaço, que pode ser encontrado nas configurações do bloco como slot_id. Esse ID será usado para configurar seu 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 Create Token ou Show Token para ver seu token de acesso permanente do 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 o app-ads.txt para a 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 ver as instruções, consulte a etapa 2 no guia para Android.
iOS
Para instruções, consulte a etapa 2 no guia para iOS.
Adicionar o 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 o 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 seguinte dependência com as versões mais recentes do SDK e do adaptador da myTarget no arquivo pubspec.yaml do seu pacote:
dependencies:
gma_mediation_mytarget: ^1.15.0
Integração manual
Baixe a 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 seguinte dependência:
dependencies:
gma_mediation_mytarget:
path: path/to/local/package
Etapa 4: implementar configurações de privacidade no SDK da myTarget
Consentimento da UE e do GDPR
Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer certas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça e obter o consentimento deles para usar cookies ou outra forma de armazenamento local, quando exigido por lei, e para coletar, compartilhar e usar dados pessoais para personalização de anúncios. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Você é responsável por verificar se o consentimento é propagado para cada origem de anúncios na sua cadeia de mediação.
A versão 1.13.0 e mais recentes do adaptador da myTarget para Flutter aceitam a transmissão de indicadores de consentimento do GDPR do SDK da UMP e de plataformas de gestão de consentimento que se integram à especificação de consentimento adicional do Google para o SDK da myTarget.
Leis Estaduais de Privacidade dos EUA
As leis de privacidade dos estados dos EUA exigem que os usuários tenham o direito de recusar a "venda" das próprias "informações pessoais" (conforme a definição desses termos na lei). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de conformidade com as leis estaduais de privacidade dos EUA oferece a opção de ativar o tratamento de dados restrito para a veiculação de anúncios do Google, mas não é possível aplicar essa configuração a cada rede de publicidade na sua cadeia de mediação. Portanto, identifique cada rede de publicidade que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.
Consulte a seção sobre as leis estaduais de privacidade dos EUA nos guias para desenvolvedores do Android e do iOS.
Etapa 5: adicionar o código necessário
Android
Não é necessário nenhum código adicional para a integração com a 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
Não se esqueça de registrar seu dispositivo de teste na AdMob e ativar 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 origens de anúncios myTarget (hierarquia).
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 aceito pela myTarget. |
| 103 | A solicitação de anúncio não é uma solicitação de anúncio nativo unificado. |
| 104 | O anúncio nativo carregado do myTarget é diferente do solicitado. |
| 105 | O anúncio nativo carregado do myTarget não tem alguns recursos obrigatórios (por exemplo, imagem ou ícone). |
| 106 | O SDK da myTarget não conseguiu mostrar o anúncio. |
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 do myTarget não é compatível com o formato de anúncio solicitado. |
| 103 | Tentativa de mostrar um anúncio do myTarget que não foi carregado. |
| 104 | O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela myTarget. |
| 105 | Recursos de anúncios nativos obrigatórios ausentes. |
Registro de alterações do adaptador de mediação da myTarget para Flutter
Versão 1.16.0 (em andamento)
Versão 1.15.0
- Compatível com a versão 5.52.5.0 do adaptador da myTarget para Android.
- Compatível com a versão 5.46.0.0 do adaptador myTarget para iOS.
- Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.14.1
- Compatível com a versão 5.51.2.1 do adaptador do myTarget para Android.
- Compatível com a versão 5.46.0.0 do adaptador myTarget para iOS.
- Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.14.0
- Compatível com a versão 5.51.2.0 do adaptador do myTarget para Android.
- Compatível com a versão 5.46.0.0 do adaptador myTarget para iOS.
- Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.13.0
- 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.
- Compatível com a versão 5.51.2.0 do adaptador do myTarget para Android.
- Compatível com a versão 5.45.0.1 do adaptador do myTarget para iOS.
- Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.
Version 1.12.0
- Compatível com a versão 5.47.1.1 do adaptador do myTarget para Android.
- Compatível com a versão 5.45.0.0 do adaptador do myTarget para iOS.
- Criado e testado com a versão 9.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.11.0
- Atualizamos para oferecer suporte à versão 9.0.0 do plug-in do Google Mobile Ads para Flutter.
- Compatível com a versão 5.47.1.0 do adaptador do myTarget para Android.
- Compatível com a versão 5.43.0.0 do adaptador do myTarget para iOS.
- Criado e testado com a versão 9.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.10.0
- Compatível com a versão 5.47.1.0 do adaptador do myTarget para Android.
- Compatível com a versão 5.42.1.0 do adaptador do myTarget para iOS.
- Criado e testado com a versão 8.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.9.0
- Atualizamos a versão mínima do Flutter para 3.38.1.
- Atualizamos para oferecer suporte à versão 8.0.0 do plug-in do Google Mobile Ads para Flutter.
- Compatível com a versão 5.27.4.1 do adaptador do myTarget para Android.
- Compatível com a versão 5.39.1.0 do adaptador do myTarget para iOS.
- Criado e testado com a versão 8.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.8.0
- Compatível com a versão 5.27.4.1 do adaptador do myTarget para Android.
- Compatível com a versão 5.39.1.0 do adaptador do myTarget para iOS.
- Criado e testado com a versão 7.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.7.1
- 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.
- Compatível com a versão 5.27.4.0 do adaptador do myTarget para Android.
- Compatível com a versão 5.38.0.0 do adaptador do myTarget para iOS.
- Criado e testado com a versão 7.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.7.0
- Compatível com a versão 5.27.4.0 do adaptador do myTarget para Android.
- Compatível com a versão 5.38.0.0 do adaptador do myTarget para iOS.
- Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.6.0
- Compatível com a versão 5.27.4.0 do adaptador do myTarget para Android.
- Compatível com a 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 do Google Mobile Ads para Flutter.
Versão 1.5.0
- Compatível com a versão 5.27.3.0 do adaptador do myTarget para Android.
- Compatível com a versão 5.36.0.0 do adaptador do myTarget para iOS.
- Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.4.0
- Compatível com a versão 5.27.2.0 do adaptador do myTarget para Android.
- Compatível com a versão 5.33.0.0 do adaptador do myTarget para iOS.
- Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.3.0
- Compatível com a versão 5.27.1.1 do adaptador do myTarget para Android.
- Compatível com a 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 do Google Mobile Ads para Flutter.
Versão 1.2.0
- Compatível com a versão 5.27.1.1 do adaptador do myTarget para Android.
- Compatível com a versão 5.29.1.0 do adaptador do myTarget 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
- Compatível com a versão 5.27.1.1 do adaptador do myTarget para Android.
- Compatível com a versão 5.28.0.0 do adaptador do myTarget 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.
- Compatível com a versão 5.27.1.0 do adaptador do myTarget para Android.
- Compatível com a 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 do Google Mobile Ads para Flutter.