Se usó la API de Cloud Translation para traducir esta página.

Cómo integrar ironSource con la mediación

En esta guía, se muestra cómo usar el SDK de anuncios de Google para dispositivos móviles para cargar y mostrar anuncios de ironSource Ads con mediación, cascada cubriente integraciones. Aquí se explica cómo agregar anuncios de ironSource a la mediación de una unidad de anuncios. de la fuente de anuncios, y cómo configurar la optimización de la fuente del anuncio, y cómo integrar el ironSource Ads SDK y el adaptador en su Android .

Integraciones y formatos de anuncios admitidos

El adaptador de mediación Ad Manager para ironSource Ads tiene las siguientes capacidades:

Integración
Ofertas	¹
Cascada
Formatos
Banner	²
Intersticial
Recompensado
Intersticial recompensado	²
Nativo

Requisitos

Nivel de API 21 o versiones posteriores de Android

SDK de anuncios de Google para dispositivos móviles más reciente
Cómo completar la mediación Guía de introducción

Paso 1: Establece la configuración en la IU de anuncios de ironSource

Regístrate y accede a tu cuenta de anuncios de ironSource Ads.

Para agregar tu aplicación al panel de anuncios de ironSource, haz clic en el botón Nueva app.

Ingresar detalles de la app

Selecciona App en vivo, ingresa la Google Play URL de tu app y haz clic en Importar información de la app.

Si tu app no está disponible, selecciona App Not Live in the Application Store y proporciona un Temporary Name para la app. Selecciona tu plataforma.

Completa el resto del formulario y haz clic en Agregar aplicación.

Toma nota de la clave de la app nueva, que se muestra después de agregar la app. Necesitarás este valor para configurar el Ad Manager ID de tu unidad de anuncios. Selecciona los formatos de anuncios que admite tu app. Luego, haz clic en Continuar.

Crea la instancia.

A continuación, configura una instancia de red para la app que agregaste.

Navega a Anuncios > Configuración > Instancias. Selecciona la app y haz clic en Crear instancia.

Ingresa los detalles necesarios y haz clic en Guardar y cerrar.

Una vez creada la instancia, el ID de instancia aparece en el campo ID de instancia.

Ubica tu clave de API de Reporting

Además de la clave de la app y el ID de instancia, también necesitarás la clave secreta y el token de actualización de tus anuncios ironSource para configurar tuAd Manager ID de unidad de anuncios.

Navega a Mi cuenta en el panel del publicador de anuncios de ironSource y, luego, haz clic en la pestaña API. Toma nota de tu Clave secreta y el Token de actualización.

Activar el modo de prueba

Sigue las instrucciones de la guía Pruebas de integración de ironSource Ads para habilitar los anuncios de prueba de ironSource Ads.

Paso 2: Configura la demanda de ironSource Ads en la Ad Manager IU

Cómo configurar la mediación para tu unidad de anuncios

Accede a tu cuenta de Ad Manager.

Navega a Publicación > Grupos de rendimiento y haz clic en el botón Nuevo grupo de rendimiento.

Ingresa un Nombre único para tu grupo de rendimiento, establece el Estado en Activo, selecciona el Formato del anuncio y establece el Tipo de inventario en Aplicación para dispositivos móviles. En la sección Segmentación > Inventario, selecciona la unidad de anuncios en Inventario y Aplicación para dispositivos móviles a la que deseas agregar la mediación.

Luego, haz clic en el botón Agregar socio de rendimiento.

Si ya tienes un socio de rendimiento para IronSource , puedes seleccionarlo. De lo contrario, selecciona Crear un socio de rendimiento nuevo.

Selecciona IronSource como la Red de publicidad, ingresa un Nombre único y habilita la Mediación.

Activa Recopilación de datos automática y, luego, ingresa el Secret Key and Refresh Token obtenido en la sección anterior.

Una vez que hayas seleccionado el Socio de rendimiento, elige Mediación del SDK para dispositivos móviles como el Tipo de integración, Android como la Plataforma y Activo como el Estado. Ingresa elApp Key and Instance ID obtenido en la sección anterior. Luego, ingresa un valor de CPM predeterminado.

Haz clic en Guardar en la parte inferior de la página cuando termines.

Agregar ironSource Mobile a la lista de socios publicitarios del GDPR y las reglamentaciones estatales de EE.UU.

Sigue los pasos que se indican en Configuración del GDPR y Configuración de las reglamentaciones estatales de EE.UU. para agregar ironSource Mobile a la lista de socios publicitarios de las reglamentaciones estatales de EE.UU. y el GDPR en la Ad Manager IU.

Paso 3: Importa el SDK de anuncios de ironSource y el adaptador

Integración de Android Studio (recomendada)

En el archivo settings.gradle.kts de nivel de proyecto, agrega lo siguiente: repositorios:

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

Luego, en el archivo build.gradle.kts a nivel de la app, agrega lo siguiente: las dependencias y configuraciones de la implementación. Usa las versiones más recientes del ironSource Ads SDK y el adaptador:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:ironsource:8.2.1.0")
}

Integración manual

Descarga la versión más reciente del SDK de anuncios ironSource de Android y agregarla a tu proyecto.
Ve a la sección artefactos del adaptador ironSource Ads en el repositorio Maven de Google. Selecciona la versión más reciente, descarga al archivo .aar del adaptador IronSource y agrégalo a tu proyecto.

