Integrar a BidMachine com a mediação

Este guia mostra como usar o Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da BidMachine com 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 do 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 hierarquia 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 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 Começar para mais detalhes.
  • Configure 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 canais

    Navegue até a guia Origem e, na tabela Origens, selecione o botão Editar.

    Painel de origens

    Uma lista com todas as suas posições será mostrada. Para criar uma nova posição, clique no botão Adicionar posição na caixa de diálogo.

    Caixa de diálogo "Editar origem"

    Selecione Lances como o Tipo de canal. Preencha o formulário e clique em Salvar.

    Android

    Criar posicionamento do Android

    iOS

    Criar posição para iOS

    Por fim, anote o ID de lugar.

    Android

    Detalhes do posicionamento do Android

    iOS

    Detalhes do posicionamento para 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 para a BidMachine, acesse a guia app-ads.txt no painel. Em seguida, copie a lista e adicione-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

    (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://artifactory.bidmachine.io/bidmachine")
      }
  }

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

    dependencies:
  gma_mediation_bidmachine: ^1.5.1

    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 a 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

    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.0.0 e mais recentes do adaptador da BidMachine para Flutter aceitam a transmissão de indicadores de consentimento do GDPR de plataformas de gestão de consentimento que se integram ao Estrutura de Transparência e Consentimento (TCF) do IAB para o SDK da BidMachine. Para mais informações, consulte a documentação 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 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

    Não é necessário nenhum código adicional para a integração da BidMachine.

    iOS

    Integração da SKAdNetwork

    Siga a documentação da BidMachine sobre a compatibilidade com a 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

    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 publishers poderão verificar o erro subjacente 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 O ID de lugar recebido é inválido ou está vazio.
    101 com.google.ads.mediation.bidmachine Erro durante a coleta de indicadores: nenhuma configuração de dados de indicador foi encontrada.
    102 com.google.ads.mediation.bidmachine O formato do anúncio recebido durante a coleta de indicadores é inválido.
    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 da BidMachine carregada 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 de 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 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 de tela cheia não está pronto para ser exibido.
    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 Falha ao carregar uma das origens de imagem do anúncio nativo.
    108 com.google.mediation.bidmachine A BidMachine não é compatível com esse tamanho de anúncio de banner.

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

    Versão 1.5.1

    Versão 1.5.0

    Versão 1.4.2

    Versão 1.4.1

    Versão 1.4.0

    Versão 1.3.2

    Versão 1.3.1

    Versão 1.3.0

    Versão 1.2.0

    Versão 1.1.0

    Versão 1.0.0