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

Este guia mostra como usar o Google Mobile Ads 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 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 de anúncio da BIGO Ads tem os seguintes recursos:

Pré-requisitos

Antes de continuar, verifique o seguinte:

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

• Versão mais recente do Google Mobile Ads 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 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 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 espaço.

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

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

Etapa 3: importar o SDK de anúncio e o adaptador da 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 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.

A versão 5.0.6.0 e mais recentes do adaptador do iOS do SDK de anúncio da BIGO Ads aceitam a transmissão de indicadores de consentimento do GDPR de plataformas de gestão de consentimento que se integram à Estrutura de Transparência e Consentimento (TCF) do IAB para o SDK de anúncio da BIGO Ads. 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 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 SDK.

BigoAdSdk.setUserConsentWithOption(BigoConsentOptionsCCPA, consent: true)

[BigoAdSdk setUserConsentWithOption:BigoConsentOptionsCCPA consent:YES];

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

Implementar a 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 na AdMob.

A BIGO Ads oferece IDs de aplicativo e IDs de espaço do anúncio de teste para 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).

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

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

GADMediationAdapterBigo

Confira os códigos e as mensagens correspondentes gerados pelo adaptador do SDK da 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 6.1.0.0

• Compatibilidade verificada com a versão 6.1.0 do SDK de anúncio da BIGO.

Criado e testado com:

• Versão 13.10.0 do SDK do Google Mobile Ads.
• Versão 6.1.0 do SDK de anúncio da BIGO Ads.

Versão 6.0.0.1

• Agora o adaptador mapeia as solicitações de banner adaptativo para o tamanho de banner padrão mais próximo.

Criado e testado com:

• Versão 13.10.0 do SDK do Google Mobile Ads.
• Versão 6.0.0 do SDK de anúncio da BIGO.

Versão 6.0.0.0

• Compatibilidade verificada com a versão 6.0.0 do SDK de anúncio da BIGO.

Criado e testado com:

• Versão 13.9.0 do SDK do Google Mobile Ads.
• Versão 6.0.0 do SDK de anúncio da BIGO.

Versão 5.3.0.0

• Compatibilidade verificada com a versão 5.3.0 do SDK de anúncio da BIGO.

Criado e testado com:

• Versão 13.6.0 do SDK do Google Mobile Ads.
• Versão 5.3.0 do SDK de anúncio da BIGO.

Versão 5.2.1.0

• Compatibilidade verificada com a versão 5.2.1 do SDK de anúncio da BIGO.
• 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 de anúncio da BIGO.

Versão 5.2.0.0

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

Criado e testado com:

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

Versão 5.1.2.1

• Agora o adaptador encaminha a flag ageRestrictedTreatment do SDK dos anúncios para dispositivos móveis do Google à API da COPPA do SDK da BIGO Ads.

Criado e testado com:

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

Versão 5.1.2.0

• Compatibilidade verificada com a versão 5.1.2 do SDK de anúncio da BIGO.

Criado e testado com:

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

Versão 5.1.1.0

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

Criado e testado com:

• Versão 13.2.0 do SDK do Google Mobile Ads.
• Versão 5.1.1 do SDK de anúncio da BIGO.

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

Versão 5.1.0.0

• Compatibilidade verificada com a versão 5.1.0 do SDK de anúncio da BIGO.

Criado e testado com:

• Versão 13.1.0 do SDK do Google Mobile Ads.
• Versão 5.1.0 do SDK de anúncio da BIGO.

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

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

Versão 5.0.6.0

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

Criado e testado com:

• Versão 12.14.0 do SDK do Google Mobile Ads.
• Versão 5.0.6 do SDK de anúncio da BIGO.