Integrar anúncios da ironSource à mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da ironSource Ads usando a mediação, incluindo integrações em cascata. Ele aborda como adicionar anúncios da ironSource à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador de anúncios da ironSource a um app Unity.

Integrações e formatos de anúncio aceitos

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

Integração
Lances  1
Cascata
Formatos
Banner
Intersticial
Premiado
Intersticial premiado  2
1 A integração de lances está em beta aberto.

2: esse formato é compatível apenas com a integração em cascata.

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Unity 4 ou versões mais recentes
  • [Para lances]: para integrar todos os formatos de anúncio compatíveis em lances, use o plug-in de mediação de anúncios para dispositivos móveis do Google para IronSource 3.5.1 ou mais recente (versão mais recente recomendada).
  • Para fazer a implantação no Android,
    • API do Android de nível 23 ou mais recente
  • Para fazer a implantação no iOS:
    • Destino de implantação do iOS 12.0 ou mais recente
  • Um projeto do Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Conclua o Guia de primeiros passos da mediação.

Etapa 1: definir configurações na interface do usuário do 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 chave do app, selecione os formatos de anúncio compatíveis com seu app e clique em Continuar.

Android

iOS

Criar uma instância

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

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

Android

iOS

Anote o ID da instância.

Android

iOS

Cascata

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

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

Clique na guia API na página "Minha conta" e anote sua chave secreta e seu token de atualização.

Atualizar o app-ads.txt

O app-ads.txt de vendedores autorizados para apps é 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 de anúncios da ironSource na interface da AdMob

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

Android

Para instruções, consulte a etapa 2 no guia para Android.

iOS

Para instruções, consulte a etapa 2 no guia para iOS.

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 da AdMob.

Etapa 3: importar o SDK e o adaptador de anúncios da ironSource

OpenUPM-CLI

Se você tiver o OpenUPM-CLI instalado, execute o seguinte comando no diretório raiz do projeto para instalar o plug-in de mediação de anúncios da ironSource dos Google Mobile Ads para Unity:

openupm add com.google.ads.mobile.mediation.ironsource

OpenUPM

No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Configurações do Unity Package Manager.

Na guia Registros com escopo, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopos: com.google

Detalhes do OpenUPM

Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.

Registros do Unity

Selecione o pacote Mediação do Google Mobile Ads IronSource e clique em Instalar.

Instalar pelo OpenUPM

Pacote do Unity

Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para anúncios da ironSource no link de download do Registro de alterações e extraia o GoogleMobileAdsIronSourceMediation.unitypackage do arquivo ZIP.

No editor do projeto do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsIronSourceMediation.unitypackage que você baixou. Verifique se todos os arquivos estão selecionados e clique em Importar.

Importar do Unity

Em seguida, selecione Recursos > Gerenciador de dependências externas > Resolvedor do Android > Resolução forçada. A biblioteca do External Dependency Manager vai realizar a resolução de dependências do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do seu app Unity.

Forçar resolução

Etapa 4: implementar configurações de privacidade no SDK de anúncios da ironSource

De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que determinadas divulgações sejam feitas e que os consentimentos sejam obtidos dos usuários no Espaço Econômico Europeu (EEE) em relação ao uso de identificadores de dispositivo e dados pessoais. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Ao buscar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que possa coletar, receber ou usar dados pessoais e fornecer informações sobre o uso de cada rede. No momento, o Google não consegue transmitir automaticamente a opção de consentimento do usuário para essas redes.

O plug-in de mediação dos anúncios para dispositivos móveis do Google para anúncios da ironSource versão 1.0.0 inclui o método IronSource.SetConsent(). O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK ironSource Ads. Se você optar por chamar esse método, faça isso antes de solicitar anúncios pelo SDK dos anúncios para dispositivos móveis do Google.

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetConsent(true);

Consulte a documentação do ironSource Ads sobre Configurações avançadas de regulamentação para mais detalhes.

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 legal desses termos). Essa opção é disponibilizada por um link em destaque com a mensagem "Não vender minhas informações pessoais" na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados 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 anúncios 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 delas para garantir a conformidade.

O plug-in de mediação dos anúncios para dispositivos móveis do Google para anúncios da ironSource versão 2.2.4 inclui o método IronSource.SetMetaData(). O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK ironSource Ads. Essas opções precisam ser definidas antes de inicializar o SDK dos anúncios para dispositivos móveis do Google para garantir que sejam encaminhadas corretamente ao SDK de anúncios da ironSource.

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetMetaData("do_not_sell", "true");

Consulte a documentação da ironSource Ads sobre as configurações avançadas de regulamentação para Android e iOS para mais detalhes e os valores que podem ser fornecidos no método.

Etapa 5: adicionar o código necessário

Android

Regras do ProGuard

Se você reduzir, ofuscar e otimizar o app, o IronSource Ads vai exigir mais regras do ProGuard para seu projeto.

Ao criar o projeto, selecione Android como a Plataforma. Em seguida, abra Configurações do player e marque Arquivo Proguard do usuário na guia Configurações de publicação. O Unity vai mostrar onde um arquivo proguard-user.txt personalizado foi criado para você modificar.

