Este guia mostra como usar Google Mobile Ads Unity Plugin para carregar e exibir anúncios do SDK do 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 Unity.
Integrações e formatos de anúncio aceitos
O adaptador de mediação da AdMob para o SDK do BIGO Ads tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | 1 |
| Cascata | |
| Formatos | |
| Abertura do aplicativo | |
| 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
- Versão mais recente do Google Mobile Ads Unity Plugin
- Unity 2019.4 ou mais recente
- Para implantar no Android
- API Android nível da API 23 ou mais recente
- Para implantar no iOS
- Destino de implantação do iOS 13.0 ou mais recente.
- Um projeto do Unity em funcionamento configurado com Google Mobile Ads Unity Plugin. Consulte Começar para mais detalhes.
- Configurar a Mediação da AdMob
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.
Android
iOS
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 Server Bidding em Auction Type, preencha o restante do formulário e clique em Submit.
Anote o ID do slot.
Android
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 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 da AdMob
Definir as configurações de mediação do bloco de anúncios
Android
Para instruções, consulte a etapa 2 no guia para Android.
iOS
Para instruções, consulte a etapa 2 no guia para iOS.
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 da AdMob.
Etapa 3: importar o SDK e o adaptador do BIGO Ads
OpenUPM-CLI
Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação do SDK de anúncios da BIGO para anúncios para dispositivos móveis do Google no seu projeto do Unity executando o seguinte comando no diretório raiz do projeto:
openupm add com.google.ads.mobile.mediation.bigoOpenUPM
No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Configurações do gerenciador de pacotes do Unity.
Na guia Registros com escopo, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:
- Nome:
OpenUPM - URL:
https://package.openupm.com - Escopos:
com.google
Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.
Selecione o pacote Mediação do Google Mobile Ads Bigo e clique em Instalar.
Pacote do Unity
Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para o SDK de anúncios da BIGO no link de download do Registro de alterações e extraia o GoogleMobileAdsBigoMediation.unitypackage do arquivo ZIP.
No editor do projeto do Unity, selecione Assets > Import Package >
Custom Package e encontre o arquivo
GoogleMobileAdsBigoMediation.unitypackage
que você baixou. Verifique se todos os arquivos estão selecionados e clique em Importar.
Em seguida, selecione Recursos > Gerenciador de dependências externas >
Resolvedor do Android > Resolução forçada. A biblioteca do gerenciador de dependências externas
vai realizar a resolução de dependências do zero e copiar as
dependências declaradas no diretório Assets/Plugins/Android do seu
app Unity.
Etapa 4: implementar configurações de privacidade no SDK do BIGO Ads
Para implementar configurações de privacidade no SDK do BIGO Ads e obedecer às regulamentações de privacidade relevantes, leia as seções a seguir.
Consentimento da UE e GDPR
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 do SDK do BIGO Ads para a GDPR em 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.
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 Unity Plugin.
using GoogleMobileAds.Mediation.Bigo.Api;
// ...
Bigo.SetCcpaConsent(true);
Etapa 5: adicionar o código necessário
Android
Nenhum código adicional é necessário para a integração do SDK do BIGO Ads.
iOS
Integração da SKAdNetwork
Siga a documentação do SDK do BIGO Ads
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.
O BIGO Ads fornece IDs de aplicativos e IDs de slot de anúncio de teste para Android e iOS 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).
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 nas
seguintes classes:
Android
sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter
iOS
GADMediationAdapterBigo
Confira os códigos e as mensagens correspondentes gerados pelo adaptador do SDK do BIGO Ads quando um anúncio não é carregado:
Android
| 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. |
iOS
| Código do erro | Domínio | Motivo |
|---|---|---|
| 101 | com.google.ads.mediation.bigo | A configuração do servidor não tem um ID do aplicativo obrigatório. |
| 102 | com.google.ads.mediation.bigo | Configuração de anúncio inválida. |
| 103 | com.google.ads.mediation.bigo | Falha na apresentação do anúncio. |
| 104 | com.google.ads.mediation.bigo | Tamanho de banner sem suporte. |
| 105 | com.google.ads.mediation.bigo | A Bigo carregou um anúncio de banner, mas não uma visualização de anúncio. |
| 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 plug-in de mediação do Unity do SDK do BIGO Ads
Versão 1.0.0
- Versão inicial.
- Compatibilidade com a versão 5.8.0.0 do adaptador Android do SDK do BIGO Ads.
- Compatibilidade com a versão 5.1.2.0 do adaptador do SDK do BIGO Ads para iOS.
- Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.