Integrar o OpenWrap da PubMatic (Beta) à Mediação da AdMob

Este guia mostra como usar o GMA Next-Gen SDK para carregar e exibir anúncios de display da PubMatic com a Mediação da AdMob, incluindo integrações em hierarquia e de lances. 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 e o adaptador da PubMatic 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
Premiado
Intersticial premiado
Nativo

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

Pré-requisitos

Antes de continuar, verifique o seguinte:

• API Android nível 24 ou mais recente.

• Versão mais recente do GMA Next-Gen SDK.

• Configure 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 Adicionar app.

Selecione a Plataforma, o URL da app store e o Nome do app.

Em Caminho de integração, selecione Android (Java / Kotlin) e escolha 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, configure um arquivo app-ads.txt para seu app.

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 da PubMatic na interface da AdMob

Definir as configurações de mediação do bloco de anúncios

Adicione o SDK OpenWrap da PubMatic à configuração de mediação do seu bloco de anúncios.

Faça login na sua conta da AdMob. Navegue até a guia Mediação. Se você tiver um grupo de mediação que quer modificar, clique no nome dele para editar e pule para Adicionar o SDK do PubMatic OpenWrap como uma origem de anúncios.

Para criar um novo grupo de mediação, selecione Criar grupo de mediação.

Insira o formato e a plataforma do anúncio, depois clique em Continuar.

Dê um nome ao grupo de mediação e selecione os locais de segmentação. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.

Associe esse grupo de mediação a um ou mais dos seus blocos de anúncios da AdMob. Em seguida, clique em Concluído.

O card "Blocos de anúncios" vai aparecer com os blocos selecionados:

Adicionar o SDK OpenWrap da PubMatic como uma origem de anúncios

Lances

Na seção Origens de anúncios, encontre o card Lances e selecione Adicionar origem de anúncios. Em seguida, selecione SDK OpenWrap da PubMatic.

Clique em Confirmar e concordar e em Salvar.



Se você já tiver um mapeamento para o SDK OpenWrap da PubMatic, selecione-o. Caso contrário, clique em Adicionar mapeamento.



Em seguida, insira o ID do bloco de anúncios do OpenWrap visto na seção anterior. Em seguida, clique em Concluído.

Importante: o ID do publisher do OpenWrap e o ID do perfil do OpenWrap precisam estar associados ao app segmentado, como na interface do SDK OpenWrap da PubMatic.

Cascata

No card Hierarquia da seção Origens de anúncios, selecione Adicionar origem do anúncio.

Selecione SDK OpenWrap da PubMatic. Em seguida, insira um valor de eCPM para o SDK PubMatic OpenWrap e clique em Continuar.

Observação: só é necessário configurar a otimização da origem de anúncios uma vez por rede.

Se você já tiver um mapeamento para o SDK do PubMatic OpenWrap, selecione-o. Caso contrário, clique em Adicionar mapeamento.



Em seguida, insira o ID do bloco de anúncios do OpenWrap obtido na seção anterior. Em seguida, clique em Concluído.

Importante: o ID do publisher do OpenWrap e o ID do perfil do OpenWrap precisam ser associados ao app segmentado, como na interface do SDK OpenWrap da PubMatic.

Adicionar a PubMatic à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA

Importante: verifique se você tem permissão de gerenciamento da conta para concluir a configuração do consentimento da UE e do GDPR, das regulamentações estaduais dos EUA e da plataforma de mensagens de usuários. Consulte Gerenciar o acesso do usuário à sua conta para mais detalhes.

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 do OpenWrap da PubMatic

Observação: a falha na integração das versões compatíveis do SDK do OpenWrap da PubMatic e do SDK dos anúncios para dispositivos móveis do Google pode causar problemas de build.

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 e do adaptador do SDK do PubMatic OpenWrap:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:pubmatic:5.4.1.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 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 versão 4.7.0.0 e mais recentes do adaptador do SDK do PubMatic OpenWrap para Android aceitam a transmissão de indicadores de consentimento do GDPR de plataformas de gestão de consentimento que se integram ao Estrutura de Transparência e Consentimento (TCF) do IAB para o SDK do PubMatic OpenWrap. Para mais informações, consulte Transmitir 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 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 da GPP.

