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:
| Integração | |
|---|---|
| Lances | 1 |
| Cascata | |
| Formatos | |
| Abertura do app | |
| Banner | |
| Intersticial | |
| Premiado | |
| Intersticial premiado | |
| Nativo | |
1 A integração de lances está em Beta fechado. Entre em contato com seu gerente de contas para solicitar acesso.
Requisitos
- Destino de implantação do iOS 13.0 ou mais recente.
Mais recentes de Google Mobile Ads SDK
Leia todo o guia para iniciantes da mediação.
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
No card Lances da seção Origens de anúncios, 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 slot obtido na seção anterior. Em seguida, clique em Concluído.
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 BIGO TECHNOLOGY PTE LTD à lista de parceiros de publicidade das regulamentações europeias e 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
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.
Swift
BigoAdSdk.setUserConsentWithOption(BigoConsentOptionsCCPA, consent: true)
Objective-C
[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 fornece IDs de aplicativo e IDs de slot de anúncio de teste para iOS, ajudando com testes e 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.
| Campo | Recursos sempre incluídos pelo adaptador do SDK 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 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:
| Código do erro | Domínio | Motivo |
|---|---|---|
| 101 | com.google.ads.mediation.bigo | A configuração do servidor não tem um ID do aplicativo obrigatório. |
| 102 | com.google.ads.mediation.bigo | Configuração de anúncio inválida. |
| 103 | com.google.ads.mediation.bigo | Falha na apresentação do anúncio. |
| 104 | com.google.ads.mediation.bigo | Tamanho de banner incompatível. |
| 105 | com.google.ads.mediation.bigo | A Bigo carregou um anúncio de banner, mas não uma visualização de anúncio. |
| 1000-1100 | Enviado pelo SDK de anúncios da BIGO. | O SDK do BIGO Ads retornou um erro. Consulte a documentação do SDK do BIGO Ads para mais detalhes. |
Registro de alterações do adaptador de mediação da BIGO Ads para iOS
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
ageRestrictedTreatmentdo 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 de anúncio 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.