Paso 4: Implementa la configuración de privacidad en el SDK de anuncios de ironSource

Consentimiento para la UE y GDPR

Según el Consentimiento de Usuarios de la UE de Google política, debe asegurarse de que se proporcionen ciertas divulgaciones los consentimientos obtenidos de los usuarios del Espacio Económico Europeo (EEE) en relación con el uso de identificadores de dispositivos y datos personales. Esta política refleja el requisitos de la Directiva de Privacidad Electrónica y de la Protección General de Datos Reglamento General de Protección de Datos (RGPD). Cuando solicite el consentimiento, debe identificar cada red de publicidad de tu cadena de mediación que recopilen, reciban o usen datos personales y proporcionar información sobre el uso de cada red. Por el momento, Google no puede pasar automáticamente la elección de consentimiento del usuario a esas redes.

En la versión 6.7.9 del SDK, ironSource Ads agregó una API de consentimiento. El siguiente ejemplo código muestra cómo pasar esta información de consentimiento al SDK de anuncios de ironSource. Si eliges llamar a este método, te recomendamos que lo hagas antes de cómo solicitar anuncios a través del SDK de anuncios de Google para dispositivos móviles.

Java

import com.ironsource.mediationsdk.IronSource;
// ...

IronSource.setConsent(true);

Kotlin

import com.ironsource.mediationsdk.IronSource
// ...

IronSource.setConsent(true)

Consulta la documentación de ironSource Ads sobre Configuración avanzada de la reglamentación para obtener más información y conocer los valores que se pueden proporcionar en el método.

Leyes de privacidad estatales de EE.UU.

EE.UU. leyes de privacidad estatales deben brindar a los usuarios los permisos para inhabilitar la "oferta" de su "información personal" (como lo define la ley condiciones), con la opción de inhabilitación ofrecida por medio de un mensaje destacado "No vender Información" el vínculo en la página la página de inicio del grupo. El EE.UU. privacidad de estados en la guía de cumplimiento de leyes ofrece la posibilidad de habilitar procesamiento de datos restringido para la publicación de anuncios de Google, pero Google no puede aplicar esta configuración a cada anuncio en tu cadena de mediación. Por lo tanto, debes identificar cada red de publicidad de su cadena de mediación que puedan participar en la venta de información y seguir las indicaciones de cada una de esas redes para garantizar y cumplimiento.

En la versión 6.14.0 del SDK, ironSource Ads agregó una API para cumplir con las reglamentaciones de la CCPA. El siguiente código de muestra indica cómo pasar esta información de consentimiento al ironSource Ads de Google. Debes establecer estas opciones antes de inicializar SDK de anuncios de Google para dispositivos móviles para garantizar que se reenvíen correctamente al SDK de anuncios de ironSource.

Java

import com.ironsource.mediationsdk.IronSource;
// ...

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

Kotlin

import com.ironsource.mediationsdk.IronSource
// ...

IronSource.setMetaData("do_not_sell", "true")

Consultar la documentación de ironSource Ads sobre la Reglamentación avanzada Configuración para obtener más información y conocer los valores que se pueden proporcionar en el método.

Paso 5: Agrega el código requerido

Ciclo de vida de la aplicación

Anula los métodos onPause() y onResume() en cada una de tus actividades para llama a los métodos de ironSource Ads correspondientes de la siguiente manera:

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

Reglas de ProGuard

Si reducir, ofuscar y optimizar tu app , ironSource Ads requiere reglas adicionales de ProGuard para tu proyecto. Consulta Guía de integración del SDK de Android para ironSource Ads para obtener más información.

Paso 6: Prueba tu implementación

Habilitar anuncios de prueba

Asegúrate de registrar tu dispositivo de prueba en Ad Manager y habilitar el modo de prueba en la IronSource IU.

Cómo verificar los anuncios de prueba

Para verificar que recibes anuncios de prueba de IronSource , habilita las pruebas de fuentes de anuncios individuales en el inspector de anuncios mediante la ironSource Ads(Waterfall) fuente de anuncios.

Códigos de error

Si el adaptador no recibe un anuncio de ironSource Ads, puedes comprobar el subyacente de la respuesta del anuncio mediante ResponseInfo.getAdapterResponses() en las siguientes clases:

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

Estos son los códigos y los mensajes adjuntos que arroja ironSource Ads. cuando un anuncio no se carga:

Código de error	Motivo
101	parámetros del servidor de anuncios ironSource Ads configurados en la Ad Manager Falta la IU o no es válida.
102	ironSource Ads requiere un contexto de Activity para inicializar su SDK.
103	ironSource Ads solo puede cargar 1 anuncio por cada ID de instancia de ironSource Ads.
105	El tamaño de anuncio de banner solicitado no es compatible con ironSource Ads.
106	No se inicializó el SDK de anuncios de ironSource.
501-1056	Errores del SDK de anuncios ironSource Consulta la documentación para obtener más información.
101	Faltan los parámetros del servidor de ironSource Ads configurados en la IU Ad Manager o no son válidos.
102	ironSource Ads Adapter no admite el formato de anuncio que se solicita.
103	Ya se cargó un anuncio de ironSource para esta configuración de red.
104	El tamaño de anuncio de banner solicitado no es compatible con ironSource Ads.
508-1037	Errores del SDK de anuncios ironSource Consulta la documentación para obtener más información.