Integrar o SDK do BIGO Ads com a mediação

Selecione a plataforma: Android Android iOS Unity

Este guia mostra como usar GMA Next-Gen SDK 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 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

¹ 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 24 ou mais recente

• Mais recentes de GMA Next-Gen 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.

Importante: depois que você criar seu novo aplicativo, ele vai ficar Em análise. O pedido precisa ser revisado antes de você continuar com as próximas etapas.

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, 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

Adicione o SDK da BIGO Ads à 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 o SDK da BIGO Ads 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 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 slot obtido na seção anterior. Em seguida, clique em Concluído.

Importante: o ID do aplicativo precisa estar associado ao app segmentado, como na interface do SDK do BIGO Ads.

Adicionar a BIGO TECHNOLOGY PTE LTD à 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 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

Observação: a falha na integração das versões compatíveis do SDK da BIGO Ads e do SDK dos anúncios para dispositivos móveis do Google pode causar problemas de build.

Integração com o Android Studio (recomendada)

No arquivo gradle do app, adicione as seguintes dependências e configurações de implementação:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.1")
    implementation("com.google.ads.mediation:bigo:5.9.0.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.1'
    implementation 'com.google.ads.mediation:bigo:5.9.0.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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 GMA Next-Gen SDK.

Java

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true);
BigoMediationSnippets.java

Kotlin

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true)
BigoMediationSnippets.kt

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 na AdMob.

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.

Importante: desative o modo de teste da AdMob e do SDK da BIGO Ads antes de lançar o app.

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 para 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.getAdSourceResponses() 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 do 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 AgeRestrictedTreatment para 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 tagForUnderAgeOfConsent do 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.