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 AppLovin usando mediación, que abarcan integraciones de ofertas y en cascada. Abarca cómo agregar AppLovin en la configuración de mediación de una unidad de anuncios y cómo integrar el SDK de AppLovin y un adaptador en una Flutter app.
Integraciones y formatos de anuncios admitidos
El adaptador de mediación AdMob para AppLovin tiene la las siguientes capacidades:
Integración | |
---|---|
Ofertas | |
Cascada | |
Formatos | |
Banner | 1 |
Intersticial | |
Recompensado |
Anuncios de banner (excepto MREC) banners) solo se admiten en la mediación. La licitación no admite ningún tipo de anuncios de banner.
Requisitos
- SDK de anuncios de Google para dispositivos móviles más reciente
- Flutter 3.7.0 o una versión posterior
- Cómo implementar en Android
- Nivel de API 21 o versiones posteriores de Android
- Cómo implementar en iOS
- Objetivo de implementación de iOS 12.0 o superior
- Un proyecto en funcionamiento Flutter configurado con Google SDK de anuncios para dispositivos móviles. Consulta Comienza para obtener más información.
- Cómo completar la mediación Guía de introducción
Paso 1: Establece la configuración en la IU de AppLovin
Regístrate o accede a tu cuenta a tu cuenta de AppLovin.
Para configurar tu unidad de anuncios de AdMob, necesitarás lo siguiente: Clave del SDK y Clave de informes de AppLovin. Para encontrarlos, ve a la IU de AppLovin > Cuenta > Claves para ver ambos valores.
Si solo planeas integrar la licitación, puedes continuar con definir tu configuración de mediación
Seleccionar aplicación para mediación
Ofertas
Este paso no es obligatorio para las integraciones de ofertas.
Cascada
En la IU de AppLovin, selecciona Applications Monetización para acceder a tus apps registradas. Selecciona la app que te gustaría usar con la mediación desde la lista de aplicaciones disponibles.
Crear una zona
Ofertas
Este paso no es obligatorio para las integraciones de ofertas.
Cascada
En la IU de AppLovin, selecciona Zones, en la sección Monetization para obtener los IDs de las zonas registradas. Si ya creaste el zonas necesarias para tu app, continúa con el Paso 2. Para crear un ID de zona nuevo, haz clic en Crear zona.
Ingresa el nombre de Zone ID, selecciona Android como Platform y, luego, elige el Tipo de anuncio.
Configura los precios de la zona. Para ello, selecciona CPM fijo o Optimizado por AppLovin. Los CPM pueden configurarse por país para con la opción CPM fijo. Luego, haz clic en Guardar.
Android
iOS
Una vez que se crea la zona, su ID se puede encontrar en el ID de zona. .
Android
iOS
Activa el modo de prueba
Sigue las instrucciones de AppLovin Modo de prueba MAX sobre cómo habilitar los anuncios de prueba de AppLovin.
Paso 2: Configura la demanda de AppLovin en la AdMob IU
Cómo configurar la mediación para tu unidad de anuncios
Android
Para obtener instrucciones, consulta el paso 2 de la guía para Android.
iOS
Si quieres obtener instrucciones, consulta el paso 2 de la guía para iOS.
Se agregó AppLovin Corp. a la lista de socios publicitarios del GDPR y las reglamentaciones estatales de EE.UU.
Sigue los pasos que se indican en Configuración del GDPR y Configuración de las reglamentaciones estatales de EE.UU. para agregar AppLovin Corp. a la lista de socios publicitarios de las reglamentaciones estatales de EE.UU. y el GDPR en la AdMob IU.
Paso 3: Importa el SDK de AppLovin y el adaptador
Integración a través de pub.dev
Agrega la siguiente dependencia con las versiones más recientes del
AppLovin El SDK y el adaptador incluidos
Archivo pubspec.yaml
:
dependencies:
gma_mediation_applovin: ^1.0.0
Integración manual
Descarga la versión más reciente del complemento de mediación de anuncios de Google para dispositivos móviles para
AppLovin,
extraer el archivo descargado y agregar la carpeta del complemento extraída
(y su contenido) a tu proyecto de Flutter. Luego, haz referencia al complemento en tu
pubspec.yaml
agregando la siguiente dependencia:
dependencies:
gma_mediation_applovin:
path: path/to/local/package
Paso 4: Implementa la configuración de privacidad en el SDK de AppLovin
Consentimiento para la UE y GDPR
Según el Consentimiento de Usuarios de la UE de Google política, debe asegurarse de que se proporcionen ciertas divulgaciones los consentimientos obtenidos de los usuarios del Espacio Económico Europeo (EEE) en relación con y el uso de identificadores de dispositivos y datos personales. Esta política refleja el requisitos de la Directiva de Privacidad Electrónica y de la Protección General de Datos Reglamento General de Protección de Datos (RGPD). Cuando solicite el consentimiento, debe identificar cada red de publicidad de tu cadena de mediación que recopilen, reciban o usen datos personales y proporcionar información sobre el uso de cada red. Por el momento, Google no puede pasar automáticamente la elección de consentimiento del usuario a esas redes.
AppLovin permite leer la cadena de consentimiento desde las preferencias compartidas y la configuración el estado de consentimiento según corresponda.Si eres
no usen una CMP que escriba la cadena de consentimiento en el recurso compartido
preferencias, puedes usar
GmaMediationApplovin.setHasUserConsent()
y
GmaMediationApplovin.setIsAgeRestrictedUser()
. En el siguiente código de muestra, se muestra la manera
para pasar la información de consentimiento
al SDK de AppLovin. Se deben definir estas opciones
antes de inicializar el SDK de anuncios de Google para dispositivos móviles
para asegurarte de que se reenvíen correctamente al SDK de AppLovin.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);
Consulta la configuración de privacidad de AppLovin para obtener más información.
Leyes de privacidad estatales de EE.UU.
EE.UU. leyes de privacidad estatales deben brindar a los usuarios los permisos para inhabilitar la "oferta" de su "información personal" (como lo define la ley condiciones), con la opción de inhabilitación ofrecida por medio de un mensaje destacado "No vender Información" el vínculo en la página la página de inicio del grupo. El EE.UU. privacidad de estados en la guía de cumplimiento de leyes ofrece la posibilidad de habilitar procesamiento de datos restringido para la publicación de anuncios de Google, pero Google no puede aplicar esta configuración a cada anuncio en tu cadena de mediación. Por lo tanto, debes identificar cada red de publicidad de su cadena de mediación que puedan participar en la venta de información y seguir las indicaciones de cada una de esas redes para garantizar y cumplimiento.
El complemento de mediación de Google Mobile Ads para AppLovin
incluye el
GmaMediationApplovin.setDoNotSell()
. En el siguiente código de muestra, se muestra cómo pasar
la información de consentimiento al SDK de AppLovin. Debes establecer estas opciones antes de
para inicializar los anuncios de Google para celulares.
SDK
para asegurarte de que se reenvíen correctamente al SDK de AppLovin.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setDoNotSell(true);
Consulta Privacidad de AppLovin documentación para obtener más información.
Paso 5: Agrega el código requerido
Android
No se requiere ningún código adicional para la integración de AppLovin.
iOS
Integración de SKAdNetwork
Sigue la documentación de AppLovin para agregar los identificadores de SKAdNetwork al archivo Info.plist` de tu proyecto.
Paso 6: 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 AppLovin IU.
Cómo verificar los anuncios de prueba
Para verificar que recibes anuncios de prueba deAppLovin, habilita las pruebas de fuentes de anuncios individuales en el inspector de anuncios mediante la AppLovin (Bidding) and AppLovin (Waterfall) fuente de anuncios.
Pasos opcionales
Parámetros específicos de la red
El adaptador AppLovin admite el paso de un objeto AppLovinMediationExtras
al
para configurar parámetros específicos de la red. En el siguiente código de muestra, se muestra
Cómo inhabilitar el audio en los anuncios de video con el parámetro isMuted
:
AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [applovinExtras],
);
Optimizaciones
Agregar una llamada a
GmaMediationApplovin.initializeSdk('sdkKey')
a tu actividad de lanzamiento proporciona
AppLovin permite hacer un seguimiento de los eventos en cuanto se inicia la app.
Códigos de error
Si el adaptador no recibe un anuncio de AppLovin,
los publicadores pueden verificar el error subyacente de la respuesta del anuncio
ResponseInfo
en el
siguientes clases:
Android
com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter
iOS
GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin
Estos son los códigos y los mensajes adjuntos que arroja el adaptador de AppLovin. Cuando un anuncio no se carga:
Android
Código de error | Motivo |
---|---|
De -1009 a -1, 204 | El SDK de AppLovin mostró un error. Consulta Documentación de AppLovin para obtener más información. |
101 | El tamaño de anuncio solicitado no coincide con un tamaño de banner compatible con AppLovin. |
103 | El contexto es nulo. |
104 | El token de oferta de AppLovin está vacío. |
105 | Se solicitaron varios anuncios para la misma zona. AppLovin solo puede cargar 1 anuncio a la vez por zona. |
106 | El anuncio no está listo para mostrarse. |
108 | El adaptador AppLovin no admite el formato de anuncio que se solicita. |
iOS
Código de error | Motivo |
---|---|
De -1009 a -1, 204 | El SDK de AppLovin mostró un error. Consulta la documentación de AppLovin para obtener más información. |
101 | El tamaño de anuncio solicitado no coincide con un tamaño de banner compatible con AppLovin. |
102 | Faltan los parámetros del servidor AppLovin configurados en la IU de AdMob o no son válidos. |
103 | No se pudo mostrar el anuncio de AppLovin. |
104 | Se solicitaron varios anuncios para la misma zona. AppLovin solo puede cargar 1 anuncio a la vez por zona. |
105 | No se encontró la clave del SDK de AppLovin. |
107 | El token de oferta está vacío. |
108 | El adaptador AppLovin no admite el formato de anuncio que se solicita. |
110 | AppLovin envió una devolución de llamada de carga correcta, pero no cargó anuncios. |
Registro de cambios del adaptador de mediación de Flutter de AppLovin
1.2.0
- Se verificó la compatibilidad con la versión 12.6.1.0 del adaptador AppLovin para Android.
- Se verificó la compatibilidad con la versión 12.6.1.0 del adaptador AppLovin para iOS.
- Se compiló y probó con la versión 5.1.0 del complemento de Flutter de los anuncios de Google para dispositivos móviles.
1.1.0
- La API de GmaMediaApplovin ya no es estática.
- Se verificó la compatibilidad con la versión 12.4.3.0 del adaptador AppLovin para Android.
- Se verificó la compatibilidad con la versión 12.4.2.0 del adaptador AppLovin para iOS.
- Se compiló y probó con la versión 5.1.0 del complemento de Flutter de los anuncios de Google para dispositivos móviles.
1.0.0
- Versión inicial
- Compatibilidad verificada con la versión 12.3.0.0 del adaptador AppLovin para Android
- Compatibilidad verificada con el adaptador AppLovin para iOS versión 12.2.1.0
- Se compiló y probó con la versión 5.0.0 del complemento de Flutter de los anuncios de Google para dispositivos móviles.