Este guia mostra como usar Google Mobile Ads Unity Plugin para carregar e exibir anúncios da PubMatic usando mediação, 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úncio aceitos
O adaptador de mediação do Ad Manager para a 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.
Pré-requisitos
Antes de continuar, verifique o seguinte:
- Versão mais recente do Google Mobile Ads Unity Plugin.
- Unity Editor versão 2019.4 ou mais recente.
- Para implantar no Android
- API Android nível 24 ou mais recente.
- Para implantar 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.
Etapa 1: definir as configurações na interface do SDK OpenWrap 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 Adicionar app.
Selecione a Plataforma, o URL da App Store e o Nome do app.
Android
Em Caminho de integração, selecione Unity e escolha AdMob - Lances do SDK como o Caminho de subintegração. Em seguida, clique no botão Adicionar app.
iOS
Em Caminho de integração, selecione Unity e AdMob - lances do SDK como o Caminho de subintegração. Em seguida, clique no botão Adicionar 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, crie um arquivo app-ads.txt para o Ad Manager.
Antes de finalizar o app, você vai receber as entradas adequadas para
adicionar ao app-ads.txt.
Para mais informações sobre como implementar o 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 Blocos de anúncios, selecione o app que você criou na seção anterior e clique no botão Criar bloco de anúncios.
Preencha o formulário com os detalhes do bloco de anúncios e clique em Salvar.
Anote o ID do bloco de anúncios do OpenWrap recém-criado.
Encontrar seu ID do publisher
Acesse o painel do Analytics. Passe o cursor sobre o ícone de perfil e anote seu ID.
Etapa 2: configurar a demanda do SDK OpenWrap da PubMatic na interface do Ad Manager
Definir as configurações de mediação do bloco de anúncios
Android
Para ver as instruções, consulte a etapa 2 no guia para Android.
iOS
Para instruções, consulte a etapa 2 no 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 do Ad Manager.
Etapa 3: importar o SDK e o adaptador OpenWrap da PubMatic
OpenUPM-CLI
Se a OpenUPM-CLI estiver instalada, execute o seguinte comando no diretório raiz do projeto para instalar o plug-in de mediação do SDK OpenWrap da PubMatic dos Anúncios para dispositivos móveis do Google para Unity:
openupm add com.google.ads.mobile.mediation.pubmaticOpenUPM
No editor do projeto do Unity, selecione Edit > Configurações do Projeto > Package Manager para abrir as configurações do gerenciador de pacotes do Unity.
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 Mediação do Google Mobile Ads PubMatic e clique em Instalar.
Pacote do Unity
Faça o download da versão mais recente do plug-in de mediação do Google Mobile Ads para o SDK do PubMatic OpenWrap no link de download do Registro de alterações e extraia o GoogleMobileAdsPubMaticMediation.unitypackage do arquivo ZIP.
No editor do projeto do Unity, selecione Assets > Import Package >
Custom Package e encontre o arquivo
GoogleMobileAdsPubMaticMediation.unitypackage
que você salvou. Verifique se todos os arquivos estão selecionados e clique em
Importar.
Em seguida, selecione Recursos > Gerenciador de dependências externas >
Resolvedor do Android > Forçar resolução. A biblioteca do External Dependency Manager
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 OpenWrap da PubMatic
Consentimento da UE e 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 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 Aprovar o GDPR e o consentimento 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 que possa participar da venda de informações pessoais e siga as orientações de cada uma delas 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 string da CCPA.
Etapa 5: adicionar o código necessário
Android
Não é necessário nenhum código adicional para a integração com a PubMatic.
iOS
Integração da SKAdNetwork
Siga a documentação do SDK do PubMatic OpenWrap 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 no Ad Manager.
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 origens de anúncios PubMatic OpenWrap.
Códigos de erro
Se o adaptador não receber um anúncio da PubMatic, os editores 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 tem um ID de publisher obrigatório. |
| 102 | com.google.ads.mediation.pubmatic | O formato do anúncio não é compatível com o PubMatic ou está ausente nos dados de indicador de RTB. |
| 103 | com.google.ads.mediation.pubmatic | Falha ao apresentar um anúncio porque ele não estava pronto. |
| 104 | com.google.ads.mediation.pubmatic | O ID do perfil está faltando ou é inválido. |
| 105 | com.google.ads.mediation.pubmatic | O ID do bloco de anúncios está ausente ou vazio. |
| 106 | com.google.ads.mediation.pubmatic | O anúncio premiado retornado é nulo. |
| 107 | com.google.ads.mediation.pubmatic | O tamanho do anúncio de banner é inválido. |
| 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 tem um ID de 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 incompatível foi especificado nos parâmetros da solicitação. |
| 103 | com.google.ads.mediation.pubmatic | Configuração de anúncio inválida para carregar um anúncio. |
| 104 | com.google.ads.mediation.pubmatic | Falha ao 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 imagens de anúncios nativos. |
| 107 | com.google.ads.mediation.pubmatic | A configuração do anúncio não tem um ID do publisher. |
| 108 | com.google.ads.mediation.pubmatic | A configuração do anúncio não tem um ID de perfil. |
| 109 | com.google.ads.mediation.pubmatic | A configuração de anúncio contém um ID de perfil que não é um número. |
| 110 | com.google.ads.mediation.pubmatic | A configuração do anúncio não tem um ID do bloco de anúncios. |
| 111 | com.google.ads.mediation.pubmatic | O SDK OpenWrap da PubMatic não conseguiu instanciar um tamanho de anúncio. |
| 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 da PubMatic para Unity
Versão 2.4.1 (em andamento)
Versão 2.4.0
- Compatível com a versão 5.4.0.0 do adaptador da PubMatic para Android.
- Compatível com a versão 5.4.0.0 do adaptador da PubMatic para iOS.
- Criado e testado com a versão 11.5.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.3.0
- Compatibilidade com a versão 5.3.0.0 do adaptador do Android da PubMatic.
- Compatível com a versão 5.3.0.0 do adaptador do iOS da PubMatic.
- Criada e testada com a versão 11.4.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.2.0
- Compatível com a versão 5.2.0.0 do adaptador da PubMatic para Android.
- Compatível com a versão 5.2.0.0 do adaptador do iOS da PubMatic.
- Criado e testado com a versão 11.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.1.3
- Compatível com a versão 5.1.2.2 do adaptador da PubMatic para Android.
- Compatível com a versão 5.1.1.0.1 do adaptador do iOS da PubMatic.
- Criada e testada com a versão 11.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.1.2
- Compatível com a versão 5.1.2.0 do adaptador da PubMatic para Android.
- Compatível com a versão 5.1.1.0 do adaptador do iOS da PubMatic.
- Criada e testada com a versão 11.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.1.1
- Compatível com a versão 5.1.1.0 do adaptador da PubMatic para Android.
- Compatível com a versão 5.1.0.1 do adaptador da PubMatic para iOS.
- Criada e testada com a versão 11.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.1.0
- Compatível com a versão 5.1.0.0 do adaptador da PubMatic para Android.
- Compatível com a versão 5.1.0.0 do adaptador do 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 2.0.1
- Atualizamos o plug-in para incluir o framework dinâmico
OpenWrapSDKem todas as segmentações do iOS. - Compatível com a versão 5.0.0.1 do adaptador da PubMatic para Android.
- Compatível com a versão 5.0.1.0 do adaptador do 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 2.0.0
- Compatível com a versão 5.0.0.1 do adaptador da PubMatic para Android.
- Compatível com a versão 5.0.0.0 do adaptador da PubMatic para iOS.
- 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.5.0
- Compatível com a versão 4.12.0.0 do adaptador da PubMatic para Android.
- Compatível com a versão 4.12.0.0 do adaptador da PubMatic para iOS.
- 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 da PubMatic para Android.
- Compatível com a versão 4.11.0.1 do adaptador da PubMatic para iOS.
- Criada e testada 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
- Suporte para a versão 4.11.0.0 do adaptador do Android da PubMatic.
- Compatível com a versão 4.11.0.0 do adaptador do iOS da PubMatic.
- Criada e testada 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 da PubMatic para Android.
- Compatível com a versão 4.10.0.0 do adaptador da PubMatic para iOS.
- Criada e testada 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 da PubMatic para Android.
- Compatível com a versão 4.10.0.0 do adaptador da PubMatic para iOS.
- 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 da PubMatic para Android.
- Compatível com a versão 4.9.0.0 do adaptador do 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 da PubMatic para Android.
- Compatível com a versão 4.8.1.0 do adaptador do 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 da PubMatic para Android.
- Compatível com a versão 4.8.1.0 do adaptador da PubMatic para iOS.
- Criada e testada com a versão 10.4.2 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.