Etapa 5: adicionar o código necessário

Não é necessário nenhum código adicional para a integração do SDK OpenWrap da PubMatic.

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste na AdMob.

Importante: desative o modo de teste da AdMob e do SDK do PubMatic OpenWrap antes de lançar o app.

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 objetos NativeAd. 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
Loja
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 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	ID do perfil ausente 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 empresa para mais detalhes.

Registro de alterações do adaptador de mediação da PubMatic para Android

Próxima versão

• Atualizamos o adaptador para usar a API InitializationCompleteCallback.onInitializationFailed(AdError).

Versão 5.4.1.0

• Atualizamos o nível mínimo necessário da API Android para 24.
• Compatibilidade verificada com o SDK 5.4.1 da Pubmatic.

Criado e testado com:

• Versão 25.5.0 do SDK do Google Mobile Ads.
• Versão 1.5.0 do SDK Next-Gen do Google Mobile Ads.
• Versão 5.4.1 do SDK da Pubmatic

Versão 5.4.0.0

• Compatibilidade verificada com o SDK 5.4.0 da Pubmatic.

Criado e testado com:

• Versão 25.4.0 do SDK do Google Mobile Ads.
• Versão 1.4.0 do SDK Next-Gen do Google Mobile Ads.
• Versão 5.4.0 do SDK da Pubmatic.

Versão 5.3.0.1

• Fixe a dependência do Kotlin do adaptador em 1.9.0 (a versão mínima do Kotlin compatível com o SDK do GMA NextGen).

Criado e testado com:

• Versão 25.4.0 do SDK do Google Mobile Ads.
• Versão 1.4.0 do SDK Next-Gen do Google Mobile Ads.
• Versão 5.3.0 do SDK da Pubmatic.

Versão 5.3.0.0

• Compatibilidade verificada com o SDK 5.3.0 da Pubmatic.

Criado e testado com:

• Versão 25.4.0 do SDK do Google Mobile Ads.
• Versão 1.4.0 do SDK Next-Gen do Google Mobile Ads.
• Versão 5.3.0 do SDK da Pubmatic.

Versão 5.2.0.0

• Compatibilidade verificada com o SDK 5.2.0 da Pubmatic.

Criado e testado com:

• Versão 25.4.0 do SDK do Google Mobile Ads.
• Versão 1.3.0 do SDK Next-Gen do Google Mobile Ads.
• Versão 5.2.0 do SDK da Pubmatic.

Versão 5.1.2.2

• Mapeia AgeRestrictedTreatment para a API COPPA da PubMatic.

Criado e testado com:

• Versão 25.4.0 do SDK do Google Mobile Ads.
• Versão 1.2.1 do SDK Next-Gen do Google Mobile Ads.
• Versão 5.1.2 do SDK da Pubmatic

Versão 5.1.2.1

• Adicionamos suporte a vídeos de anúncios nativos(VAST) usando a API MediaView do OpenWrapSDK da PubMatic.

Criado e testado com:

• Versão 25.2.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.2.1 do SDK Next-Gen do Google Mobile Ads.
• Versão 5.1.2 do SDK da Pubmatic

Versão 5.1.2.0

• Compatibilidade verificada com o SDK 5.1.2 da Pubmatic.

Criado e testado com:

• Versão 25.2.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.1.0 do SDK Next-Gen do Google Mobile Ads.
• Versão 5.1.2 do SDK da Pubmatic

Versão 5.1.1.0

• Compatibilidade verificada com o SDK 5.1.1 da Pubmatic.

Criado e testado com:

• Versão 25.2.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 1.0.1 do SDK Next-Gen do Google Mobile Ads.
• Versão 5.1.1 do SDK da Pubmatic

Versão 5.1.0.0

• Compatibilidade verificada com o SDK 5.1.0 da Pubmatic.

Criado e testado com:

• Versão 25.2.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 5.1.0 do SDK da Pubmatic

Versão 5.0.0.1

