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 explica 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 AdMob para ironSource Ads tem os seguintes recursos:

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

Requisitos

• API Android nível da API 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)

• Mais recente 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 Ads > Apps e clique em Add app.

Preencha o formulário e clique em Add app.

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

Criar uma instância

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

Navegue para Ads > Setup > Instances. Selecione o app e clique em Create instance.

Localizar sua chave da API Reporting

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.

Faça login na sua conta do AdMob. Navegue até a guia Mediação. Caso queira modificar um grupo de mediação, clique no nome dele para editar e pule para Adicionar a ironSource Ads 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 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 ID da instância obtidos na seção anterior. Em seguida, clique em Concluído.

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.



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.

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

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:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    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")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    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 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.

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 e assim garantir que elas sejam encaminhadas corretamente ao SDK da ironSource Ads.

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

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 de anúncios.

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 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 testena interface da ironSource Ads.

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 ironSource Ads (lances) e ironSource Ads (hierarquia) origens de anúncios.

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: