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

Integra Pangle con mediación

En esta guía, se muestra cómo usar el SDK de Google Mobile Ads para cargar y mostrar anuncios de Pangle con la mediación de AdMob, que abarca las integraciones de cascada y ofertas. En ella, se explica cómo agregar Pangle a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK y el adaptador de Pangle en una app para Android.

Integraciones y formatos de anuncios admitidos

El adaptador de mediación para Pangle tiene las siguientes funciones:

Integración
Ofertas
Cascada
Formatos
Apertura de la aplicación	¹
Banner
Intersticial
Recompensado
Anuncio intersticial recompensado
Nativo

¹ La integración de ofertas para este formato está en versión beta abierta.

Requisitos

Android con nivel de API 21 o superior
[Para ofertas]: Para integrar todos los formatos de anuncios admitidos en las ofertas, usa el adaptador de Pangle 5.5.0.4.0 o una versión posterior (se recomienda la versión más reciente).

SDK de anuncios de Google para dispositivos móviles más reciente
Completa la guía de introducción de mediación.

Paso 1: Establece la configuración en la IU de Pangle

Regístrate o accede a tu cuenta de Pangle.

Agrega una nueva aplicación

Navega a la pestaña Aplicaciones y haz clic en el botón Agregar aplicación.

Selecciona el sistema operativo para el que deseas crear una aplicación y completa el resto del formulario. A continuación, haz clic en Submit (Enviar).

Toma nota del ID de aplicación de tu aplicación.

Crea una posición de anuncios

Una vez que hayas creado la aplicación, haz clic en el botón Agregar para crear tu posición de anuncios.

Ofertas

Selecciona el Formato del anuncio y el Nombre de la posición del anuncio, y elige Ofertas en la aplicación como el Tipo de precio. Completa el resto del formulario y haz clic en Enviar.

Una vez que crees la posición de tu anuncio, toma nota del ID de la posición de anuncios.

Cascada

Selecciona tu Formato del anuncio y Nombre de la posición del anuncio, y CPM global como el Tipo de precio. Completa el resto del formulario y haz clic en Enviar.

Una vez que crees la posición de tu anuncio, toma nota del ID de la posición de anuncios.

Cómo encontrar la clave de API de Pangle Reporting

Ofertas

Este paso no es obligatorio para las integraciones de ofertas.

Cascada

Anota el ID de usuario que aparece en la esquina inferior izquierda de la página.

Haz clic en Integraciones > SDK y API > API de informes de Pangle 2.0. Toma nota del ID de rol y la Clave de seguridad.

Cómo activar el modo de prueba

Sigue las instrucciones de la guía Cómo agregar un anuncio de prueba de Pangle para habilitar los anuncios de prueba de Pangle.

Paso 2: Configura la demanda de Pangle en la IU de AdMob

Configura la configuración de mediación para tu unidad de anuncios

Debes agregar Pangle a la configuración de mediación de tu unidad de anuncios.

Primero, accede a tu cuenta de AdMob. Luego, navega a la pestaña Mediation. Si tienes un grupo de mediación existente que deseas modificar, haz clic en su nombre para editarlo y avanza al apartado Cómo agregar Pangle como fuente de anuncios.

Para crear un grupo de mediación nuevo, selecciona Crear grupo de mediación.

Ingresa el formato y la plataforma de tu anuncio y, luego, haz clic en Continuar.

Asigna un nombre a tu grupo de mediación y selecciona las ubicaciones para segmentar. A continuación, establece el estado del grupo de mediación en Habilitado y, luego, haz clic en Agregar unidades de anuncios.

Asocia este grupo de mediación con una o más de tus unidades de anuncios existentes de AdMob. Luego, haz clic en Listo.

Ahora deberías ver la tarjeta de unidades de anuncios propagada con las unidades de anuncios que seleccionaste:

Agrega Pangle como fuente del anuncio

Ofertas

