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 anuncios de Google para dispositivos móviles para cargar y mostrar anuncios de Pangle usando Mediación de AdMob, que abarcan las integraciones en cascada y de ofertas. Abarca cómo agregar Pangle a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK de Pangle y adaptador 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
Aplicación abierta	¹
Banner
Intersticial
Recompensado
Intersticial recompensado
Nativo

¹ Integración de ofertas para este formato está en versión beta cerrada.

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 Pangle

Regístrate o accede a tu cuenta de Pangle.

Agregar una aplicación nueva

Ve a la pestaña Applications y haz clic en el botón Add App.

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

Anota el ID de la app.

Cómo crear una posición de anuncios

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

Ofertas

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

Una vez creada la colocación de anuncios, toma nota del ID de posición de anuncios.

Cascada

Selecciona el Formato del anuncio y el 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 creada la colocación de anuncios, toma nota del ID de posición de anuncios.

Localizar la clave de API de Pangle Reporting

Ofertas

Este paso no es obligatorio para las integraciones de ofertas.

Cascada

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

Haz clic en Integraciones > SDK y API > API de Pangle Reporting 2.0. Toma nota del ID de función y la Llave de seguridad.

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 AdMob IU

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

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

Primero, accede a tu cuenta de AdMob. A continuación, ve a la pestaña Mediación. Si tienes un grupo de mediación existente que deseas modificar, haz clic en el nombre de ese grupo para editarlo y ve a Agregar Pangle como fuente del anuncio.

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

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

Asígnale un nombre a tu grupo de mediación y selecciona las ubicaciones para la que deseas segmentar tus anuncios. A continuación, establece el estado del grupo de mediación en Habilitado y haz clic en Agregar bloques de anuncios.

Asocia este grupo de mediación a una o más de tusAdMob unidades de anuncios existentes. Luego, haga clic en Listo.

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

Agregar Pangle como fuente del anuncio

Ofertas

En la tarjeta Ofertas de la sección Fuentes del anuncio, selecciona Agregar fuente del anuncio. Luego, selecciona Pangle.

Haz clic en Cómo firmar un acuerdo de asociación y configura una asociación de licitación conPangle.

Haz clic en Confirmar 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 App ID and Ad Placement IDobtenido en la sección anterior. Luego, haga clic en Listo.

Importante: Los App ID deben estar asociados con la app de destino como en la IU dePangle .

Cascada

En la tarjeta Waterfall de la sección Fuentes del anuncio, selecciona Agregar fuente del anuncio. 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 App ID and Ad Placement IDobtenido en la sección anterior. Luego, haga clic en Listo.

Paso 3: Importa el SDK y el adaptador de Pangle

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://artifact.bytedance.com/repository/pangle/")
    }
  }
}

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 SDK de Pangle y adaptador:

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

Integración manual

Descarga la versión más reciente del SDK de Pangle para Android Luego, extrae open_ad_sdk.aar de la carpeta de archivos descargada y agregarla a tu proyecto.
Ve a la sección Artefactos del adaptador Pangle en el repositorio Maven de Google. Selecciona la versión más reciente y descarga Pangle .aar de tu adaptador y agrégalo a tu proyecto.

Paso 4: Agrega el código requerido

Ofuscación de ProGuard

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

Paso 5: Prueba tu implementación

Habilitar anuncios de prueba

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

Cómo verificar los anuncios de prueba

Para verificar que recibes anuncios de prueba dePangle, habilita las pruebas de fuentes de anuncios individuales en el inspector de anuncios mediante la Pangle (Bidding) and Pangle (Waterfall) fuente de anuncios.

Pasos opcionales

Anuncios nativos

Renderización de anuncios

El adaptador Pangle devuelve sus anuncios nativos como NativeAd objetos. Completa la siguiente campos durante un NativeAd.

Campo	El adaptador Pangle siempre incluye los elementos
Título
Imagen	1
Cuerpo
Ícono
Llamado a la acción
Calificación por estrellas
Tienda
Precio
Advertiser

¹ El adaptador Pangle no proporcionan acceso directo al recurso de imagen principal de sus anuncios nativos. En cambio, el de forma predeterminada completa MediaView con un video o una imagen.

Códigos de error

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

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

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

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 la aplicación 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 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 información.