Este guia mostra como usar Google Mobile Ads SDK para carregar e exibir anúncios do SDK do BIGO Ads usando a mediação, incluindo as integrações de lances. Ele explica como adicionar o SDK do BIGO Ads à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do BIGO Ads a um app Android.
Integrações e formatos de anúncio aceitos
O adaptador de mediação do SDK do 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á em Beta fechado. Entre em contato com seu gerente de contas para solicitar acesso.
Requisitos
- API Android nível da API 23 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 do SDK do BIGO Ads
Faça login no painel do BIGO Ads.
Criar um app
Acesse 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 sua inscrição for analisada, acesse a tabela Ad Slots e selecione o botão + Add.
Selecione Lances do servidor em Tipo de leilão, preencha o restante do formulário e clique em Enviar.
Anote o ID do slot.
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 app-ads.txt no SDK do BIGO Ads, acesse a guia APP-ads.txt no Painel e siga as instruções na guia.
Etapa 2: configurar a demanda do SDK do BIGO Ads na interface do Ad Manager
Faça login na sua conta do Ad Manager.
Adicionar o SDK da BIGO Ads 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 SDK da BIGO Ads 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 BIGO TECHNOLOGY PTE LTD 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 do SDK do BIGO Ads
Lances
Acesse Exibição > Bidders e clique em Acessar os Lances do SDK.
Clique em Novo bidder.
Selecione SDK da BIGO Ads 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 o SDK da BIGO Ads.
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 do slot obtido na seção anterior.
Por fim, clique em Salvar.
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 o SDK do BIGO Ads 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 valor obtido na seção anterior e o valor do CPM padrão. Clique em Salvar.
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 a BIGO TECHNOLOGY PTE LTD à 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 do BIGO Ads
Integração com o Android Studio (recomendada)
No arquivo gradle 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 do 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 do 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 do 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 que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.
O exemplo de código a seguir mostra como transmitir a flag de consentimento para o SDK do BIGO Ads. Chame esse método antes de solicitar anúncios usando 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 do BIGO Ads na CCPA.
Etapa 5: adicionar o código necessário
Nenhum código adicional é necessário para a integração do SDK do BIGO Ads.
Etapa 6: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste no Ad Manager.
O BIGO Ads fornece IDs de aplicativo e IDs de slot de anúncio 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 origens de anúncios SDK da BIGO Ads (lances).
Etapas opcionais
Anúncios nativos
Renderização do anúncio
O adaptador do SDK do BIGO Ads retorna os anúncios nativos como objetos
NativeAd. Ele preenche os seguintes campos de um NativeAd.
| Campo | Recursos sempre incluídos pelo adaptador do SDK do BIGO Ads |
|---|---|
| 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 do SDK do BIGO Ads, verifique o
erro subjacente 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 BIGO Ads quando um anúncio não é carregado:
| Código do erro | Domínio | Motivo |
|---|---|---|
| 101 | com.google.mediation.bigoadapter | O ID do slot da Bigo está ausente ou vazio. |
| 1000-1100 | Enviado pelo SDK de anúncios da BIGO. | O SDK do BIGO Ads retornou um erro. Consulte a documentação do SDK do BIGO Ads para mais detalhes. |
Registro de alterações do adaptador de mediação do Android da Bigo
Próxima versão
- Mapeia
AgeRestrictedTreatmentpara a API da COPPA do Bigo.
Versão 5.9.0.0
- Compatibilidade verificada com a versão 5.9.0 do SDK do Bigo Ads.
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 do Bigo Ads.
Versão 5.8.0.0
- Adicionada propriedade para criar o adaptador com a dependência do SDK do GMA Next-Gen.
- Compatibilidade verificada com a versão 5.8.0 do SDK do Bigo Ads.
Criado e testado com:
- Versão 25.1.0 do SDK do Google Mobile Ads.
- Versão 5.8.0 do SDK do Bigo Ads.
Versão 5.7.1.0
- Compatibilidade verificada com o SDK do 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 do 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 ao SDK do Bigo Ads. - Compatibilidade verificada com o SDK do 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 do Bigo Ads.
Versão 5.5.2.0
- Adicionamos suporte para formatos de anúncio de banner, intersticial, premiado e nativo.
- Compatibilidade verificada com a versão 5.5.2 do SDK do Bigo Ads.
Criado e testado com:
- Versão 24.9.0 do SDK do Google Mobile Ads.
- Versão 5.5.2 do SDK do Bigo Ads.