En la tarjeta Ofertas de la sección Fuentes de anuncios, selecciona Agregar fuente de anuncios. Luego, selecciona Pangle.
Haz clic en Cómo firmar un acuerdo de asociación y configura una asociación de ofertas con Pangle.

Haz clic en Reconocer y aceptar y, luego, en Continuar.

Si ya tienes una asignación para Pangle, puedes seleccionarla. De lo contrario, haz clic en Agregar asignación.

A continuación, ingresa el ID de aplicación y el ID de posición de anuncios que obtuviste en la sección anterior. Luego, haz clic en Listo.

Cascada

En la tarjeta Cascada de la sección Fuentes de anuncios, selecciona Agregar fuente de anuncios. Luego, selecciona Pangle.

Selecciona Pangle. Luego, ingresa un valor de eCPM para Pangle y haz clic en Continuar.

Si ya tienes una asignación para Pangle, puedes seleccionarla. De lo contrario, haz clic en Agregar asignación.

A continuación, ingresa el ID de aplicación y el ID de posición del anuncio que obtuviste en la sección anterior. Luego, haz clic en Listo.

Paso 3: Importa el SDK y el adaptador de Pangle

Integración de Android Studio (recomendado)

En el archivo settings.gradle.kts a nivel del proyecto, agrega los siguientes repositorios:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://artifact.bytedance.com/repository/pangle/")
    }
  }
}

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:pangle:6.3.0.4.0")
}

Integración manual

Descarga la versión más reciente del SDK de Pangle para Android, extrae el open_ad_sdk.aar de la carpeta del archivo descargado y agrégalo a tu proyecto.
Navega a los artefactos del adaptador de Pangle en el repositorio de Maven de Google. Selecciona la versión más reciente, descarga el archivo .aar del adaptador de Pangle y agrégalo a tu proyecto.

Paso 4: Agrega el código obligatorio

Ofuscación de ProGuard

Si usas ProGuard para ofuscar el código de Android, sigue las instrucciones de la documentación de Pangle para asegurarte de que el código del SDK de Pangle no esté ofuscado.

Paso 5: Prueba tu implementación

Habilita los anuncios de prueba

Asegúrate de registrar tu dispositivo de prueba para AdMob y habilitar el modo de prueba en la IU de Pangle.

Verifica los anuncios de prueba

Para verificar que recibes anuncios de prueba de Pangle, habilita la prueba de fuente del anuncio individual en el inspector de anuncios con las fuentes de anuncios Pangle (licitación) y Pangle (cascada).

Pasos opcionales

Anuncios nativos

Renderización de anuncios

El adaptador de Pangle muestra sus anuncios nativos como objetos NativeAd. Completa los siguientes campos para un NativeAd.

Campo	Recursos que siempre incluye el adaptador de Pangle
Título
Imagen	1
Cuerpo
Ícono
Llamado a la acción
Calificación por estrellas
Tienda
Precio
Advertiser

¹ El adaptador de Pangle no proporciona acceso directo al recurso de imagen principal para sus anuncios nativos. En su lugar, el adaptador propaga el elemento MediaView con un video o una imagen.

Códigos de error

Si el adaptador no recibe un anuncio de Pangle, puedes verificar el error subyacente de la respuesta del anuncio con ResponseInfo.getAdapterResponses() en las siguientes clases:

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

Estos son los códigos y los mensajes que arroja el adaptador de Pangle cuando no se carga un anuncio:

Código de error	Dominio	Motivo
101	com.google.ads.mediation.pangle	Parámetros de servidor no válidos (p. ej., falta el ID de app o el ID de posición)
102	com.google.ads.mediation.pangle	El tamaño de anuncio solicitado no coincide con un tamaño de banner compatible con Pangle.
103	com.google.ads.mediation.pangle	Falta la respuesta de la oferta o no es válida.
-1-60000	com.pangle.ads	El SDK de Pangle mostró un error. Consulta la documentación de Pangle para obtener más detalles.