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

Integre Pangle a las ofertas

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, 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

¹ La integración de Waterfall es en versión beta cerrada.

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

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

Accede a tu cuenta de Ad Manager.

Agregar 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 la Mediación.

No es necesario que ingreses un nombre de usuario ni una contraseña. Haz clic en Save cuando termines.

Habilitar 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 y activa Uso compartido de indicadores seguros. Haz clic en Guardar.

Cascada

Este paso no es obligatorio para las integraciones en cascada.

Configura las Pangle ofertas

Ofertas

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

Selecciona Pangle como 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 dePangle en la pestaña Ofertas de SDK.

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

Elige Unidad de anuncios específica. Selecciona una unidad de anuncios y un formato, Aplicación para dispositivos móviles como el Tipo de inventario y tu Aplicación para dispositivos móviles. Luego, ingresa losApp ID and Ad Placement ID obtenidos 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 para la que creaste Pangle en la sección anterior. 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 el App ID and Ad Placement ID obtenido 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 (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 Ad Manager 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.