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

Selecione a plataforma: Android iOS Unity Android (legada)

Este guia mostra como usar o Google Mobile Ads SDK (Legacy) para carregar e exibir anúncios do SDK de anúncio da BIGO Ads usando a mediação, incluindo as 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	^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:

• API Android nível 24 ou mais recente.

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

• Configure a mediação.

Etapa 1: definir as configurações na interface do SDK do 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 solicitação precisa ser revisada 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 espaços do anúncio 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.

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 de anúncio 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 de anúncio da 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 de anúncio 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 hierarquia.

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

Configurar os lances do SDK da BIGO Ads

Lances

Acesse Exibição > Bidders e clique em Acessar os Lances do SDK.

Clique em Novo bidder.

Selecione SDK de anúncio da BIGO 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 hierarquia.

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 de anúncio da BIGO.

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 espaço visto na seção anterior.

Por fim, clique em Salvar.

Importante: segmente o bloco de anúncios selecionado por pelo menos um grupo de rendimento, e o ID do aplicativo precisa ser associado ao app segmentado, como na interface do SDK de anúncio da BIGO Ads.

Cascata

Acesse Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento. Selecione seu Inventário e App.

Role até Parceiros de rendimento e clique em Adicionar parceiro de mediação.

Selecione a empresa que você criou para o SDK de anúncio do BIGO 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 obtido na seção anterior e o valor do CPM padrão. Clique em Salvar.

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 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 do Ad Manager.

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 gradle no nível do app, adicione as seguintes dependências de implementação:

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:bigo:6.1.0.0")
}

Groovy

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

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 algumas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de pedir o consentimento deles para usar cookies ou outro 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 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 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 do BIGO Ads.

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste no Ad Manager.

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 Ad Manager 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 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 de anúncio 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 de anúncio 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 do 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 de anúncio do BIGO 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 de anúncio do Bigo 6.0.1.

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 do Bigo Ads.

Versão 6.0.0.0

• Compatibilidade verificada com o SDK do Bigo Ads 6.0.0.

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

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.