Integrar anúncios da ironSource à mediação

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

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

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

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

1 A integração de lances está ativa versão Beta fechada, entre em contato com seu gerente de contas para solicitar acesso.

2 Esse formato só é com suporte na integração em hierarquia.

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Flutter 3.7.0 ou mais recente.
  • Para implantar no Android
    • Android API de nível 21 ou mais recente
  • Para implantar no iOS
    • Destino de implantação do iOS de 12.0 ou mais recente
  • Um projeto Flutter em funcionamento configurado com o Google SDK de anúncios para dispositivos móveis. Consulte Acesse Primeiros passos para ver mais detalhes.
  • Concluir a mediação Guia explicativo

Etapa 1: defina as configurações na interface de anúncios da ironSource

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

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

Android

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

iOS

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

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

Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar ironSource Mobile à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na AdMob IU.

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

Integração pelo pub.dev

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

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

Adicione a dependência a seguir com as versões mais recentes da IronSource O SDK e o adaptador na Arquivo pubspec.yaml:

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 , extrair o arquivo baixado e adicionar a pasta do plug-in extraído (e o conteúdo dela) ao seu projeto Flutter. Em seguida, consulte o plug-in pubspec.yaml adicionando a seguinte dependência:

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

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

De acordo com o Consentimento dos usuários da UE do Google política, você precisa garantir que determinadas divulgações sejam fornecidas e consentimentos de usuários no Espaço Econômico Europeu (EEE) em relação a: o uso de identificadores de dispositivos e dados pessoais. Essa política reflete requisitos da Diretiva de privacidade eletrônica da UE e da Lei Geral de Proteção de Dados (GDPR). Ao solicitar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que podem coletar, receber ou usar dados pessoais. que oferecem informações sobre o uso de cada rede. No momento, o Google não pode repassar a opção de consentimento do usuário a essas redes automaticamente.

Plug-in de mediação de anúncios para dispositivos móveis do Google para anúncios da ironSource inclui o GmaMediationIronsource().SetConsent() . O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK de anúncios da ironSource. Se você optar por chamá-lo recomendamos que você faça isso antes de solicitar anúncios por meio do 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 da ironSource Ads sobre Configurações avançadas dos regulamentos para mais detalhes.

Leis Estaduais de Privacidade dos EUA

Estados Unidos leis estaduais de privacidade exigem que os usuários tenham para desativar a "promoção" das suas "informações pessoais" (como a lei define esses termos), com a opção de desativação oferecida por um aviso "Não vender meus dados pessoais" Informações" na página "vendas" na página inicial de seu grupo. A Estados Unidos define a privacidade guia de conformidade com as leis, permite ativar processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não consegue aplicar essa configuração a cada anúncio rede na sua cadeia de mediação. Portanto, você deve identificar cada rede de anúncios na sua cadeia de mediação que possam participar da venda de e seguir as orientações de cada uma dessas redes para garantir compliance.

Plug-in de mediação de anúncios para dispositivos móveis do Google para anúncios da ironSource inclui o GmaMediationIronsource().setDoNotSell . O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK de anúncios da ironSource. Essas opções precisam ser definidas antes de você inicializar os anúncios para celular do Google SDK para garantir que eles sejam encaminhados corretamente ao SDK de anúncios da ironSource.

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

GmaMediationIronsource().setDoNotSell(true);

Consulte a documentação de anúncios da ironSource sobre configurações avançadas de regulamentação para ambos Android (em inglês) e iOS para mais detalhes e os valores que podem ser fornecidos no método.

Etapa 5: adicionar o código obrigatório

Android

Regras do Proguard

Se você reduzir, ofuscar e otimizar seu app: O IronSource Ads requer regras adicionais do ProGuard para seu projeto.

Consultoria Guia de integração do SDK do Android da IronSource Ads (link em inglês) para mais informações sobre quais regras do ProGuard são necessárias para o projeto, e adicione essas regras ao arquivo proguard-user.txt.

Ciclo de vida do aplicativo

Substitua os métodos onPause() e onResume() em cada um suas atividades para chamar os métodos de anúncios ironSource correspondentes da seguinte forma:

Java

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

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

Kotlin

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

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

iOS

Integração com a SKAdNetwork

Siga a documentação da ironSource Ads (link em inglês) para adicionar os identificadores da SKAdNetwork às suas arquivo Info.plist do projeto.

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste em AdMob e ative o modo de teste na IronSource interface.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do IronSource , ative os testes de uma única origem no Ad Inspector usando as ironSource Ads (Waterfall) origens de anúncios.

Códigos de erro

Se o adaptador não receber um anúncio da ironSource Ads, os editores podem verificar o erro subjacente da resposta do anúncio usando ResponseInfo no seguintes classes:

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

Aqui estão os códigos e as mensagens de acompanhamento geradas pelos anúncios da ironSource quando um anúncio não for carregado:

Android

Código do erro Motivo
101 Os parâmetros do servidor de anúncios da ironSource configurados na AdMob interface estão ausentes/inválidos.
102 Os anúncios da ironSource precisam de um contexto de atividade para inicializar o SDK.
103 Os anúncios da ironSource só podem carregar um anúncio por ID da instância da ironSource.
105 O tamanho do 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 de anúncios da ironSource. 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 AdMob interface estão ausentes/inválidos.
102 O adaptador de anúncios ironSource não suporta o formato de anúncio solicitado.
103 Um anúncio da ironSource já está carregado para esta configuração de rede.
104 O tamanho do anúncio de banner solicitado não é compatível com os anúncios da ironSource.
508-1037 Erros do SDK de anúncios da ironSource. Consulte a documentação. para mais detalhes.

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

1.0.0

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