Integrar a BidMachine 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 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
Cascata  1
Formatos
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado
Nativo

1 A integração em cascata está na versão Beta fechada . Entre em contato com seu gerente de contas para solicitar acesso.

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 implantação no Android
    • Nível da API do Android 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 o artigo Começar para mais detalhes.
  • Configurar a Mediação da AdMob.

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 Source e, na tabela Sources , selecione o botão Edit.

Painel de origens

Uma lista de todos os canais que você tem será mostrada. Para criar um novo canal, clique no botão Add Placement na caixa de diálogo.

Caixa de diálogo "Editar origem"

Selecione Bidding como o Placement Type. Preencha o formulário e clique em Save.

Android

Criar uma posição do Android

iOS

Criar uma posição do iOS

Por fim, anote o Placement ID.

Android

Detalhes da posição do Android

iOS

Detalhes de canais do 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 dos anúncios, 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 para a BidMachine, navegue até a guia app-ads.txt no Painel. Em seguida, copie a lista e anexe-a 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 dependência abaixo com as versões mais recentes do SDK e do adaptador da BidMachine no arquivo pubspec.yaml do pacote:

dependencies:
  gma_mediation_bidmachine: ^1.4.1

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

dependencies:
  gma_mediation_bidmachine:
    path: path/to/local/package

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

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 do 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 na sua cadeia de mediação que possa participar da venda de informações pessoais e siga as orientações de cada uma dessas redes para garantir a conformidade.

A BidMachine lê automaticamente o consentimento do GPP definido por plataformas de gestão de consentimento , incluindo o SDK da UMP. Para mais informações, consulte o guia do GPP da BidMachine para Android e iOS.

Etapa 5: adicionar o código necessário

Android

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

iOS

Integração da SKAdNetwork

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

Etapa 6: testar a implementação

Ativar anúncios de teste

Certifique-se de registrar 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 BidMachine (lances) origens de anúncios.

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 do canal inválido ou vazio recebido.
101 com.google.ads.mediation.bidmachine Erro durante a coleta de sinais: nenhuma configuração de dados de sinal encontrada.
102 com.google.ads.mediation.bidmachine Formato de anúncio inválido recebido durante a coleta de sinais.
103 com.google.ads.mediation.bidmachine O tamanho do anúncio solicitado não pôde ser mapeado 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 do publisher obrigatório.
102 com.google.mediation.bidmachine A solicitação de coleta de sinais de lances falhou porque os parâmetros de RTB não contêm o formato do anúncio ou o formato especificado está indisponí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 da BidMachine retornou um anúncio que não é 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 BidMachine 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 origens de imagem de anúncio nativo.

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

Versão 1.4.1

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

Versão 1.4.0

  • Atualizado para oferecer suporte à versão 9.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter
  • Oferece suporte à versão 3.7.0.0 do adaptador da BidMachine para Android.
  • Oferece suporte à versão 3.7.1.0 do adaptador da BidMachine para iOS .
  • Criado e testado com a versão 9.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.3.2

  • 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 3.6.1.0 do adaptador da BidMachine para Android.
  • Oferece suporte à versão 3.6.0.0 do adaptador da BidMachine 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.3.1

Versão 1.3.0

Versão 1.2.0

Versão 1.1.0

  • Oferece suporte à versão 3.4.0.0 do adaptador da BidMachine para Android .
  • Oferece suporte à versão 3.4.0.1 do adaptador da BidMachine 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 3.3.0.0 do adaptador da BidMachine para Android .
  • Oferece suporte à versão 3.4.0.0 do adaptador da BidMachine 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.