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 PubMatic con Mediación de AdMob, que abarca las integraciones de ofertas. En ella, se explica cómo agregar PubMatic a la configuración de mediación de una unidad de anuncios y cómo integrar PubMatic y el adaptador en una app para iOS.
Integraciones y formatos de anuncios admitidos
El adaptador de mediación para PubMatic tiene las siguientes capacidades:
| Integración | |
|---|---|
| Ofertas | |
| Cascada | |
| Formatos | |
| Apertura de la aplicación | |
| Banner | |
| Intersticial | |
| Recompensado | |
| Anuncio intersticial recompensado | |
| Nativo | |
Requisitos
- Objetivo de implementación de iOS 12.0 o una versión posterior
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 PubMatic
Accede a tu cuenta de PubMatic y selecciona la tarjeta SDK de OpenWrap.
Agrega una nueva aplicación
Navega a la pestaña Apps y haz clic en el botón Add App.
Selecciona la Plataforma, así como la URL de la tienda de aplicaciones y el Nombre de la app para tu app.
En Ruta de integración, selecciona iOS (Objective-C / Swift) y AdMob: ofertas del SDK como Ruta de integración secundaria. Luego, haz clic en el botón Add App.
Actualiza tu archivo app-ads.txt
El archivo app-ads.txt de Authorized Sellers for Apps es una iniciativa de IAB Tech Lab que permite garantizar que tu inventario de anuncios para aplicaciones solo se venda a través de los canales que identificaste como autorizados. Para evitar una pérdida significativa en los ingresos publicitarios, deberás implementar un archivo app-ads.txt.
Si aún no lo hiciste,
configura un archivo app-ads.txt para tu app.
Antes de que se finalice la app, se te mostrarán las entradas adecuadas para agregar a tu app-ads.txt.
Para obtener más información sobre cómo implementar app-ads.txt para PubMatic, consulta Cómo implementar app-ads.txt.
ID del perfil
Una vez que hayas creado la app, navega a la pestaña Apps y toma nota del ID de perfil de la aplicación que acabas de crear.
Crear un bloque de anuncios
En la pestaña Unidades de anuncios, selecciona la app que creaste en la sección anterior y haz clic en el botón Crear unidad de anuncios.
Completa el formulario con los detalles de tu unidad de anuncios y haz clic en Guardar.
Toma nota del ID de la unidad de anuncios de OpenWrap que acabas de crear.
Obtén tu ID de publicador
Navega al panel de Analytics. Coloca el cursor sobre el ícono de perfil y toma nota de tu ID.
Paso 2: Configura la demanda de PubMatic en la IU de AdMob
Configura la configuración de mediación para tu unidad de anuncios
Debes agregar el SDK de OpenWrap de PubMatic 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 el nombre de ese grupo de mediación para editarlo y avanza al apartado Cómo agregar el SDK de OpenWrap de PubMatic 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 el SDK de PubMatic OpenWrap como fuente de anuncios
En la tarjeta Ofertas de la sección Fuentes de anuncios, selecciona Agregar fuente de anuncios. Luego, selecciona SDK de PubMatic OpenWrap.Haz clic en Cómo firmar un acuerdo de asociación y establece una asociación de ofertas con el SDK de OpenWrap de PubMatic.
Haz clic en Reconocer y aceptar y, luego, en Continuar.
Si ya tienes una asignación para el SDK de PubMatic OpenWrap, puedes seleccionarla. De lo contrario, haz clic en Agregar asignación.
Luego, ingresa el ID de unidad de anuncios de OpenWrap que obtuviste en la sección anterior. Luego, haz clic en Listo.
Se agregó PubMatic a la lista de socios publicitarios del RGPD y las reglamentaciones estatales de EE.UU.
Sigue los pasos que se indican en la configuración de las reglamentaciones europeas y en la configuración de las reglamentaciones estatales de EE.UU. para agregar PubMatic a la lista de socios publicitarios de las reglamentaciones europeas y estatales de EE.UU. en la IU de AdMob.
Paso 3: Importa el SDK y el adaptador de PubMatic
CocoaPods (recomendado)
Agrega la siguiente línea al Podfile de tu proyecto:
pod 'GoogleMobileAdsMediationPubMatic'Desde la línea de comandos, ejecuta lo siguiente:
pod install --repo-update
Integración manual
Descarga la versión más reciente del SDK de PubMatic OpenWrap para iOS y vincula todos los archivos y paquetes
.xcframeworkde tu proyecto.Descarga la versión más reciente del adaptador de PubMatic desde el vínculo de descarga en el registro de cambios y vincula
PubMaticAdapter.xcframeworken tu proyecto.
Paso 4: Implementa la configuración de privacidad en el SDK de PubMatic
Según la Política de Consentimiento de Usuarios de la UE de Google, debes asegurarte de que se realicen determinadas divulgaciones a los usuarios del Espacio Económico Europeo (EEE) y de obtener su consentimiento con respecto al uso de identificadores de dispositivos y datos personales. Esta política refleja los requisitos de la Directiva de Privacidad Electrónica y el Reglamento General de Protección de Datos (RGPD) de la UE. Cuando solicites el consentimiento, debes identificar cada red de publicidad de tu cadena de mediación que pueda recopilar, recibir o usar datos personales, y proporcionar información sobre el uso de cada red. Actualmente, Google no puede pasar automáticamente la elección de consentimiento del usuario a esas redes.
PubMatic lee automáticamente el consentimiento del RGPD establecido por las plataformas de administración de consentimiento que admiten la especificación de Consentimiento adicional de Google, incluido el SDK de UMP. Para obtener más información, consulta Cómo aprobar el RGPD y el consentimiento del RGPD.
Leyes de privacidad estatales de EE.UU.
Las leyes de privacidad de los estados de EE.UU. exigen que se les otorgue a los usuarios el derecho de inhabilitar la "venta" de su "información personal" (según la definición de esos términos que la ley establece). Para ello, se debe incluir un vínculo destacado con el texto "No vender mi información personal" en la página principal del "vendedor". La guía de cumplimiento de las leyes de privacidad de los estados de EE.UU. ofrece la posibilidad de habilitar el procesamiento 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 de 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.
PubMatic lee automáticamente el consentimiento de la GPP establecido por las plataformas de administración de consentimiento que admiten la especificación de Consentimiento adicional de Google, incluido el SDK de UMP. Para obtener más información, consulta Cómo pasar el consentimiento de GPP.
Paso 5: Agrega el código obligatorio
Integración de SKAdNetwork
Sigue la documentación de PubMatic 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.
Verifica los anuncios de prueba
Para verificar que recibes anuncios de prueba del SDK de OpenWrap de PubMatic, habilita la prueba de una sola fuente de anuncios en el inspector de anuncios con las fuentes de anuncios de PubMatic (ofertas).
Pasos opcionales
Anuncios nativos
Renderización de anuncios
El adaptador de PubMatic muestra sus anuncios nativos como objetos GADNativeAd. Completa los siguientes
campos
para un
GADNativeAd.
| Campo | Activos que siempre incluye el adaptador de PubMatic |
|---|---|
| Título | |
| Imagen | |
| Cuerpo | |
| Ícono | |
| Llamado a la acción | |
| Calificación por estrellas | |
| Tienda | |
| Precio | |
| Advertiser |
Códigos de error
Si el adaptador no recibe un anuncio de PubMatic, puedes verificar el error subyacente de la respuesta del anuncio con GADResponseInfo.adNetworkInfoArray en las siguientes clases:
GADMediationAdapterPubMatic
Estos son los códigos y los mensajes que genera el adaptador de PubMatic cuando no se carga un anuncio:
| Código de error | Dominio | Motivo |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | Falta un ID de publicador obligatorio en la configuración del servidor. |
| 102 | com.google.ads.mediation.pubmatic | La solicitud de recopilación de indicadores de ofertas falló porque se especificaron varios formatos, ninguno o un formato no admitido en los parámetros de la solicitud. |
| 103 | com.google.ads.mediation.pubmatic | La configuración del anuncio no es válida para cargar un anuncio. |
| 104 | com.google.ads.mediation.pubmatic | No se pudo presentar un anuncio intersticial porque no estaba listo. |
| 105 | com.google.ads.mediation.pubmatic | No se pudo presentar un anuncio recompensado porque no estaba listo. |
| 106 | com.google.ads.mediation.pubmatic | No se pudo cargar una de las fuentes de imágenes de anuncios nativos. |
| 1001-5002 | Enviado por el SDK de PubMatic | El SDK de PubMatic mostró un error. Consulta la documentación de PubMatic para obtener más detalles. |