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

Integre Pangle con la licitación

En esta guía, se muestra cómo usar el SDK de Google Mobile Ads para cargar y mostrar anuncios de Pangle mediante la mediación y, que abarcan las integraciones de cascada y ofertas. En él, 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 Android app.

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 Waterfall se encuentra en versión beta cerrada.

² 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.

Activa 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 Ad Manager

Accede a tu cuenta de Ad Manager.

Agrega Pangle en Empresas

Ofertas

Este paso no es obligatorio para las integraciones de ofertas.

Cascada

Navega a Administrador > Empresas y, luego, haz clic en el botón Nueva empresa en la pestaña Todas las empresas. Selecciona Red de publicidad.

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

No es necesario que ingreses un Nombre de usuario ni una Contraseña. Haz clic en Guardar cuando termines.

Habilita el uso compartido de indicadores seguros

Ofertas

Navega a Administrador > Configuración global. Ve a la pestaña Configuración de la cuenta de Ad Exchange, revisa la opción Uso compartido de indicadores seguros y actívala. Haz clic en Guardar.

Cascada

Este paso no es obligatorio para las integraciones en cascada.

Configura las ofertas de Pangle

Ofertas

Navega a Publicación > Ofertantes y haz clic en Nuevo ofertante en la pestaña Licitación mediante SDK.

Selecciona Pangle como el ofertante.

Activa Agregar la biblioteca de indicadores de este ofertante a la lista de indicadores permitidos y Permitir que se compartan indicadores con este ofertante. Luego, haz clic en Continuar.

Haz clic en Continuar.

Haz clic en Listo.

Cascada

Este paso no es obligatorio para las integraciones en cascada.

Configura la asignación de unidades de anuncios

Ofertas

Navega a Publicación > Ofertantes y selecciona la empresa de Pangle en la pestaña Licitación mediante SDK.

Ve a la pestaña Asignación de unidades de anuncios y haz clic en Nueva asignación de unidad de anuncios.

Elige Unidad de anuncios específica. Selecciona una unidad de anuncios y un formato, Aplicación para dispositivos móviles como Tipo de inventario y tu Aplicación para dispositivos móviles. Luego, ingresa el ID de aplicación y el ID de posición del anuncio que obtuviste en la sección anterior. Por último, haz clic en Guardar.

Cascada

Navega a Publicación > Grupos de rendimiento y haz clic en el botón Nuevo grupo de rendimiento. Selecciona tu aplicación para dispositivos móviles.

Desplázate hacia abajo y haz clic en Agregar socio de rendimiento.

Selecciona la empresa que creaste para Pangle en la sección anterior. Elige Mediación de SDK para dispositivos móviles como el Tipo de integración, Android como la Plataforma y Activo como el Estado.

Ingresa el ID de aplicación y el ID de posición de anuncios que obtuviste en la sección anterior, y el valor de CPM predeterminado. Haz clic en Guardar.

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.5.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 Ad Manager 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.