Arquivo Proguard do usuário do Unity

Consulte o guia de integração do SDK do Android do IronSource Ads (link em inglês) para saber mais sobre as regras do ProGuard necessárias para seu projeto e adicione essas regras ao arquivo proguard-user.txt.

iOS

Integração da SKAdNetwork

Siga a documentação da ironSource Ads para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.

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 dos anúncios da ironSource.

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 do ironSource Ads, os publishers poderão verificar o erro subjacente na resposta do anúncio usando ResponseInfo nas seguintes classes:

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

Android

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

iOS

Código do erro Motivo
101 Os parâmetros do servidor de anúncios da ironSource configurados na interface da AdMob estão ausentes ou são inválidos.
102 O adaptador de anúncios da ironSource não é compatível com o formato de anúncio solicitado.
103 Um anúncio da ironSource já está carregado para essa configuração de rede.
104 O tamanho de anúncio de banner solicitado não é compatível com os anúncios da ironSource.
508-1037 Erros do SDK do ironSource Ads. Consulte a documentação para mais detalhes.

Registro de alterações do plug-in de mediação do Unity da ironSource

Versão 3.10.0 (em andamento)

Versão 3.9.1

Versão 3.9.0

Versão 3.8.1

Versão 3.8.0

Versão 3.7.0

Versão 3.6.1

Versão 3.6.0

Versão 3.5.2

Versão 3.5.1

Versão 3.5.0

Versão 3.4.0

Versão 3.3.1

Versão 3.3.0

Versão 3.2.1

Versão 3.2.0

Versão 3.1.1

Versão 3.1.0

Versão 3.0.1

Versão 3.0.0

Versão 2.6.1

Versão 2.6.0

Versão 2.5.0

Versão 2.4.0

Versão 2.3.1

Versão 2.3.0

Versão 2.2.7

Versão 2.2.6

Versão 2.2.5

Versão 2.2.4

Versão 2.2.3

Versão 2.2.2

Versão 2.2.1

Versão 2.2.0

Versão 2.1.5

Versão 2.1.4

Versão 2.1.3

Versão 2.1.2

Versão 2.1.1

Versão 2.1.0

Versão 2.0.3

Versão 2.0.2

Versão 2.0.1

Versão 2.0.0

Versão 1.10.0

Versão 1.9.1

Versão 1.9.0

Versão 1.8.2

Versão 1.8.1

Versão 1.8.0

Versão 1.7.0

Versão 1.6.0

Versão 1.5.0

Versão 1.4.0

Versão 1.3.2

Versão 1.3.1

  • Compatível com a versão 6.10.0.0 do adaptador Android do IronSource.
  • Compatibilidade com a versão 6.8.6.0 do adaptador iOS da IronSource.

Versão 1.3.0

  • Compatível com a versão 6.10.0.0 do adaptador Android do IronSource.
  • Compatível com a versão 6.8.4.1.0 do adaptador iOS do IronSource.

Versão 1.2.0

  • Compatibilidade com a versão 6.9.0.1 do adaptador Android do IronSource.
  • Compatível com a versão 6.8.4.1.0 do adaptador iOS do IronSource.

Versão 1.1.2

  • Compatível com a versão 6.8.4.1 do adaptador Android da IronSource.
  • Compatível com a versão 6.8.4.1 do adaptador iOS da IronSource.

Versão 1.1.1

  • Compatível com a versão 6.8.4.1 do adaptador Android da IronSource.
  • Suporte à versão 6.8.3.0 do adaptador iOS do IronSource.

Versão 1.1.0

  • Atualizamos o plug-in para oferecer suporte à nova API Rewarded Beta aberta.
  • Compatível com a versão 6.8.1.2 do adaptador Android da IronSource.
  • Compatível com a versão 6.8.0.1 do adaptador iOS do IronSource.

Versão 1.0.4

  • Compatível com a versão 6.7.11.0 do adaptador Android do IronSource.
  • Compatível com a versão 6.7.11.0 do adaptador iOS do IronSource.

Versão 1.0.3

  • Compatível com a versão 6.7.10.0 do adaptador Android do IronSource.
  • Suporte à versão 6.7.10.0 do adaptador iOS da IronSource.

Versão 1.0.2

  • Compatibilidade com a versão 6.7.9.1.1 do adaptador do Android da IronSource.
  • Suporte à versão 6.7.10.0 do adaptador iOS da IronSource.
  • Foi corrigido um conflito com o plug-in de mediação do Unity da Chartboost.

Versão 1.0.1

  • Compatível com a versão 6.7.9.0 do adaptador Android do IronSource.
  • Compatível com a versão 6.7.9.2.0 do adaptador iOS do IronSource.

Versão 1.0.0

  • Primeira versão!
  • Compatível com a versão 6.7.9.0 do adaptador Android do IronSource.
  • Compatível com a versão 6.7.9.1.0 do adaptador do iOS do IronSource.