Integrar a PubMatic aos lances

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:

¹ A integração em hierarquia está na versão Alfa.

² 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.

• Mais recente GMA Next-Gen SDK.

• Leia todo o guia para iniciantes da mediação .

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"

Ativar o compartilhamento de indicador seguro

Compartilhar indicadores seguros em solicitações de lance

Permitir o compartilhamento de indicadores seguros para Lances do SDK

Configurar os lances do SDK OpenWrap da PubMatic

Configurar o mapeamento de blocos de anúncios

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.

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: