Este guia mostra como usar Google Mobile Ads SDK para carregar e exibir anúncios do SDK do BIGO Ads usando a mediação, 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.3 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, crie um arquivo app-ads.txt para o Ad Manager.
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 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 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 cascata.
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 cascata.
Configurar os lances do SDK do BIGO Ads
Lances
Acesse Exibição > Bidders e clique em Acessar os Lances do SDK.
Clique em Novo bidder.
Selecione SDK da BIGO Ads 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 cascata.
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 da BIGO Ads.
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 slot obtido na seção anterior.
Por fim, clique em Salvar.
Cascata
Acesse Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento. Selecione seu Aplicativo para dispositivos móveis.
Role a tela para baixo e clique em Adicionar parceiro de rendimento.
Selecione a empresa que você criou para o SDK do BIGO Ads na seção anterior. Escolha Mediação do SDK para dispositivos móveis como o Tipo de integração, iOS como a Plataforma e Ativo como o Status.
Insira o valor obtido na seção anterior e o valor do CPM padrão. Clique em Salvar.
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 do Ad Manager.
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 no Ad Manager.
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.