Integrar a BidMachine com a mediação

Selecione a plataforma: Android (Beta) Android iOS Unity Flutter

Este guia mostra como usar Google Mobile Ads SDK 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 iOS.

Integrações e formatos de anúncio aceitos

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

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

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

² O formato de anúncio nativo está na 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.

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

Requisitos

• Destino de implantação do iOS 13.0 ou mais recente.

• Mais recentes de Google Mobile Ads 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, 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

Adicione a BidMachine à configuração de mediação do seu bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Navegue até a guia Mediação. Se você tiver um grupo de mediação que quer modificar, clique no nome dele para editar e pule para Adicionar a BidMachine como uma origem de anúncios.

Para criar um grupo de mediação, selecione Criar grupo de mediação.

Insira o formato e a plataforma do anúncio, depois clique em Continuar.

Dê um nome ao grupo de mediação e selecione os locais de segmentação. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.

Associe esse grupo de mediação a um ou mais dos seus blocos de anúncios da AdMob. Em seguida, clique em Concluído.

O card "Blocos de anúncios" vai aparecer com os blocos selecionados:

Adicionar a BidMachine como uma origem de anúncios

Lances

No card Lances da seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione BidMachine.

Clique em Como assinar um contrato de parceria e configure uma parceria de lances com a BidMachine.



Clique em Confirmar e concordar e em Continuar.



Se você já tiver um mapeamento para a BidMachine, selecione-o. Caso contrário, clique em Adicionar mapeamento.



Em seguida, insira o ID da posição obtido na seção anterior. Em seguida, clique em Concluído.

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

Cascata

No card Hierarquia da seção Origens de anúncios, selecione Adicionar origem do anúncio.

Selecione BidMachine. Em seguida, insira um valor de eCPM para a BidMachine e clique em Continuar.

Observação: só é necessário configurar a otimização da origem de anúncios uma vez por rede.

Se você já tiver um mapeamento para a BidMachine, selecione-o. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira o ID da posição obtido na seção anterior. Em seguida, clique em Concluído.

Importante: o ID da fonte precisa ser 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 da AdMob.

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.

CocoaPods (recomendado)

• Adicione a seguinte linha ao Podfile do seu projeto:

  pod 'GoogleMobileAdsMediationBidMachine'
  

• Na linha de comando, execute:

  pod install --repo-update

Integração manual

1. Faça o download da versão mais recente do SDK da BidMachine para iOS e vincule todos os arquivos e pacotes .xcframework no seu projeto.

2. Faça o download da versão mais recente do adaptador da BidMachine usando o link de download no Registro de alterações e vincule BidMachineAdapter.xcframework no seu projeto.

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

Integração da SKAdNetwork

Siga a documentação da BidMachine 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 iOS e ative o modo de teste da BidMachine.

Importante: desative o modo de teste para a AdMob e a 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 de anúncios

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

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 GADResponseInfo.adNetworkInfoArray nas seguintes classes:

GADMediationAdapterBidMachine

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
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 da BidMachine para iOS

Versão 3.5.1.2 (em andamento)

• Atualizamos a dependência do SDK dos anúncios para dispositivos móveis do Google para a versão 13.0.

Versão 3.5.1.1

• Atualizamos a versão mínima do iOS do CocoaPods para 13.0.
• Adicionamos suporte para encaminhar o parâmetro tagForUnderAgeOfConsent do SDK dos anúncios para dispositivos móveis do Google ao SDK da BidMachine.
• Modificamos as seções de conformidade BidMachineAdDelegate para se alinharem ao comportamento de callback do SDK BidMachine.

Criado e testado com:

• Versão 13.0.0 do SDK dos anúncios para dispositivos móveis do Google.
• 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 12.14.0 do SDK dos anúncios para dispositivos móveis do Google.
• 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 12.12.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 3.5.0 do SDK da BidMachine.

Versão 3.4.0.2

• Adicionamos suporte à hierarquia para formatos de anúncio de banner, intersticial, premiado e nativo.
• A propriedade estática isTestMode foi removida de BidMachineAdapterExtras.
• Adicionamos a validação do tamanho do anúncio de banner para anúncios de banner em hierarquia.

Criado e testado com:

• Versão 12.12.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 3.4.0 do SDK da BidMachine.

Versão 3.4.0.1

• O modo de teste agora está disponível em Objective-C pela propriedade GADMediationAdapterBidMachineExtras.isTestMode.

Criado e testado com:

• Versão 12.0.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 3.4.0 do SDK da BidMachine.

Versão 3.4.0.0

• Versão inicial.
• Adicionamos suporte a lances para formatos de anúncio de banner, intersticial, premiado e nativo.
• Compatibilidade verificada com a versão 3.4.0 do SDK da BidMachine.

Criado e testado com:

• Versão 12.8.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 3.4.0 do SDK da BidMachine.