Integrar a ironSource à mediação

Selecione a plataforma: Android (Beta) Android iOS Unity Flutter

Este guia mostra como usar GMA Next-Gen SDK para carregar e exibir anúncios da ironSource Ads com a Mediação da AdMob, incluindo integrações em hierarquia. Ele aborda como adicionar a ironSource Ads à configuração de mediação de um bloco de anúncios, como otimizar a origem de anúncios e como integrar o SDK e o adaptador da ironSource Ads ao seu app Android.

Integrações e formatos de anúncio aceitos

O adaptador de mediação da ironSource Ads tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Intersticial premiado	^1
Nativo

¹ Esse formato é compatível apenas com a integração em hierarquia.

Requisitos

• API Android nível 24 ou mais recente.

• [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o adaptador da IronSource 8.5.0.1 ou uma versão mais recente (recomendamos usar a última versão).

• Última GMA Next-Gen SDK.

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

Etapa 1: definir as configurações na interface da ironSource Ads

Inscreva-se e faça login na sua conta da ironSource Ads.

Adicionar um novo aplicativo

Para adicionar um novo app, acesse Anúncios > Apps e clique em Adicionar app.

Preencha o formulário e clique em Adicionar app.

Anote a App Key, selecione os formatos de anúncio compatíveis e clique em Continue.

Criar uma instância

Em seguida, configure uma instância para o app que você adicionou.

Navegue até Anúncios > Configuração > Instâncias. Selecione o app e clique em Criar instância.

Lances

Preencha o formulário e selecione Lances em Preços. Clique em Salvar e fechar.

Observação: a ironSource Ads limita o número de instâncias que podem ser criadas. Se você receber um erro informando que não é possível criar mais instâncias, entre em contato com a equipe de suporte da ironSource Ads para receber ajuda.

Importante: se você quiser oferecer suporte a anúncios intersticiais premiados, selecione o formato Vídeo premiado e use esse ID da instância ao adicionar a ironSource Ads como uma origem de anúncio na etapa 2. Além disso, você precisa entrar em contato com a equipe de suporte da ironSource Ads em [e-mail] e configurar sua instância para suporte a anúncios intersticiais premiados.

Anote o ID da instância.

Cascata

Preencha o formulário e clique em Salvar e fechar.

Observação: a ironSource Ads limita o número de instâncias que podem ser criadas. Se você receber um erro informando que não é possível criar mais instâncias, entre em contato com a equipe de suporte da ironSource Ads para receber ajuda.

Importante: se você quiser oferecer suporte a anúncios intersticiais premiados, selecione o formato Vídeo premiado e use esse ID da instância ao adicionar a ironSource Ads como uma origem de anúncio na etapa 2. Além disso, você precisa entrar em contato com a equipe de suporte da ironSource Ads em [e-mail] e configurar sua instância para suporte a anúncios intersticiais premiados.

Anote o ID da instância.

Localizar sua chave da API Reporting

Lances

Essa etapa não é necessária para integrações de lances.

Cascata

Observação: somente usuários com permissões de colaborador ou administrador podem acessar as chaves de API.

Clique na guia API na página "My Account" e anote a Secret Key e o Refresh Token.

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.

Para implementar app-ads.txt na ironSource, consulte Revendedores autorizados da ironSource.

Ativar o modo de teste

Siga as instruções no guia de teste de integração da ironSource Ads para saber como ativar os anúncios de teste da plataforma.

Etapa 2: configurar a demanda da ironSource Ads na interface da AdMob

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

Adicione a ironSource Ads à configuração de mediação do seu bloco de anúncios.

Primeiro, 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 a ironSource Ads como uma origem de anúncios.

Para criar um 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 a ironSource Ads como uma origem de anúncios

Lances

No card Lances da seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione ironSource Ads.

Clique em Como assinar um contrato de parceria e estabeleça uma parceria de lances com a ironSource Ads.



Clique em Confirmar e concordar e em Continuar.



Se você já tiver um mapeamento para a ironSource Ads, selecione-o. Caso contrário, clique em Adicionar mapeamento.



Em seguida, insira a chave do app e o ID da instância obtidos na seção anterior. Em seguida, clique em Concluído.

Importante: a chave do app precisa estar associada ao app segmentado, como na interface da ironSource Ads.

Cascata

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

Selecione ironSource Ads e ative a chave Otimizar. Insira a chave secreta e o token de atualização obtidos na seção anterior para configurar a otimização da origem de anúncios para a ironSource Ads. Em seguida, insira um valor de eCPM para a ironSource Ads 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 a ironSource Ads, selecione-o. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira a chave do app e o ID da instância obtidos na seção anterior. Em seguida, clique em Concluído.

Importante: a chave do app precisa ser associada ao app segmentado, como na interface da ironSource Ads.

Observação: a otimização da origem de anúncios leva alguns dias para coletar dados suficientes e calcular com precisão o eCPM de uma rede de mediação. Enquanto isso, o status da otimização é PENDING. Portanto, você precisa definir manualmente um valor de eCPM para a rede. Depois que o eCPM for calculado, a origem de anúncios começará a atualizá-lo automaticamente em seu nome.

Adicionar a ironSource Mobile à 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 ironSource Mobile à 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 ironSource Ads

Observação: deixar de integrar as versões compatíveis do SDK dos anúncios para dispositivos móveis do Google e da ironSource Ads poderá 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://android-sdk.is.com/")
    }
  }
}

