Este guia mostra como usar Google Mobile Ads Unity Plugin para carregar e exibir anúncios da PubMatic usando a Mediação da AdMob, incluindo as integrações de lances. Ele explica como adicionar a PubMatic à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da PubMatic a um app Unity.
Integrações e formatos de anúncios compatíveis
O adaptador de mediação da AdMob para PubMatic tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | |
| Cascata | |
| Formatos | |
| Abertura do aplicativo | |
| Banner | |
| Intersticial | 1 |
| Premiado | 1 |
| Intersticial premiado | |
1 Esse formato está na versão Beta. Entre em contato com seu gerente de contas para solicitar acesso.
Requisitos
- Mais recente Google Mobile Ads Unity Plugin
- Unity 2019.4 ou mais recente
- Para implantação no Android
- Nível 23 ou mais recente da API do Android
- Para implantação 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 Configurar Google Mobile Ads Unity Plugin para mais detalhes.
- Configurar a Mediação da AdMob
Etapa 1: definir as configurações na interface da PubMatic
Inscreva-se ou faça login na sua conta da PubMatic e selecione o card SDK OpenWrap.
Adicionar um novo aplicativo
Acesse a guia Apps e clique no botão Add App.
Selecione a Platform, o App Store URL e o App Name para seu app.
Android
Em Integration Path, selecione Unity e selecione AdMob - Lances do SDK como o Sub-integration Path. Em seguida, clique no botão Add App.
iOS
Em Integration Path, selecione Unity e selecione AdMob - Lances do SDK como o Sub-integration Path. Em seguida, clique no botão Add App.
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.
Antes da finalização do app, as entradas adequadas serão apresentadas para você adicionar ao arquivo app-ads.txt.
Para mais informações sobre como implementar app-ads.txt para a PubMatic,
consulte Como implementar o app-ads.txt.
ID do perfil
Depois que o app for criado, acesse a guia Apps e anote o ID do perfil do aplicativo recém-criado.
Crie um bloco de anúncios
Na guia Ad Units, selecione o app criado na seção anterior e clique no botão Create Ad Unit.
Preencha o formulário com os detalhes do bloco de anúncios e clique em Save.
Anote o ID do bloco de anúncios OpenWrap recém-criado.
Encontrar seu ID do publisher
Navegue até o painel do Google Analytics. Passe o cursor sobre o ícone do perfil e anote seu ID.
Etapa 2: configurar a demanda da PubMatic na interface da AdMob
Definir as configurações de mediação do bloco de anúncios
Android
Para instruções, consulte a etapa 2 do guia para Android.
iOS
Para instruções, consulte a etapa 2 do guia para iOS.
Adicionar a PubMatic à 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 PubMatic à 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 da PubMatic
OpenUPM-CLI
Se você tiver o OpenUPM-CLI instalado, poderá instalar o Plug-in de mediação do SDK OpenWrap da PubMatic dos Anúncios para Dispositivos Móveis do Google para Unity no seu projeto executando o seguinte comando no diretório raiz do projeto:
openupm add com.google.ads.mobile.mediation.pubmaticOpenUPM
No editor de projetos do Unity, selecione Edit > Project Settings > Package Manager para abrir as configurações do Unity Package Manager.
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
Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.
Selecione o pacote Google Mobile Ads PubMatic Mediation e clique em Install.
Pacote do Unity
Faça o download da versão mais recente do Plug-in de mediação dos Anúncios para Dispositivos Móveis do Google para
o SDK OpenWrap da PubMatic no link de download em
o
registro de alterações
e extraia o
GoogleMobileAdsPubMaticMediation.unitypackage do arquivo
ZIP.
No editor de projetos do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsPubMaticMediation.unitypackage que você fez o download. Verifique se todos os arquivos estão selecionados e clique em Import.
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.
Etapa 4: implementar configurações de privacidade no SDK da PubMatic
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 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.
A PubMatic lê automaticamente o consentimento do GDPR definido por plataformas de gestão de consentimento que aceitam a especificação de consentimento adicional do Google, incluindo o SDK da UMP. Para mais informações, consulte Transmitir o consentimento do GDPR e do 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 na sua cadeia de mediação que possa participar da venda de informações pessoais e siga as orientações de cada uma dessas redes para garantir a conformidade.
A PubMatic lê automaticamente o consentimento da CCPA definido por plataformas de gestão de consentimento que aceitam a especificação de consentimento adicional do Google, incluindo o SDK da UMP. Para mais informações, consulte Definir a string da CCPA.
Etapa 5: adicionar o código necessário
Android
Nenhum código extra é necessário para a integração da PubMatic.
iOS
Integração da SKAdNetwork
Siga a documentação da PubMatic
para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do seu projeto.
Etapa 6: testar a implementação
Ativar anúncios de teste
Certifique-se de registrar seu dispositivo de teste na AdMob.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do SDK OpenWrap da PubMatic, ative o teste de uma única origem de anúncios no Ad Inspector usando as PubMatic (lances) origens de anúncios.
Códigos de erro
Se o adaptador não receber um anúncio da PubMatic, os publishers poderão verificar
o erro na resposta do anúncio usando
ResponseInfo nas
seguintes classes:
Android
com.pubmatic.sdk
com.google.ads.mediation.pubmatic
iOS
GADMediationAdapterPubMatic
Confira os códigos e as mensagens correspondentes gerados pelo adaptador da PubMatic quando um anúncio não é carregado:
Android
| Código do erro | Domínio | Motivo |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | A configuração do servidor não incluía um ID do publisher obrigatório. |
| 102 | com.google.ads.mediation.pubmatic | A configuração de anúncios é inválida para carregar um anúncio. |
| 103 | com.google.ads.mediation.pubmatic | Não foi possível apresentar um anúncio porque ele não estava pronto. |
| 1001-5002 | Enviado pelo SDK da PubMatic | O SDK da PubMatic retornou um erro. Consulte a documentação da PubMatic para mais detalhes. |
iOS
| Código do erro | Domínio | Motivo |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | A configuração do servidor não incluía um ID do publisher obrigatório. |
| 102 | com.google.ads.mediation.pubmatic | A solicitação de coleta de indicadores de lances falhou porque vários formatos, nenhum formato ou um formato não compatível foram especificados nos parâmetros da solicitação. |
| 103 | com.google.ads.mediation.pubmatic | A configuração de anúncios é inválida para carregar um anúncio. |
| 104 | com.google.ads.mediation.pubmatic | Não foi possível apresentar um anúncio intersticial porque ele não estava pronto. |
| 105 | com.google.ads.mediation.pubmatic | Não foi possível apresentar um anúncio premiado porque ele não estava pronto. |
| 106 | com.google.ads.mediation.pubmatic | Não foi possível carregar uma das origens de imagem de anúncios nativos. |
| 1001-5002 | Enviado pelo SDK da PubMatic | O SDK da PubMatic retornou um erro. Consulte a documentação da PubMatic para mais detalhes. |
Registro de alterações do Plug-in de mediação do Unity da PubMatic
Versão 2.0.0 (em andamento)
Versão 1.5.0
- Compatível com a versão 4.12.0.0 do adaptador Android da PubMatic.
- Compatível com a versão 4.12.0.0 do adaptador iOS da PubMatic.
- Criado e testado com a versão 11.0.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.
Versão 1.4.1
- Compatível com a versão 4.11.0.1 do adaptador Android da PubMatic.
- Compatível com a versão 4.11.0.1 do adaptador iOS da PubMatic.
- Criado e testado com a versão 10.7.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.
Versão 1.4.0
- Compatível com a versão 4.11.0.0 do adaptador Android da PubMatic.
- Compatível com a versão 4.11.0.0 do adaptador iOS da PubMatic.
- Criado e testado com a versão 10.6.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.
Versão 1.3.1
- Compatível com a versão 4.10.0.1 do adaptador Android da PubMatic.
- Compatível com a versão 4.10.0.0 do adaptador iOS da PubMatic.
- Criado e testado com a versão 10.6.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.
Versão 1.3.0
- Compatível com a versão 4.10.0.0 do adaptador Android da PubMatic.
- Compatível com a versão 4.10.0.0 do adaptador iOS da PubMatic.
- Criado e testado com a versão 10.6.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.
Versão 1.2.0
- Compatível com a versão 4.9.1.0 do adaptador Android da PubMatic.
- Compatível com a versão 4.9.0.0 do adaptador iOS da PubMatic.
- Criado e testado com a versão 10.5.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.
Versão 1.1.0
- Compatível com a versão 4.9.1.0 do adaptador Android da PubMatic.
- Compatível com a versão 4.8.1.0 do adaptador iOS da PubMatic.
- Criado e testado com a versão 10.5.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.
Versão 1.0.0
- Primeira versão.
- Compatível com a versão 4.8.0.0 do adaptador Android da PubMatic.
- Compatível com a versão 4.8.1.0 do adaptador iOS da PubMatic.
- Criado e testado com a versão 10.4.2 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.