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

Este guia mostra como usar Google Mobile Ads 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 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 iOS.

Integrações e formatos de anúncio aceitos

O adaptador de mediação do SDK do BIGO Ads tem os seguintes recursos:

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

Pré-requisitos

Antes de continuar, verifique o seguinte:

• Destino de implantação do iOS 13.0 ou mais recente.

• A versão mais recente do Google Mobile Ads SDK.

• Configurar a Mediação da AdMob.

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.

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

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 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 do BIGO Ads

CocoaPods

• Adicione a seguinte linha ao Podfile do seu projeto:

  pod 'GoogleMobileAdsMediationBigo'
  

• Na linha de comando, execute:

  pod install --repo-update

Etapa 4: implementar configurações de privacidade no SDK do BIGO Ads

Consentimento da UE e 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 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 Google Mobile Ads SDK.

BigoAdSdk.setUserConsentWithOption(BigoConsentOptionsCCPA, consent: true)

[BigoAdSdk setUserConsentWithOption:BigoConsentOptionsCCPA consent:YES];

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

Implementar a SKAdNetwork

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

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste na AdMob.

O BIGO Ads oferece IDs de aplicativo e IDs de slot de anúncio de teste para iOS, ajudando nos testes e na integração.

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 GADNativeAd. Ele preenche os seguintes campos de um GADNativeAd.

Códigos de erro

Se o adaptador não receber um anúncio do SDK do BIGO Ads, verifique o erro na resposta do anúncio usando GADResponseInfo.adNetworkInfoArray nas seguintes classes:

GADMediationAdapterBigo

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

Registro de alterações do adaptador de mediação da BIGO Ads para iOS

Versão 5.3.0.0

• Compatibilidade verificada com a versão 5.3.0 do SDK do BIGO Ads.

Criado e testado com:

• Versão 13.6.0 do SDK do Google Mobile Ads.
• Versão 5.3.0 do SDK do BIGO Ads.

Versão 5.2.1.0

• Compatibilidade verificada com a versão 5.2.1 do SDK do BIGO Ads.
• Atualize a dependência mínima do SDK do Google Mobile Ads para 13.3.0 para usar as novas APIs de privacidade.

Criado e testado com:

• Versão 13.4.0 do SDK do Google Mobile Ads.
• Versão 5.2.1 do SDK do BIGO Ads.

Versão 5.2.0.0

• Compatibilidade verificada com a versão 5.2.0 do SDK do BIGO Ads.

Criado e testado com:

• Versão 13.4.0 do SDK do Google Mobile Ads.
• Versão 5.2.0 do SDK do BIGO Ads.

Versão 5.1.2.1

• O adaptador agora encaminha a flag ageRestrictedTreatment do SDK do Google Mobile Ads para a API da COPPA do SDK de anúncios da BIGO.

Criado e testado com:

• Versão 13.3.0 do SDK do Google Mobile Ads.
• Versão 5.1.2 do SDK do BIGO Ads.

Versão 5.1.2.0

• Compatibilidade verificada com a versão 5.1.2 do SDK do BIGO Ads.

Criado e testado com:

• Versão 13.2.0 do SDK do Google Mobile Ads.
• Versão 5.1.2 do SDK do BIGO Ads.

Versão 5.1.1.0

• Compatibilidade verificada com a versão 5.1.1 do SDK do BIGO Ads.

Criado e testado com:

• Versão 13.2.0 do SDK do Google Mobile Ads.
• Versão 5.1.1 do SDK do BIGO Ads.

Versão 5.1.0.1

• Atualizamos o adaptador para evitar falhas na solicitação de anúncio quando um anúncio de banner é carregado com um tamanho incompatível.

Criado e testado com:

• Versão 13.1.0 do SDK do Google Mobile Ads.
• Versão 5.1.0 do SDK do BIGO Ads.

Versão 5.1.0.0

• Compatibilidade verificada com a versão 5.1.0 do SDK do BIGO Ads.

Criado e testado com:

• Versão 13.1.0 do SDK do Google Mobile Ads.
• Versão 5.1.0 do SDK do BIGO Ads.

Versão 5.0.6.2

• Atualizamos a dependência do SDK do Google Mobile Ads para a versão 13.0.0.

Criado e testado com:

• Versão 13.0.0 do SDK do Google Mobile Ads.
• Versão 5.0.6 do SDK do BIGO Ads.

Versão 5.0.6.1

• Atualizamos a versão mínima do iOS do CocoaPods para 13.0.

Criado e testado com:

• Versão 13.0.0 do SDK do Google Mobile Ads.
• Versão 5.0.6 do SDK do BIGO Ads.

Versão 5.0.6.0

• Versão inicial.
• Adicionamos suporte a lances para formatos de anúncio de abertura do app, banner (inclui MREC), intersticial, premiado e nativo.
• Compatibilidade verificada com a versão 5.0.6 do SDK do BIGO Ads.

Criado e testado com:

• Versão 12.14.0 do SDK do Google Mobile Ads.
• Versão 5.0.6 do SDK do BIGO Ads.