Este guia mostra como usar Google Mobile Ads SDK para carregar e exibir anúncios do SDK da BIGO Ads usando a Mediação da AdMob, incluindo as integrações de lances. Ele explica como adicionar o SDK da BIGO Ads à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da BIGO Ads a um app Android.
Integrações e formatos de anúncio aceitos
O adaptador de mediação do SDK da BIGO Ads tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | 1 |
| Cascata | |
| Formatos | |
| Abertura do app | |
| Banner | |
| Intersticial | |
| Premiado | |
| Intersticial premiado | |
| Nativo | |
1 A integração de lances está na versão Beta fechada. Entre em contato com seu gerente de contas para solicitar acesso.
Requisitos
- API Android nível da API 23 ou mais recente
Mais recente Google Mobile Ads SDK
Leia todo o guia para iniciantes da mediação.
Etapa 1: definir as configurações na interface do SDK da BIGO Ads
Faça login no painel da BIGO Ads.
Criar um app
Navegue até a guia Inventário e, na tabela Apps e sites , selecione o botão + Adicionar.
Preencha o restante do formulário e clique em Enviar.
Anote o ID do aplicativo.
Criar um espaço do anúncio
Depois que o aplicativo for revisado, navegue até a tabela Blocos de anúncios e selecione o botão + Adicionar.
Selecione Lances do servidor para o Tipo de leilão, preencha o restante do formulário e clique em Enviar.
Anote o ID do bloco.
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 o SDK da BIGO Ads, navegue até a guia APP-ads.txt no Painel e siga as instruções localizadas na guia.
Etapa 2: configurar a demanda do SDK da BIGO Ads na interface da AdMob
Definir as configurações de mediação do bloco de anúncios
Adicione o SDK da BIGO Ads à configuração de mediação do seu bloco de anúncios.
Faça login na sua conta do 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 o SDK da BIGO Ads como uma origem de anúncios.
Para criar um novo 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 o SDK da BIGO Ads como uma origem de anúncios
No card Lances da seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione SDK da BIGO Ads.
Clique em Como assinar um contrato de parceria e configure uma parceria de lances com o SDK da BIGO Ads.
Clique em Confirmar e concordar e em Continuar.
Se você já tiver um mapeamento para o SDK da BIGO Ads, selecione-o. Caso contrário, clique em Adicionar mapeamento.
Em seguida, insira o ID do bloco visto na seção anterior. Em seguida, clique em Concluído.
Adicionar a BIGO TECHNOLOGY PTE LTD à 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 BIGO TECHNOLOGY PTE LTD à 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 BIGO Ads
Integração com o Android Studio (recomendada)
No arquivo gradle no nível do app, adicione as seguintes dependências de implementação:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:25.3.0") implementation("com.google.ads.mediation:bigo:5.9.0.0") }
Groovy
dependencies { implementation 'com.google.android.gms:play-services-ads:25.3.0' implementation 'com.google.ads.mediation:bigo:5.9.0.0' }
Etapa 4: implementar configurações de privacidade no SDK da BIGO Ads
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.
O SDK da BIGO Ads 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 de integração do SDK da BIGO Ads sobre o 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 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.
O exemplo de código a seguir mostra como transmitir a flag de consentimento para o SDK da BIGO Ads. Chame esse método antes de solicitar anúncios pelo Google Mobile Ads SDK.
Java
BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true);
Kotlin
BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true)
Para mais informações, consulte o guia de integração do SDK da BIGO Ads sobre CCPA.
Etapa 5: adicionar o código necessário
Nenhum código extra é necessário para a integração do SDK da BIGO Ads.
Etapa 6: testar a implementação
Ativar anúncios de teste
Certifique-se de registrar seu dispositivo de teste na AdMob.
A BIGO Ads oferece IDs de aplicativos e IDs de blocos de anúncios de teste para Android para ajudar com testes e integração.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do SDK da BIGO Ads, ative o teste de uma única origem de anúncios no Ad Inspector usando as SDK da BIGO Ads (lances) origens de anúncios.
Etapas opcionais
Anúncios nativos
Renderização do anúncio
O adaptador do SDK da BIGO Ads retorna os anúncios nativos como
NativeAd
objetos. Ele preenche os seguintes
campos
para um
NativeAd.
| Campo | Recursos sempre incluídos pelo adaptador do SDK da BIGO Ads |
|---|---|
| Título | |
| Imagem | |
| Corpo | |
| Ícone | |
| Call-to-action | |
| Classificação por estrela | |
| Repositório | |
| Preço | |
| Advertiser |
Códigos de erro
Se o adaptador não receber um anúncio do SDK da BIGO Ads, verifique o
erro na resposta do anúncio usando
ResponseInfo.getAdapterResponses()
nas seguintes classes:
sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter
Confira os códigos e as mensagens correspondentes gerados pelo adaptador do SDK da BIGO Ads quando um anúncio não é carregado:
| Código do erro | Domínio | Motivo |
|---|---|---|
| 101 | com.google.mediation.bigoadapter | O ID do bloco da Bigo está ausente ou vazio. |
| 1000-1100 | Enviado pelo SDK da BIGO Ads | O SDK da BIGO Ads retornou um erro. Consulte a documentação do SDK da BIGO Ads para mais detalhes. |
Registro de alterações do adaptador de mediação da Bigo para Android
Próxima versão
- Mapeia
AgeRestrictedTreatmentpara a API COPPA da Bigo.
Versão 5.9.0.0
- Compatibilidade verificada com o SDK da Bigo Ads 5.9.0.
Criado e testado com:
- Versão 25.2.0 do SDK do Google Mobile Ads.
- Versão 1.0.1 do SDK do Google Mobile Ads Next-Gen.
- Versão 5.9.0 do SDK da Bigo Ads.
Versão 5.8.0.0
- Adicionamos a propriedade para criar o adaptador com a dependência do SDK do GMA Next-Gen.
- Compatibilidade verificada com o SDK da Bigo Ads 5.8.0.
Criado e testado com:
- Versão 25.1.0 do SDK do Google Mobile Ads.
- Versão 5.8.0 do SDK da Bigo Ads.
Versão 5.7.1.0
- Compatibilidade verificada com o SDK da Bigo Ads 5.7.1.
Criado e testado com:
- Versão 25.0.0 do SDK do Google Mobile Ads.
- Versão 5.7.1 do SDK da Bigo Ads.
Versão 5.7.0.0
- Adicionamos suporte para encaminhar o parâmetro
tagForUnderAgeOfConsentdo SDK dos anúncios para dispositivos móveis do Google para o SDK da Bigo Ads. - Compatibilidade verificada com o SDK da Bigo Ads 5.7.0.
Criado e testado com:
- Versão 24.9.0 do SDK do Google Mobile Ads.
- Versão 5.7.0 do SDK da Bigo Ads.
Versão 5.5.2.0
- Adicionamos suporte para formatos de anúncio de banner, intersticial, premiado e nativo.
- Compatibilidade verificada com o SDK da Bigo Ads 5.5.2.
Criado e testado com:
- Versão 24.9.0 do SDK do Google Mobile Ads.
- Versão 5.5.2 do SDK da Bigo Ads.