Este guia mostra como usar Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da BidMachine usando a Mediação da AdMob, incluindo as integrações de lances. Ele explica como adicionar a BidMachine à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da BidMachine a um app Flutter.
Integrações e formatos de anúncio aceitos
O adaptador de mediação da AdMob para BidMachine tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | 1 |
| Cascata | |
| Formatos | |
| Abertura do aplicativo | |
| Banner | |
| Intersticial | |
| Premiado | |
| Intersticial premiado | |
| Nativo | 2 |
1 A integração de lances está em versão Beta fechada. Entre em contato com seu gerente de contas para solicitar acesso.
2 O formato de anúncio nativo está em versão Alfa. Todos os outros formatos de anúncio compatíveis estão na versão Beta. Entre em contato com seu gerente de contas para solicitar acesso.
Requisitos
- Mais recentes de Google Mobile Ads Flutter Plugin
- Flutter 3.7.0 ou versão mais recente
- Para implantar no Android
- API Android nível 23 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 Começar para mais detalhes.
- Leia todo o guia para iniciantes da mediação.
Etapa 1: definir as configurações na interface da BidMachine
Faça login no painel da sua conta da BidMachine.
Criar novos canais
Navegue até a guia Origem e, na tabela Origens, selecione o botão Editar.
Uma lista com todas as posições será mostrada. Para criar uma nova posição, clique no botão Adicionar posição na caixa de diálogo.
Preencha o formulário e clique em Salvar.
Android
iOS
Por fim, anote o ID da posição.
Android
iOS
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 na BidMachine, navegue até a guia app-ads.txt no Painel. Em seguida, copie a lista e
adicione ao arquivo app-ads.txt do seu site.
Etapa 2: configurar a demanda da BidMachine 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 BidMachine à 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 BidMachine à 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 BidMachine
Integração pelo pub.dev
Adicione a seguinte dependência com as versões mais recentes do SDK e do adaptador do BidMachine ao arquivo pubspec.yaml do pacote:
dependencies:
gma_mediation_bidmachine: ^1.3.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 BidMachine, 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_bidmachine:
path: path/to/local/package
Etapa 4: implementar configurações de privacidade no SDK da BidMachine
Consentimento da UE e GDPR
Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer determinadas declarações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de receber o consentimento deles para o uso de cookies ou outros armazenamentos locais quando exigido por lei e para a coleta, o compartilhamento e o uso de dados pessoais para a 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. O Google não consegue transmitir automaticamente a escolha de consentimento do usuário para essas redes.
A BidMachine lê automaticamente o consentimento do GDPR definido por plataformas de gestão de consentimento, incluindo o SDK da UMP. Para mais informações, consulte o guia da GDPR da BidMachine para Android e iOS.
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.
A BidMachine lê automaticamente o consentimento da GPP definido por plataformas de gestão de consentimento, incluindo o SDK da UMP. Para mais informações, consulte o guia da GPP da BidMachine para Android e iOS.
Etapa 5: adicionar o código necessário
Android
Nenhum código adicional é necessário para a integração da BidMachine.
iOS
Integração da SKAdNetwork
Siga a documentação da BidMachine sobre
Suporte à SKAdNetwork
para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.
Etapa 6: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste na AdMob.
Siga as instruções na documentação da BidMachine para Android e iOS para ativar o modo de teste da BidMachine.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste da BidMachine, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios BidMachine (lances).
Códigos de erro
Se o adaptador não receber um anúncio da BidMachine, os editores poderão verificar
o erro na resposta do anúncio usando
ResponseInfo nas
seguintes classes:
Android
io.bidmachine
com.google.ads.mediation.bidmachine
iOS
GADMediationAdapterBidMachine
Confira os códigos e as mensagens correspondentes gerados pelo adaptador da BidMachine quando um anúncio não é carregado:
Android
| Código do erro | Domínio | Motivo |
|---|---|---|
| 100 | com.google.ads.mediation.bidmachine | ID de posição inválido ou vazio recebido. |
| 101 | com.google.ads.mediation.bidmachine | Erro durante a coleta de indicadores: nenhuma configuração de dados de indicadores encontrada. |
| 102 | com.google.ads.mediation.bidmachine | Formato de anúncio inválido recebido durante a coleta de indicadores. |
| 103 | com.google.ads.mediation.bidmachine | Não foi possível mapear o tamanho de anúncio solicitado para bidmachine.BannerSize |
| 104 | com.google.ads.mediation.bidmachine | A solicitação de anúncio carregada da BidMachine expirou. |
| 105 | com.google.ads.mediation.bidmachine | Não foi possível mostrar o anúncio em tela cheia. |
| 106 | com.google.ads.mediation.bidmachine | O SDK da BidMachine retornou um callback onAdLoaded() com dados de anúncio null. |
iOS
| Código do erro | Domínio | Motivo |
|---|---|---|
| 101 | com.google.mediation.bidmachine | A configuração do servidor não tem um ID de publisher obrigatório. |
| 102 | com.google.mediation.bidmachine | A solicitação de coleta de indicadores de lances falhou porque os parâmetros do RTB não contêm o formato do anúncio ou o formato especificado não é compatível. |
| 103 | com.google.mediation.bidmachine | Configuração de anúncio inválida para carregar um anúncio. |
| 104 | com.google.mediation.bidmachine | O SDK BidMachine retornou um anúncio que não era de banner para o método delegado BidMachineAdProtocol didLoadAd do anúncio de banner. Isso nunca deve acontecer. |
| 105 | com.google.mediation.bidmachine | O anúncio em tela cheia não está pronto para apresentação. |
| 106 | com.google.mediation.bidmachine | O SDK da Bid Machine retornou um anúncio não nativo para o método delegado BidMachineAdProtocol didLoadAd do anúncio nativo. Isso nunca deve acontecer. |
| 107 | com.google.mediation.bidmachine | Não foi possível carregar uma das fontes de imagem do anúncio nativo. |
Registro de alterações do adaptador de mediação do Flutter da BidMachine
Versão 1.3.1 (em andamento)
Versão 1.3.0
- Compatível com a versão 3.5.0.0 do adaptador Android da BidMachine.
- Compatível com a versão 3.5.0.0 do adaptador iOS da BidMachine.
- Criado e testado com a versão 6.0.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.
Versão 1.2.0
- Compatível com a versão 3.5.0.0 do adaptador Android da BidMachine.
- Compatível com a versão 3.4.0.2 do adaptador iOS da BidMachine.
- Criado e testado com a versão 6.0.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.
Versão 1.1.0
- Compatibilidade com a versão 3.4.0.0 do adaptador Android da BidMachine.
- Compatível com a versão 3.4.0.1 do adaptador iOS da BidMachine.
- Criado e testado com a versão 6.0.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.
Versão 1.0.0
- Versão inicial.
- Compatível com a versão 3.3.0.0 do adaptador Android da BidMachine.
- Compatível com a versão 3.4.0.0 do adaptador iOS da BidMachine.
- Criado e testado com a versão 6.0.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.