No arquivo gradle do app, adicione as seguintes dependências e configurações de implementação:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:ironsource:9.3.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:ironsource:9.3.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integração manual

1. Faça o download da versão mais recente do SDK da ironSource Ads para Android e adicione ao seu projeto.

2. Navegue até os artefatos do adaptador da ironSource Ads no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo .aar do adaptador da IronSource e adicione-o ao projeto.

Etapa 4: implementar configurações de privacidade no SDK da ironSource Ads

Consentimento para a UE e o 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 partir da versão 7.7.0 do SDK da ironSource, a ironSource 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 Suporte à UMP e às CMPs que oferecem consentimento adicional do Google.

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.

Na versão 6.14.0 do SDK, a ironSource Ads adicionou uma API compatível com as regulamentações da CCPA. O exemplo de código a seguir mostra como transmitir essas informações de consentimento para o SDK da ironSource Ads. Essas opções precisam ser definidas antes de você inicializar GMA Next-Gen SDK para garantir que elas sejam encaminhadas corretamente ao SDK da ironSource Ads.

Java

LevelPlay.setMetaData("do_not_sell", "true");
IronSourceMediationSnippets.java

Kotlin

LevelPlay.setMetaData("do_not_sell", "true")
IronSourceMediationSnippets.kt

Consulte a documentação da ironSource Ads sobre configurações avançadas de regulamentação para mais detalhes e informações que podem ser inseridas no método.

Etapa 5: adicionar o código necessário

Carregar o anúncio com o contexto da atividade

Transmita o contexto Activity ao carregar formatos de anúncio de banner, intersticial e premiado. Sem informações sobre a atividade, haverá falha no carregamento.

Regras do ProGuard

Se você reduzir, ofuscar e otimizar o app, a ironSource Ads vai exigir mais regras do ProGuard no seu projeto. Consulte o guia de integração do SDK do Android para a ironSource Ads para mais informações.

Etapa 6: testar a implementação

Ativar anúncios de teste

Não se esqueça de registrar seu dispositivo de teste na AdMob e ativar o modo de teste na interface da ironSource Ads.

Importante: desative o modo de teste para a AdMob e a ironSource Ads antes de lançar o app.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste da ironSource Ads, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios ironSource Ads (lances) e ironSource Ads (hierarquia).

Códigos de erro

Se o adaptador não receber um anúncio da ironSource Ads, verifique o erro subjacente na resposta do anúncio usando ResponseInfo.getAdSourceResponses() nas seguintes classes:

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

Confira os códigos e as mensagens geradas pelo adaptador ironSource Ads quando um anúncio não é carregado:

Código do erro	Motivo
101	Os parâmetros do servidor da ironSource Ads configurados na interface da AdMob estão ausentes ou são inválidos.
102	A ironSource Ads exige um contexto de atividade para inicializar o SDK.
103	A ironSource Ads só pode carregar um anúncio por ID de instância da plataforma.
105	O tamanho de anúncio de banner solicitado não é compatível com a ironSource Ads.
106	O SDK da ironSource Ads não foi inicializado.
501-1056	Erros do SDK da ironSource Ads. Consulte a documentação para mais detalhes.