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

Selecione a plataforma: Android iOS Unity Android (legada)

Este guia mostra como usar Google Mobile Ads SDK (Legacy) 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

¹ A integração de lances está na versão Beta fechada. Entre em contato com seu gerente de contas para solicitar acesso.

Pré-requisitos

Antes de continuar, verifique o seguinte:

• Nível 23 ou mais recente da API Android.

• Versão mais recente Google Mobile Ads SDK (Legacy).

• Configurar a Mediação da AdMob.

Etapa 1: configurar 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.

Importante: depois de criar o novo aplicativo, ele será colocado em análise. O aplicativo precisa ser revisado antes de você continuar com as próximas etapas.

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

Primeiro, 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 do anúncio e a plataforma e 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

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 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 recebido 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 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 Empathy Technology Pte.Ltd. (BIGO Ads) à lista de parceiros de publicidade das regulamentações europeias e ** BIGOAds** à lista de parceiros de publicidade das regulamentações estaduais dos EUA na interface da AdMob.

Etapa 3: importar o SDK e o adaptador da 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 levar a problemas de build.

Integração do 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.4.0")
    implementation("com.google.ads.mediation:bigo:5.10.1.0")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.4.0'
    implementation 'com.google.ads.mediation:bigo:5.10.1.0'
}

Etapa 4: implementar configurações de privacidade no SDK 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 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 (Legacy).

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 da BIGO Ads sobre 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

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.

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 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	ID do bloco da Bigo 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

Versão 5.10.1.0

• Compatibilidade verificada com o SDK da Bigo Ads 5.10.1.

Criado e testado com:

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

Versão 5.9.0.1

• Mapeia 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 do Google Mobile Ads Next-Gen.
• Versão 5.9.0 do SDK da Bigo Ads.

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

• Adicionou 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

• Adicionou suporte para encaminhar o parâmetro tagForUnderAgeOfConsent do 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

• Adicionou 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.