Integrar a ironSource Ads com a Mediação da AdMob

Este guia mostra como usar o Google Mobile Ads SDK for React Native para carregar e exibir anúncios da ironSource Ads com a mediação, abrangendo integrações em hierarquia. Ele explica como adicionar a ironSource Ads à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da ironSource Ads a um app React Native.

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
Cascata
Formatos
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado  1
Nativo

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

Pré-requisitos

Antes de continuar, verifique o seguinte:

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.

Android

iOS

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 Criar instância.

Lances

Preencha o formulário e selecione Bidding em Pricing. Clique em Save and close.

Android

iOS

Anote o ID da instância.

Android

iOS

Cascata

Preencha o formulário e clique em Save and close.

Anote o ID da instância.

Localizar sua chave de API Reporting

Lances

Essa etapa não é necessária para integrações de lances.

Cascata

Clique na guia API na página "My Account" e anote a Secret Key e o token de atualização.

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 de anúncios da ironSource na interface da AdMob

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

Android

Para ver as 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 de anúncio e o adaptador da ironSource

No diretório raiz do projeto, instale o adaptador de mediação Google Mobile Ads SDK for React Native para a ironSource Ads. Preencha os campos:

  1. Copie o arquivo tar do adaptador Google Mobile Ads SDK for React Native do diretório gma-sdk-react-native/adapters/ironsource/ para o diretório local_packages/ do projeto. Se você não tiver a pasta adapters, consulte Pré-requisitos.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/ironsource/gma-mediation-ironsource-0.1.0.tgz local_packages/

    Substitua EXTRACT_DIR pelo caminho para o diretório em que você extraiu o arquivo.

  2. Instale o pacote do adaptador usando o gerenciador de pacotes de sua preferência:

    npm

    npm install ./local_packages/gma-mediation-ironsource-0.1.0.tgz

    novelo

    yarn add ./local_packages/gma-mediation-ironsource-0.1.0.tgz

  3. Se você estiver criando para Android, adicione o seguinte repositório ao arquivo build.gradle no diretório android do seu projeto:

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

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

Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer certas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça e obter o consentimento deles para usar cookies ou outra forma de armazenamento local, quando exigido por lei, e para coletar, compartilhar e usar dados pessoais para 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.

A versão 0.1.0 e mais recentes do adaptador do React Native da ironSource Ads aceitam a transmissão de indicadores de consentimento do GDPR do SDK da UMP e de plataformas de gestão de consentimento que se integram à especificação de consentimento adicional do Google para o SDK de anúncio da ironSource Ads. Para mais informações, consulte Compliance da ironSource com o GDPR.

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.

O plug-in de mediação dos anúncios para dispositivos móveis do Google para a ironSource Ads inclui o método GmaMediationIronsource().setDoNotSell. O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK de anúncio da ironSource. Essas opções precisam ser definidas antes de você inicializar Google Mobile Ads SDK for React Native e assim garantir que elas sejam encaminhadas corretamente ao SDK de anúncio da ironSource.

import { IronSourceMediation } from '@google/gma-mediation-ironsource';
// ...
IronSourceMediation.setDoNotSell(true);

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

Etapa 5: adicionar o código necessário

Android

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 sobre quais regras do ProGuard são necessárias para seu projeto e adicione-as ao arquivo proguard-user.txt.

iOS

Integração da SKAdNetwork

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 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, 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 geradas pelo adaptador da ironSource Ads quando um anúncio não é carregado:

Android

Código do erro Motivo
101 Os parâmetros do servidor da ironSource Ads configurados na interface da AdMob estão ausentes ou são inválidos.
102 A ironSource Ads exige um contexto de atividade para inicializar o SDK.
103 A ironSource Ads só pode carregar 1 anúncio por ID de instância da plataforma.
105 O tamanho de anúncio de banner solicitado não é compatível com a ironSource Ads.
106 O SDK de anúncios da ironSource não foi inicializado.
107 Uma solicitação de exibição de anúncio foi feita antes que o anúncio fosse carregado.
108 O SDK de anúncio da ironSource retornou indicadores de lances nulos ou vazios.
501-1056 Erros do SDK de anúncio da ironSource. Acesse a documentação para mais detalhes.

iOS

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

Versão 0.1.0

  • Versão inicial.