Este guia mostra como usar GMA Next-Gen SDK para carregar e exibir anúncios de display da PubMatic usando mediação, incluindo integrações de lances e em hierarquia. Ele explica como adicionar o SDK OpenWrap da PubMatic à configuração de mediação de um bloco de anúncios e como integrar o SDK OpenWrap da PubMatic e o adaptador a um app Android.
Integrações e formatos de anúncio aceitos
O adaptador de mediação da PubMatic tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | |
| Cascata | 1 |
| Formatos | |
| Abertura do app | |
| Banner | |
| Intersticial | 2 |
| Premiado | 2 |
| Intersticial premiado | |
| Nativo | 2 |
1 A integração em hierarquia está na versão Alfa.
2 Todos os outros formatos de anúncio aceitos, além dos banners, estão na versão Alfa.
Requisitos
- API Android nível da API 24 ou mais recente.
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 plataforma, o URL da App Store e o nome do app para seu app.
Em Integration Path, selecione Android (Java / Kotlin) 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,
crie um arquivo app-ads.txt para o Ad Manager.
Antes que o app seja finalizado, você vai receber as entradas adequadas para 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
Acesse 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 do Ad Manager
Faça login na sua conta do Ad Manager.
Adicionar o SDK OpenWrap da PubMatic em "Empresas"
Lances
Essa etapa não é necessária para integrações de lances.
Cascata
Acesse Admin > Companies e clique no botão New company na guia All companies. Selecione rede de publicidade.
Selecione PubMatic OpenWrap SDK como a rede de publicidade, insira um Name exclusivo e ative a Mediação.
Não é necessário inserir um Username ou Password. Clique em Save quando terminar.
Ativar o compartilhamento de indicador seguro
Lances
Acesse Admin > Global settings. Acesse a guia Ad Exchange account settings e ative a opção Compartilhamento de indicador seguro. Clique em Save.
Cascata
Essa etapa não é necessária para integrações em hierarquia.
Compartilhar indicadores seguros em solicitações de lance
Lances
Acesse Inventory > Secure Signals. Em Secure signals, pesquise PubMatic e ative a opção Enable app integration.
Clique em Save.
Cascata
Essa etapa não é necessária para integrações em hierarquia.
Permitir o compartilhamento de indicadores seguros para Lances do SDK
Lances
Acesse Delivery > Demand channel settings. Na guia Default settings, ative a opção Allow secure signal sharing para Lances do SDK.
Clique em Save.
Cascata
Essa etapa não é necessária para integrações em hierarquia.
Configurar os lances do SDK OpenWrap da PubMatic
Lances
Acesse Delivery > Bidders e clique em Lances do SDK.
Clique em New bidder.
Selecione PubMatic OpenWrap SDK como o bidder.
Clique em Continue para ativar os Lances do SDK para esse bidder.
Clique em Concluído.
Cascata
Essa etapa não é necessária para integrações em hierarquia.
Configurar o mapeamento de blocos de anúncios
Lances
Acesse Delivery > Bidders e clique em Lances do SDK.
Selecione a empresa para o SDK OpenWrap da PubMatic.
Acesse a guia Mapeamento de blocos de anúncios e clique em Novo mapeamento de blocos de anúncios.
Escolha bloco de anúncios específico. Selecione um bloco e um formato de anúncios, Mobile app como o tipo de inventário e seu Mobile application. Em seguida, insira o ID do bloco de anúncios OpenWrap visto na seção anterior.
Por fim, clique em Save.
precisam estar associados ao app segmentado, como na interface do SDK OpenWrap da PubMatic.
Cascata
Acesse Delivery > Yield groups e clique no botão New yield group. Selecione seu Mobile application.
Role a tela para baixo e clique em Adicionar parceiro de rendimento.
Selecione a empresa criada para o SDK OpenWrap da PubMatic na seção anterior. Escolha Mobile SDK mediation como o Integration type, Android como a Platform e Active como o Status.
Insira o ID do bloco de anúncios OpenWrap visto na seção anterior e o valor do CPM padrão. Clique em Save.
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 OpenWrap da PubMatic e o adaptador
Integração com o Android Studio (recomendada)
No arquivo settings.gradle.kts do projeto, adicione os seguintes repositórios:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://repo.pubmatic.com/artifactory/public-repos")
}
}
}
Em seguida, no arquivo build.gradle.kts do app, adicione as seguintes dependências e configurações de implementação. Use as versões mais recentes do SDK OpenWrap da PubMatic e do adaptador:
dependencies {
implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
implementation("com.google.ads.mediation:pubmatic:5.0.0.0")
}
configurations {
all {
exclude(group = "com.google.android.gms", module = "play-services-ads")
exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}
}
Etapa 4: implementar configurações de privacidade na PubMatic
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.
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 do GPP 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 GPP.
Etapa 5: adicionar o código necessário
Nenhum código extra é necessário para a integração do SDK OpenWrap da PubMatic.
Etapa 6: testar a implementação
Ativar anúncios de teste
Certifique-se de registrar seu dispositivo de teste para 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.
Etapas opcionais
Anúncios nativos
Renderização do anúncio
O adaptador da PubMatic retorna os anúncios nativos como
NativeAd
objetos. Ele preenche os seguintes
campos
para um
NativeAd.
| Campo | Recursos sempre incluídos pelo adaptador da PubMatic |
|---|---|
| Título | |
| Imagem | |
| Corpo | |
| Ícone | |
| Call-to-action | |
| Classificação por estrela | |
| Repositório | |
| Preço | |
| Advertiser |
Códigos de erro
Se o adaptador não receber um anúncio da PubMatic, verifique o
erro subjacente na resposta do anúncio usando
ResponseInfo.getAdSourceResponses()
nas seguintes classes:
com.pubmatic.sdk
com.google.ads.mediation.pubmatic
Confira os códigos e as mensagens correspondentes gerados pelo adaptador da PubMatic quando um anúncio não é carregado:
| 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. |