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

Integrações e formatos de anúncio aceitos

O adaptador de mediação do Ad Manager para o SDK de anúncio da 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á na versão Beta fechada. Entre em contato com seu gerente de contas para solicitar acesso.

Pré-requisitos

Antes de continuar, verifique o seguinte:

  • Versão mais recente do Google Mobile Ads Unity Plugin.
  • Unity Editor versão 2019.4 ou mais recente.
  • Para implantar no Android
    • API Android nível 24 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.
  • Configure a mediação.

Etapa 1: definir as configurações na interface do SDK de anúncio da 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.

Adicionar app

Preencha o restante do formulário e clique em Enviar.

Formulário de novo app

Anote o ID do aplicativo.

Android

ID do app Android

iOS

ID do aplicativo iOS

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.

Adicionar espaço do anúncio

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

Novo formulário de espaço do anúncio

Anote o ID do espaço.

Android

ID do espaço do anúncio para Android

iOS

ID do espaço do anúncio para 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, crie um arquivo app-ads.txt para o Ad Manager.

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.

App-ads.txt

Etapa 2: configurar a demanda do SDK de anúncio da BIGO Ads na interface do Ad Manager

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

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

OpenUPM-CLI

Se a OpenUPM-CLI estiver instalada, você poderá instalar o plug-in de mediação do SDK de anúncio para dispositivos móveis do Google para a BIGO Ads para Unity no seu projeto executando o seguinte comando no diretório raiz do projeto:

openupm add com.google.ads.mobile.mediation.bigo

OpenUPM

No editor do projeto do Unity, selecione Edit > Configurações do Projeto > Package Manager para abrir as configurações do gerenciador de pacotes do Unity.

Na guia Scoped Registries, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopos: com.google

Detalhes do OpenUPM

Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.

Registros do Unity

Selecione o pacote Google Mobile Ads Bigo Mediation e clique em Install.

Instalar pelo OpenUPM

Pacote do Unity

Baixe a versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para o SDK de anúncio da BIGO Ads no link de download no 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.

Importar do Unity

Em seguida, selecione Assets > External Dependency Manager > Android Resolver > Force Resolve. 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.

Forçar resolução

Etapa 4: implementar configurações de privacidade no SDK de anúncio da BIGO Ads

Para implementar as configurações de privacidade do SDK de anúncio da BIGO e obedecer às regulamentações de privacidade relevantes, leia as seções a seguir.

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 do SDK de anúncio da BIGO Ads sobre o GDPR para 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 de anúncio da BIGO. 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 de anúncio da BIGO Ads.

iOS

Integração da SKAdNetwork

Siga a documentação do SDK de anúncio da BIGO Ads para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do seu projeto.

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 aplicativos e IDs de espaços de anúncios de teste para Android e iOS para ajudar nos testes e na integração.

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

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 nas seguintes classes:

Android

sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter

iOS

GADMediationAdapterBigo

Os códigos e as mensagens correspondentes são gerados pelo adaptador do SDK da BIGO Ads quando um anúncio não é carregado:

Android

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 da BIGO Ads retornou um erro. Consulte a documentação do SDK da BIGO Ads para mais detalhes.

iOS

Código do erro Domínio Motivo
101 com.google.mediation.bigoadapter A configuração do servidor não tem um ID do aplicativo obrigatório.
102 com.google.mediation.bigoadapter A configuração do anúncio é inválida.
103 com.google.mediation.bigoadapter Falha na apresentação do anúncio.
104 com.google.mediation.bigoadapter Tamanho de banner não aceito.
105 com.google.mediation.bigoadapter A Bigo carregou um anúncio de banner, mas não há uma visualização de anúncio.
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 plug-in de mediação para Unity do SDK de anúncio da BIGO Ads

Versão 3.1.0

Versão 3.0.0

Versão 2.0.0

Versão 1.1.0

Versão 1.0.0