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

Selecione a plataforma: Android iOS Unity Android (legada)

Este guia mostra como usar o GMA Next-Gen SDK para carregar e exibir anúncios do SDK de anúncio da BIGO Ads com a Mediação da AdMob, incluindo integrações de lances. Ele explica como adicionar o SDK de anúncio da BIGO Ads à configuração de mediação de um bloco de anúncios e como integrar o SDK de anúncio 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 de anúncio da BIGO Ads tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Abertura do app
Banner
Intersticial
Premiado
Intersticial premiado
Nativo

Pré-requisitos

Antes de continuar, verifique o seguinte:

• API Android nível 24 ou mais recente.

• Versão mais recente do GMA Next-Gen SDK.

• Configure a Mediação da AdMob.

Etapa 1: definir as configurações na interface do SDK de anúncio da BIGO Ads

Faça login no painel da 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 de criar o novo aplicativo, ele será colocado Em análise. A inscrição precisa ser analisada antes de você prosseguir com as próximas etapas.

Criar um espaço do anúncio

Depois que o aplicativo for analisado, acesse a tabela Espaços do anúncio e selecione o botão + Adicionar.

Selecione Server Bidding em Auction Type, preencha o restante do formulário e clique em Submit.

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 o app-ads.txt para o SDK de anúncio da BIGO, acesse a guia APP-ads.txt no Painel e siga as instruções.

Etapa 2: configurar a demanda do SDK de anúncio 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 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 de anúncio 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 de anúncio da BIGO Ads como uma origem de anúncios

Na seção Origens de anúncios, encontre o card Lances e 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 de anúncio da BIGO Ads.



Clique em Confirmar e concordar e em Continuar.



Se você já tiver um mapeamento para o SDK de anúncio da BIGO, selecione-o. Caso contrário, clique em Adicionar mapeamento.



Em seguida, insira o ID do espaço 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 de anúncio da 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 Empathy Technology Pte.Ltd. (BIGO Ads) à lista de parceiros de publicidade das regulamentações europeias e a ** BIGOAds** à lista de parceiros de publicidade das regulamentações estaduais dos EUA na interface da AdMob.

Etapa 3: importar o SDK de anúncio e o adaptador da BIGO Ads

Observação: deixar de integrar as versões compatíveis do SDK da BIGO Ads e do SDK dos anúncios para dispositivos móveis do Google poderá causar problemas de build.

Integração com o Android Studio (recomendada)

No arquivo do Gradle no nível 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.5.0")
    implementation("com.google.ads.mediation:bigo:6.1.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.5.0'
    implementation 'com.google.ads.mediation:bigo:6.1.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 de anúncio da BIGO Ads

Consentimento da UE e do GDPR

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.

O SDK de anúncio da BIGO 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 de anúncio 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 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 o indicador de consentimento para o SDK de anúncio da BIGO. 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 de anúncio da BIGO Ads sobre a CCPA.

Etapa 5: adicionar o código necessário

Nenhum código adicional é necessário para a integração do SDK da BIGO Ads.

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste na AdMob.

A BIGO Ads oferece IDs de aplicativo e IDs de espaço do anúncio de teste para Android para ajudar nos testes e na integração.

Importante: desative o modo de teste do SDK de anúncio da AdMob e do SDK de anúncio 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 de anúncio da BIGO Ads, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios SDK de anúncio da BIGO Ads (lances).

Etapas opcionais

Anúncios nativos

Renderização do anúncio

O adaptador do SDK de anúncio da 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 de anúncio da 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 de anúncio da 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 da BIGO Ads quando um anúncio não é carregado:

Código do erro	Domínio	Motivo
101	com.google.ads.mediation.bigo	O ID do espaço da Bigo está ausente ou vazio.
1000-1100	Enviado pelo SDK da BIGO Ads.	O SDK de anúncio da BIGO 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

Versão 6.1.0.0

• Compatibilidade verificada com o SDK 6.1.0 da Bigo Ads.

Criado e testado com:

• Versão 25.5.0 do SDK do Google Mobile Ads.
• Versão 1.4.0 do SDK Next-Gen do Google Mobile Ads.
• Versão 6.1.0 do SDK da Bigo Ads.

Versão 6.0.1.0

• Compatibilidade verificada com o SDK 6.0.1 da Bigo Ads.

Criado e testado com:

• Versão 25.4.0 do SDK do Google Mobile Ads.
• Versão 1.4.0 do SDK Next-Gen do Google Mobile Ads.
• Versão 6.0.1 do SDK da Bigo Ads.

Versão 6.0.0.1

• Fixe a dependência do Kotlin do adaptador em 1.9.0 (a versão mínima do Kotlin compatível com o SDK do GMA NextGen).

Criado e testado com:

• Versão 25.4.0 do SDK do Google Mobile Ads.
• Versão 1.4.0 do SDK Next-Gen do Google Mobile Ads.
• Versão 6.0.0 do SDK de anúncio da Bigo Ads.

Versão 6.0.0.0

• Compatibilidade verificada com o SDK 6.0.0 da Bigo Ads.

Criado e testado com:

• Versão 25.4.0 do SDK do Google Mobile Ads.
• Versão 1.3.1 do SDK Next-Gen do Google Mobile Ads.
• Versão 6.0.0 do SDK de anúncio da Bigo Ads.

Versão 5.10.1.0

• Compatibilidade verificada com o SDK 5.10.1 do Bigo Ads.

Criado e testado com:

• Versão 25.4.0 do SDK do Google Mobile Ads.
• Versão 1.2.1 do SDK Next-Gen do Google Mobile Ads.
• Versão 5.10.1 do SDK da Bigo Ads.

Versão 5.9.0.1

• É mapeado AgeRestrictedTreatment para a API COPPA da Bigo.

Criado e testado com:

• Versão 25.4.0 do SDK do Google Mobile Ads.
• Versão 1.2.1 do SDK Next-Gen do Google Mobile Ads.
• Versão 5.9.0 do SDK da Bigo Ads.

Versão 5.9.0.0

• Compatibilidade verificada com o SDK de anúncio 5.9.0 da Bigo Ads.

Criado e testado com:

• Versão 25.2.0 do SDK do Google Mobile Ads.
• Versão 1.0.1 do SDK Next-Gen do Google Mobile Ads.
• Versão 5.9.0 do SDK da Bigo Ads.

Versão 5.8.0.0

• Adicionamos uma propriedade para criar o adaptador com a dependência do SDK do GMA Next-Gen.
• Compatibilidade verificada com o SDK 5.8.0 da Bigo Ads.

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 5.7.1 da Bigo Ads.

Criado e testado com:

• Versão 25.0.0 do SDK do Google Mobile Ads.
• Versão 5.7.1 do SDK de anúncio da 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 da Bigo Ads.
• Compatibilidade verificada com o SDK de anúncio 5.7.0 da Bigo Ads.

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 aos formatos de anúncio de banner, intersticial, premiado e nativo.
• Compatibilidade verificada com o SDK 5.5.2 da Bigo Ads.

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.