Integrar a BidMachine à Mediação da AdMob

Este guia mostra como usar o Google Mobile Ads SDK for React Native 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 React Native.

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 SDK for React Native.
  • Versão 0.85.0 ou mais recente do framework React Native.
  • 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 React Native em funcionamento configurado com Google Mobile Ads SDK for React Native. 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 posicionamento para iOS

Por fim, anote o ID de lugar.

Android

Detalhes do posicionamento do Android

iOS

Detalhes do posicionamento 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 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 final do 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 ver as 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

No diretório raiz do projeto, instale o adaptador de mediação Google Mobile Ads SDK for React Native para a BidMachine. Preencha os campos:

  1. Copie o arquivo tar do adaptador Google Mobile Ads SDK for React Native do diretório gma-sdk-react-native/adapters/bidmachine/ para o diretório local_packages/ do projeto. Se você não tiver a pasta adapters, consulte Pré-requisitos.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/bidmachine/gma-mediation-bidmachine-0.1.0.tgz local_packages/

    Substitua EXTRACT_DIR pelo caminho para o diretório em que você extraiu o arquivo.

  2. Instale o pacote do adaptador usando o gerenciador de pacotes de sua preferência:

    npm

    npm install ./local_packages/gma-mediation-bidmachine-0.1.0.tgz

    novelo

    yarn add ./local_packages/gma-mediation-bidmachine-0.1.0.tgz

  3. Se você estiver criando para Android, adicione o seguinte repositório ao arquivo build.gradle no diretório android do seu projeto:

    repositories {
    google()
    mavenCentral()
    maven {
        url = uri("https://artifactory.bidmachine.io/bidmachine")
    }
}

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 0.1.0 e mais recentes do adaptador do React Native da BidMachine aceitam a transmissão de indicadores de consentimento do GDPR de plataformas de gestão de consentimento que se integram à 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 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 indicadores 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.
107 com.google.ads.mediation.bidmachine O ID da origem está ausente ou vazio.

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.

Versão 0.1.0

  • Versão inicial.