Integrar a BidMachine com a mediação

Selecione a plataforma: Android Android iOS Unity Flutter

Este guia mostra como usar GMA Next-Gen SDK para carregar e exibir anúncios da BidMachine usando a mediação, 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 Android.

Integrações e formatos de anúncio aceitos

O adaptador de mediação da BidMachine tem os seguintes recursos:

Integração
Lances
Cascata	^1
Formatos
Abertura do app
Banner
Intersticial
Premiado
Intersticial premiado
Nativo

¹ A integração em cascata está em beta fechado. Entre em contato com seu gerente de contas para solicitar acesso.

Requisitos

• API Android nível 24 ou mais recente

• [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o adaptador da BidMachine 3.4.0.1 ou uma versão mais recente (recomendamos usar a última versão).

• Mais recentes de GMA Next-Gen SDK

• 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.

Observação: a BidMachine cria automaticamente uma origem para você. Se você quiser criar uma nova Origem, entre em contato com seu gerente de contas.

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.

Por fim, anote o ID da posição.

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, crie um arquivo app-ads.txt para o Ad Manager.

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 do Ad Manager

Faça login na sua conta do Ad Manager.

Adicionar a BidMachine em "Empresas"

Lances

Essa etapa não é necessária para integrações de lances.

Cascata

Acesse Administrador > Empresas e clique no botão Nova empresa na guia Todas as empresas. Selecione Rede de publicidade.

Selecione BidMachine como a Rede de publicidade, insira um Nome exclusivo e ative a Mediação.

Não é necessário inserir um Nome de usuário ou uma Senha. Clique em Salvar quando terminar.

Ativar o compartilhamento de indicador seguro

Lances

Acesse Administrador > Configurações globais. Acesse a guia Configurações da conta do Ad Exchange e ative a opção Compartilhamento de indicador seguro. Clique em Salvar.

Cascata

Essa etapa não é necessária para integrações em cascata.

Compartilhar indicadores seguros em solicitações de lance

Lances

Acesse Inventário > Indicadores seguros. Em Indicadores seguros, pesquise BidMachineToken e ative a opção Ativar integração com o app.

Clique em Salvar.

Cascata

Essa etapa não é necessária para integrações em cascata.

Permitir o compartilhamento de indicadores seguros para Lances do SDK

Lances

Acesse Exibição > Configurações do canal de demanda. Na guia Configurações padrão, ative a opção Permitir o compartilhamento de indicadores seguros para Lances do SDK.

Clique em Salvar.

Cascata

Essa etapa não é necessária para integrações em cascata.

Configurar os lances da BidMachine

Lances

Acesse Exibição > Bidders e clique em Acessar os Lances do SDK.

Clique em Novo bidder.

Selecione BidMachine como o bidder.

Clique em Continuar para ativar os lances do SDK para esse bidder.

Clique em Concluído.

Cascata

Essa etapa não é necessária para integrações em cascata.

Configurar o mapeamento de blocos de anúncios

Lances

Acesse Exibição > Bidders e clique em Acessar os Lances do SDK.

Selecione a empresa para a BidMachine.

Acesse a guia Mapeamento de bloco de anúncios e clique em Novo mapeamento de bloco de anúncios.

Escolha Bloco de anúncios específico. Selecione um bloco e um formato de anúncios, App para dispositivos móveis como o Tipo de inventário e seu Aplicativo para dispositivos móveis. Em seguida, insira o ID da origem e o ID do posicionamento obtidos na seção anterior.

Por fim, clique em Salvar.

Importante: segmente o bloco de anúncios selecionado por pelo menos um grupo de rendimento, e o ID da origem precisa estar associado ao app segmentado, como na interface da BidMachine.

Cascata

Acesse Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento. Selecione seu Aplicativo para dispositivos móveis.

Role a tela para baixo e clique em Adicionar parceiro de rendimento.

Selecione a empresa que você criou para a BidMachine na seção anterior. Escolha Mediação do SDK para dispositivos móveis como o Tipo de integração, Android como a Plataforma e Ativo como o Status.

Insira o ID da posição obtido na seção anterior e o valor do CPM padrão. Clique em Salvar.

Importante: o ID da origem precisa estar associado ao app segmentado, como na interface da BidMachine.

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

Importante: verifique se você tem permissão de gerenciamento da conta para concluir a configuração do consentimento da UE e do GDPR, das regulamentações estaduais dos EUA e da plataforma de mensagens de usuários. Consulte Gerenciar o acesso do usuário à sua conta para mais detalhes.

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 do Ad Manager.

Etapa 3: importar o SDK e o adaptador da BidMachine

Observação: a falha na integração das versões compatíveis do SDK da BidMachine e do SDK dos anúncios para dispositivos móveis do Google pode causar problemas de build.

Integração com o Android Studio (recomendada)

No arquivo gradle do app, adicione as seguintes dependências e configurações de implementação:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.1")
    implementation("com.google.ads.mediation:bidmachine:3.7.0.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.1'
    implementation 'com.google.ads.mediation:bidmachine:3.7.0.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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 GDPR.

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 GPP.

Etapa 5: adicionar o código necessário

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

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste no Ad Manager.

Siga as instruções na documentação da BidMachine para Android e ative o modo de teste da BidMachine.

Importante: desative o modo de teste do Ad Manager e da BidMachine antes de lançar o app.

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).

Etapas opcionais

Anúncios nativos

Renderização do anúncio

O adaptador da BidMachine retorna os anúncios nativos como objetos NativeAd. Ele preenche os seguintes campos para um NativeAd.

Campo	Recursos sempre incluídos pelo adaptador da BidMachine
Título
Imagem
Corpo
Ícone
Call-to-action
Classificação por estrela
Loja
Preço
Advertiser

Códigos de erro

Se o adaptador não receber um anúncio da BidMachine, verifique o erro subjacente na resposta do anúncio usando ResponseInfo.getAdSourceResponses() nas seguintes classes:

io.bidmachine
com.google.ads.mediation.bidmachine

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

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.

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

Próxima versão

• Mapeia AgeRestrictedTreatment para a API da COPPA da BidMachine.

Versão 3.7.0.0

• Compatibilidade verificada com a versão 3.7.0 do SDK da BidMachine.

Criado e testado com:

• Versão 25.1.0 do SDK do Google Mobile Ads.
• Versão 1.1.0 do SDK do Google Mobile Ads Next-Gen.
• Versão 3.7.0 do SDK da BidMachine.

Versão 3.6.1.0

• Adicionada propriedade para criar o adaptador com a dependência do SDK do GMA Next-Gen.
• Compatibilidade verificada com a versão 3.6.1 do SDK da BidMachine.

Criado e testado com:

• Versão 25.1.0 do SDK do Google Mobile Ads.
• Versão 3.6.1 do SDK da BidMachine.

Versão 3.5.1.2

• Atualizamos o adaptador do BidMachine para usar o AdPlacementConfig.

Criado e testado com:

• Versão 24.9.0 do SDK do Google Mobile Ads.
• Versão 3.5.1 do SDK da BidMachine.

Versão 3.5.1.1

• Adicionamos suporte para encaminhar o parâmetro tagForUnderAgeOfConsent do SDK do Google Mobile Ads ao SDK da BidMachine.

Criado e testado com:

• Versão 24.9.0 do SDK do Google Mobile Ads.
• Versão 3.5.1 do SDK da BidMachine.

Versão 3.5.1.0

• Compatibilidade verificada com a versão 3.5.1 do SDK da BidMachine.

Criado e testado com:

• Versão 24.9.0 do SDK do Google Mobile Ads.
• Versão 3.5.1 do SDK da BidMachine.

Versão 3.5.0.0

• Compatibilidade verificada com a versão 3.5.0 do SDK da BidMachine.

Criado e testado com:

• Versão 24.7.0 do SDK do Google Mobile Ads.
• Versão 3.5.0 do SDK da BidMachine.

Versão 3.4.0.1

• Removemos referências no nível da classe a objetos Context para ajudar com problemas de vazamento de memória.
• O adaptador foi atualizado para oferecer suporte a solicitações de anúncios de banner com tamanho próximo aos formatos aceitos, em vez de exigir uma correspondência exata.

Criado e testado com:

• Versão 24.7.0 do SDK do Google Mobile Ads.
• Versão 3.4.0 do SDK da BidMachine.

Versão 3.4.0.0

• Adicionamos suporte à hierarquia para formatos de anúncio de banner, intersticial, premiado e nativo.
• O adaptador agora encaminha onAdOpened() com onAdImpression() para anúncios em tela cheia.
• Compatibilidade verificada com a versão 3.4.0 do SDK da BidMachine.

Criado e testado com:

• Versão 24.6.0 do SDK do Google Mobile Ads.
• Versão 3.4.0 do SDK da BidMachine.

Versão 3.3.0.0

• Versão inicial.

Criado e testado com:

• Versão 24.5.0 do SDK do Google Mobile Ads.
• Versão 3.3.0 do SDK da BidMachine.