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 usando a mediação, 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:

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

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, crie um arquivo app-ads.txt para o Ad Manager.

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 do Ad Manager

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

Faça login na sua conta do Ad Manager.

Acesse Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento.

Insira um Nome exclusivo para seu grupo de rendimento, defina o Status como Ativo, selecione o Formato do anúncio e defina o Tipo de inventário como App para dispositivos móveis. Na seção Segmentação > Inventário, selecione o bloco de anúncios em Inventário e Aplicativo para dispositivos móveis a que você quer adicionar a mediação.

Em seguida, clique no botão Adicionar parceiro de rendimento.

Se você já tiver um parceiro de rendimento para a ironSource Ads, selecione-o. Caso contrário, selecione Criar um novo parceiro de rendimento.

Selecione ironSource Ads como a rede de publicidade, insira um Nome exclusivo e ative a Mediação.

Ative a Coleta de dados automática e insira a chave secreta e o token de atualização obtidos na seção anterior.

Depois que o Parceiro de rendimento for selecionado, escolha Mediação de SDK para dispositivos móveis como o Tipo de integração, Android como a Plataforma e Ativo como o Status. Insira a chave do app e o ID da instância obtidos na seção anterior. Em seguida, insira um valor de CPM padrão.

Clique em Salvar na parte de baixo da página quando terminar.

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 a ironSource Mobile à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface do Ad Manager.

Etapa 3: importar o SDK e o adaptador da ironSource Ads

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.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")
}

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.

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.

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 no Ad Manager e ativar o modo de teste na 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 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: