Integra Pangle con la Mediación de AdMob

En esta guía, se muestra cómo usar el Google Mobile Ads SDK for React Native para cargar y mostrar anuncios de Pangle con la mediación, lo que incluye las integraciones de cascada y licitación. Además, indica 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 de React Native.

Integraciones y formatos de anuncios admitidos

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

Integración
Ofertas  1
Cascada
Formatos
Aplicación abierta  2
Banner  2
Intersticial
Recompensado
Intersticial recompensado
Nativo  2

1 Las fuentes de anuncios de licitación de Pangle disponibles incluyen Pangle US, Pangle KR y Pangle ROW.

2 Este formato no es compatible con las siguientes fuentes de anuncios de licitación de Pangle: Pangle EE.UU.

Requisitos previos

  • Es la versión más reciente de Google Mobile Ads SDK for React Native.
  • [Para la licitación de Pangle en EE.UU.]: Usar la versión N/A o una posterior del adaptador de Pangle
  • Versión 0.85.0 o posterior del framework de React Native
  • Para realizar la implementación en Android, haz lo siguiente:
    • Nivel de API de Android 24 o posterior
  • Para realizar la implementación en iOS, haz lo siguiente:
    • Objetivo de implementación de iOS 13.0 o posterior
  • Un proyecto de React Native en funcionamiento configurado con Google Mobile Ads SDK for React Native. Consulta Configura Google Mobile Ads SDK for React Native para obtener más detalles.
  • Configura la Mediación de AdMob.

Paso 1: Establece los parámetros de configuración en la IU de Pangle

Regístrate o accede a tu cuenta de Pangle.

Agrega una aplicación nueva

Navega 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 en Operating System y completa el resto del formulario. A continuación, haz clic en Submit (Enviar).

Android

iOS

Toma nota de tu ID de app.

Android

iOS

Crea una posición de anuncios

Una vez creada tu aplicación, haz clic en el botón Add para crear tu posición de anuncios.

Android

iOS

Ofertas

Selecciona tu formato del anuncio y nombre de la posición de anuncios, y selecciona In-App Bidding como el tipo de precio. Completa el resto del formulario y haz clic en Enviar.

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

Android

iOS

Cascada

Selecciona tu formato de anuncios en Ad Formats y agrega un nombre de posición en Ad Placement Name. Luego, selecciona Global CPM en Pricing Type. Completa el resto del formulario y haz clic en Enviar.

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

Android

iOS

Busca la clave de API de informes de Pangle

Ofertas

Este paso no se requiere para las integraciones de la licitación.

Cascada

Toma nota del ID de usuario que se muestra en la esquina inferior izquierda de la página.

Haz clic en Integrations > SDK & API > Pangle Reporting API 2.0. Toma nota de los valores indicados en Role ID y Security Key.

Actualiza tu archivo app-ads.txt

El archivo app-ads.txt de Authorized Sellers for Apps es una iniciativa de IAB Tech Lab que ayuda a garantizar que tu inventario de anuncios de aplicación solo se venda a través de los canales que identificaste como autorizados. Para evitar pérdidas significativas en los ingresos publicitarios, deberás implementar un archivo app-ads.txt. Si todavía no lo hiciste, configura un archivo app-ads.txt para tu app.

Para implementar app-ads.txt en Pangle, consulta cómo agregar Pangle a tu archivo app-ads.txt.

Activa el modo de prueba

Para habilitar los anuncios de prueba de Pangle, sigue las instrucciones de la guía de Pangle sobre cómo agregar un anuncio de prueba.

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

Configura los parámetros de la mediación para tu unidad de anuncios

Android

Para obtener instrucciones, consulta el paso 2 de la guía para Android.

iOS

Para obtener instrucciones, consulta el paso 2 de la guía para iOS.

Agrega la DSP de Pangle a la lista de socios publicitarios que cumplen con el RGPD y las reglamentaciones estatales de EE.UU.

Sigue los pasos que se indican en Configuración conforme a los reglamentos europeos y Configuración de las reglamentaciones estatales de EE.UU. para agregar la DSP de Pangle a la lista de socios publicitarios que cumplen con los reglamentos europeos y las reglamentaciones estatales de EE.UU. en la IU de AdMob.

Paso 3: Importa el SDK y el adaptador de Pangle

En el directorio raíz de tu proyecto, instala el adaptador de mediación de Google Mobile Ads SDK for React Native para Pangle. Completa lo siguiente:

  1. Copia el archivo tar del adaptador Google Mobile Ads SDK for React Native del directorio gma-sdk-react-native/adapters/pangle/ al directorio local_packages/ de tu proyecto. Si no tienes la carpeta adapters, consulta Requisitos previos.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/pangle/gma-mediation-pangle-0.1.0.tgz local_packages/

    Reemplaza EXTRACT_DIR por la ruta de acceso al directorio en el que extrajiste el archivo.

  2. Instala el paquete del adaptador con el administrador de paquetes que prefieras:

    npm

    npm install ./local_packages/gma-mediation-pangle-0.1.0.tgz

    hilo

    yarn add ./local_packages/gma-mediation-pangle-0.1.0.tgz

  3. Si compilas para Android, agrega el siguiente repositorio al archivo build.gradle en el directorio android de tu proyecto:

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

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

Para cumplir con la Política de Consentimiento de Usuarios de la UE de Google, debes divulgar determinada información a los usuarios del Espacio Económico Europeo (EEE), el Reino Unido y Suiza, y obtener su consentimiento para el uso de cookies y otro tipo de almacenamiento local cuando esto sea un requisito legal, así como para recopilar, compartir y utilizar datos personales para la personalización de anuncios. Esta política refleja los requisitos de la Directiva de Privacidad Electrónica y del Reglamento General de Protección de Datos (RGPD) de la UE. Tú eres responsable de verificar que el consentimiento se propague a cada fuente de anuncios de tu cadena de mediación.

La versión 0.1.0 y las posteriores del adaptador de React Native de Pangle admiten el envío de indicadores de consentimiento según el RGPD desde el SDK de UMP y las plataformas de administración de consentimiento que se integran en la especificación de consentimiento adicional de Google al SDK de Pangle.

Leyes de privacidad estatales de EE.UU.

Las leyes de privacidad estatales de EE.UU. exigen otorgar a los usuarios el derecho a inhabilitar la "venta" de su "información personal" (según la definición de esos términos en la ley), con la opción de hacerlo a través de un vínculo destacado que indique que no desean que se venda su información personal en la página principal del "vendedor". La guía de cumplimiento de las leyes de privacidad estatales de EE.UU. ofrece la posibilidad de habilitar el tratamiento de datos restringido para la publicación de anuncios de Google, pero Google no puede aplicar este parámetro de configuración a cada red de publicidad de tu cadena de mediación. Por lo tanto, debes identificar cada red de publicidad en tu cadena de mediación que pueda participar en la venta de información personal y seguir las instrucciones de cada una de esas redes para garantizar el cumplimiento.

El siguiente código de muestra indica cómo pasar la información de consentimiento al SDK de Pangle. Configura la información de consentimiento antes de inicializar Google Mobile Ads SDK for React Native para garantizar que se reenvíen correctamente al SDK de Pangle.

import {
  PangleMediation,
  PanglePAConsentType,
} from '@google/gma-mediation-pangle';
// ...

PangleMediation.setPAConsent(PanglePAConsentType.CONSENT);

Consulta la guía de integración de Pangle para obtener más detalles y conocer los valores que se pueden incluir en cada método.

Paso 5: Agrega el código requerido

Android

No se requiere ningún código adicional para la integración de Pangle.

iOS

Integración de SKAdNetwork

Sigue la documentación de Pangle para agregar los identificadores de SKAdNetwork al archivo Info.plist de tu proyecto.

Paso 6: 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 una única fuente de anuncios en el inspector de anuncios con las fuentes de anuncios Pangle (Waterfall), Pangle US SDK (Bidding), Pangle KR SDK (Bidding) y Pangle ROW SDK (Bidding).

Códigos de error

Si el adaptador no recibe un anuncio de Pangle, los publicadores pueden verificar el error subyacente en la respuesta de solicitud de anuncio con ResponseInfo en las siguientes clases:

Android

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

iOS

GADMediationAdapterPangle

A continuación, se indican los códigos y los correspondientes mensajes que arroja el adaptador de Pangle cuando se produce un error al cargar un anuncio:

Android

Código de error Dominio Motivo
101 com.google.ads.mediation.pangle Parámetros del 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 del anuncio solicitado no coincide con un tamaño de banner admitido por Pangle.
103 com.google.ads.mediation.pangle El SDK de Pangle no admite usuarios menores de edad.
-1-60000 com.pangle.ads El SDK de Pangle devolvió un error. Para obtener más detalles, consulta la documentación de Pangle.

iOS

Código de error Dominio Motivo
101 com.google.mediation.pangle Parámetros del servidor no válidos (p.ej., falta el ID de app o el ID de posición).
102 com.google.mediation.pangle El tamaño del anuncio solicitado no coincide con un tamaño de banner admitido por Pangle.
104 com.google.mediation.pangle El SDK de Pangle no admite usuarios menores de edad.
-1-60000 Enviado por el SDK de Pangle El SDK de Pangle devolvió un error. Para obtener más detalles, consulta la documentación de Pangle.

Versión 0.1.0

  • Versión inicial