• Adicionamos uma propriedade para criar o adaptador com a dependência do SDK do GMA Next-Gen.
• Correção de um bug em que o objeto mediationUtils não era inicializado.

Criado e testado com:

• Versão 25.1.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 5.0.0 do SDK da Pubmatic.

Versão 5.0.0.0

• Compatibilidade verificada com o SDK 5.0.0 da PubMatic.

Criado e testado com:

• Versão 25.0.0 do SDK do Google Mobile Ads.
• Versão 5.0.0 do SDK da Pubmatic.

Versão 4.12.0.0

• Compatibilidade verificada com o SDK 4.12.0 da Pubmatic.

Criado e testado com:

• Versão 24.9.0 do SDK do Google Mobile Ads.
• Versão 4.12.0 do SDK da Pubmatic.

Versão 4.11.0.1

• Adicionamos suporte para encaminhar o parâmetro tagForUnderAgeOfConsent do SDK dos anúncios para dispositivos móveis do Google ao SDK da PubMatic.

Criado e testado com:

• Versão 24.9.0 do SDK do Google Mobile Ads.
• Versão 4.11.0 do SDK da Pubmatic.

Versão 4.11.0.0

• Compatibilidade verificada com o SDK 4.11.0 da Pubmatic.

Criado e testado com:

• Versão 24.9.0 do SDK do Google Mobile Ads.
• Versão 4.11.0 do SDK da Pubmatic.

Versão 4.10.0.1

• Adicionamos uma lista de recursos para o formato de anúncio nativo em hierarquia.

Criado e testado com:

• Versão 24.7.0 do SDK do Google Mobile Ads.
• Versão 4.10.0 do SDK da Pubmatic

Versão 4.10.0.0

• Compatibilidade verificada com o SDK 4.10.0 da Pubmatic.

Criado e testado com:

• Versão 24.7.0 do SDK do Google Mobile Ads.
• Versão 4.10.0 do SDK da Pubmatic

Versão 4.9.1.0

• Compatibilidade verificada com o SDK 4.9.1 da Pubmatic.

Criado e testado com:

• Versão 24.6.0 do SDK do Google Mobile Ads.
• Versão 4.9.1 do SDK da Pubmatic

Versão 4.8.0.1

• Adicionamos suporte para anúncios intersticiais em hierarquia.
• Adicionamos suporte a anúncios premiados em hierarquia.
• Adição de suporte a anúncios de banner em hierarquia.
• Adicionamos suporte a anúncios nativos em hierarquia.
• Compatibilidade verificada com o SDK 4.8.0 da Pubmatic.

Criado e testado com:

• Versão 24.6.0 do SDK do Google Mobile Ads.
• Versão 4.8.0 do SDK da Pubmatic.

Versão 4.8.0.0

• Compatibilidade verificada com o SDK 4.8.0 da Pubmatic.

Criado e testado com:

• Versão 24.4.0 do SDK do Google Mobile Ads.
• Versão 4.8.0 do SDK da Pubmatic.

Versão 4.7.1.1

• Tamanho fixo do ícone Opções de Anúncios

Criado e testado com:

• Versão 24.4.0 do SDK do Google Mobile Ads.
• Versão 4.7.1 do SDK da Pubmatic.

Versão 4.7.1.0

• Compatibilidade verificada com o SDK 4.7.1 da Pubmatic.

Criado e testado com:

• Versão 24.4.0 do SDK do Google Mobile Ads.
• Versão 4.7.1 do SDK da Pubmatic.

Versão 4.7.0.1

• Dependências internas corrigidas.

Criado e testado com:

• Versão 24.4.0 do SDK do Google Mobile Ads.
• Versão 4.7.0 do SDK da Pubmatic.

Versão 4.7.0.0

• Versão inicial.
• Adicionamos suporte a lances para formatos de anúncio de banner, intersticial, premiado e nativo.
• Compatibilidade verificada com o SDK 4.7.0 da Pubmatic.

Criado e testado com:

• Versão 24.4.0 do SDK do Google Mobile Ads.
• Versão 4.7.0 do SDK da Pubmatic.