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 mostrar anúncios da ironSource usando mediação, cobrindo integrações em hierarquia. Ele aborda como adicionar anúncios do ironSource à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do ironSource Ads a um app do Flutter.

Integrações e formatos de anúncio compatíveis

O adaptador de mediação da AdMob para anúncios do ironSource tem os seguintes recursos:

² Esse formato só é compatível com a integração em hierarquia.

Requisitos

• SDK dos anúncios para dispositivos móveis do Google
• Flutter 3.7.0 ou mais recente
• Para implantar no Android
  • API do Android de nível 21 ou mais recente
• Para implantar no iOS
  • Destino de implantação do iOS 12.0 ou mais recente
• Um projeto do Flutter configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
• Conclua o Guia para iniciantes da mediação.

Etapa 1: configurar as configurações na interface do ironSource Ads

Inscreva-se e faça login na sua conta do 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 o app e clique em Continuar.

Criar uma instância

Em seguida, configure uma instância para o app adicionado.

Localizar sua chave da API Reporting

Ativar o modo de teste

Siga as instruções no guia Testes de integração do ironSource Ads para ativar anúncios de teste.

Etapa 2: configurar a demanda de anúncios do ironSource na interface da AdMob

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

Adicionar o ironSource Mobile à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA

Siga as etapas em Configurações de regulamentações europeias e Configurações de 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 Ads

Integração pelo pub.dev

(Somente Android) Adicione os repositórios abaixo ao arquivo build.gradle no diretório android do projeto:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://android-sdk.is.com/")
      }
  }

Adicione a dependência abaixo com as versões mais recentes do SDK e do adaptador do ironSource Ads no arquivo pubspec.yaml do pacote:

dependencies:
  gma_mediation_ironsource: ^1.0.0

Integração manual

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 ironSource Ads, extraia o arquivo baixado e adicione a pasta do plug-in extraído (e o conteúdo dela) ao seu projeto do Flutter. Em seguida, faça referência ao plug-in no arquivo pubspec.yaml adicionando a seguinte dependência:

dependencies:
  gma_mediation_ironsource:
    path: path/to/local/package

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

Consentimento da UE e GDPR

De acordo com a Política de consentimento para usuários da União Europeia do Google, é necessário garantir que algumas informações sejam fornecidas e que o consentimento seja obtido dos usuários no Espaço Econômico Europeu (EEE) sobre o 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 cadeia de mediação que pode coletar, receber ou usar dados pessoais e fornecer informações sobre o uso de cada rede. No momento, o Google não pode transmitir a escolha de consentimento do usuário para essas redes automaticamente.

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

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setConsent(true);

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

Leis Estaduais de Privacidade dos EUA

Leis estaduais de privacidade dos EUA exigem que os usuários tenham o direito de recusar a "venda" das próprias "informações pessoais" (conforme a lei define esses termos), com a opção de recusa oferecida por um link "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados dos EUA oferece a capacidade de ativar o processamento de dados restrito para veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de anúncios na sua cadeia de mediação. Portanto, é necessário identificar cada rede de publicidade na sua cadeia de mediação que possa participar da venda de informações pessoais e seguir as orientações de cada uma dessas redes para garantir a conformidade.

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

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setDoNotSell(true);

Consulte a documentação do ironSource Ads sobre as configurações avançadas de regulaçã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

@Override
public void onResume() {
    super.onResume();
    IronSource.onResume(this);
}

@Override
public void onPause() {
    super.onPause();
    IronSource.onPause(this);
}

public override fun onResume() {
    super.onResume()
    IronSource.onResume(this)
}

public override fun onPause() {
    super.onPause()
    IronSource.onPause(this)
}

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste na AdMob e ative o modo de teste na interface de anúncios da ironSource.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste de 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 editores poderão verificar o erro subjacente da resposta do anúncio usando ResponseInfo nas seguintes classes:

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

Confira os códigos e as mensagens que acompanham o adaptador de anúncios do ironSource quando um anúncio não é carregado:

Registro de alterações do adaptador de mediação do Flutter do ironSource

Próxima versão

• O plug-in do iOS agora é um framework estático.
• Compatibilidade verificada com a versão 8.6.1.0 do adaptador Android do ironSource
• Compatibilidade verificada com o adaptador iOS da ironSource versão 8.6.0.0.0
• Criado e testado com a versão 5.3.1 do plug-in de anúncios para dispositivos móveis do Google para Flutter.

1.0.0

• Versão inicial.
• Compatibilidade verificada com a versão 8.0.0.0 do adaptador Android do ironSource
• Compatibilidade verificada com o adaptador iOS da ironSource versão 8.0.0.0.0
• Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.