En esta guía, se muestra cómo integrar un adaptador de mediación en tu app de Flutter.
Requisitos previos
Antes de integrar la mediación para un formato de anuncio, debes integrar ese formato de anuncio en tu app:
- Anuncios en forma de banner
- Anuncios intersticiales
- Anuncios nativos
- Anuncios recompensados
- Anuncios intersticiales recompensados
¿Es la primera vez que utilizas la mediación? Lee la Introducción a la mediación.
Inicializa el SDK de anuncios de Google para dispositivos móviles
En la guía de inicio rápido, se muestra cómo inicializar el SDK de anuncios de Google para dispositivos móviles. Durante esa llamada de inicialización, también se inicializan los adaptadores de mediación. Es importante esperar a que se complete la inicialización antes de cargar anuncios para verificar la participación completa de cada red publicitaria en la primera solicitud de anuncio.
En el siguiente código de muestra, se muestra cómo puedes verificar el estado de inicialización de cada adaptador antes de realizar una solicitud de anuncio.
void main() {
WidgetsFlutterBinding.ensureInitialized();
MobileAds.instance.initialize()
.then((initializationStatus) {
initializationStatus.adapterStatuses.forEach((key, value) {
debugPrint('Adapter status for $key: ${value.description}');
});
});
runApp(MyApp());
}
Actualiza la configuración de Gradle (solo para Android)
Agrega las siguientes líneas a tu archivo settings.gradle
para que puedas usar las APIs de Android del complemento:
def flutterSdkPath = {
def properties = new Properties()
file("local.properties").withInputStream { properties.load(it) }
def flutterSdkPath = properties.getProperty("flutter.sdk")
assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
return flutterSdkPath
}()
includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")
Agrega dependencias para las redes de socios
Los adaptadores de mediación y sus dependencias deben agregarse a tus proyectos para Android y iOS. Para agregarlos, actualiza tu archivo build.gradle
a nivel de la app en Android y Podfile
en iOS. Google tiene adaptadores de código abierto en GitHub para Android y iOS.
Consulta la documentación de Android y iOS de cada red de socios para obtener orientación detallada sobre cómo agregar su adaptador en tu app.
Verifica qué clase de adaptador de red de publicidad cargó el anuncio
En el siguiente código de ejemplo, se muestra cómo registrar el nombre de la clase de la red publicitaria para un anuncio de banner:
final bannerAd = AdManagerBannerAd(
size: [AdSize.banner],
adUnitId: '<your-ad-unit>',
listener: AdManagerBannerAdListener(
onAdLoaded: (ad) {
debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
},
),
request: AdManagerAdRequest(),
);
Usa anuncios de banner con la mediación
Asegúrate de inhabilitar la actualización en todas las IU de fuentes de anuncios de terceros para las unidades de anuncios de banner que se usan en la mediación. Esto evita una actualización doble, ya que Ad Manager también activa una actualización según la frecuencia de actualización de tu unidad de anuncios de banner.
Usa anuncios nativos con la mediación
A continuación, se indican algunas prácticas recomendadas que debes tener en cuenta cuando implementes la mediación nativa.
- Política de presentación de anuncios nativos
- Cada red publicitaria tiene sus propias políticas. Cuando usas la mediación, es importante recordar que tu app debe seguir cumpliendo con las políticas de la red de mediación que proporcionó el anuncio.
Leyes de privacidad estatales de EE.UU. y RGPD
Si necesitas satisfacer las leyes de privacidad estatales de EE.UU. o el Reglamento General de Protección de Datos (RGPD), sigue los pasos que se indican en la configuración de las reglamentaciones estatales de EE.UU. o en la configuración del RGPD para agregar a tus socios de mediación a la lista de socios publicitarios de los estados de EE.UU. o del RGPD de Privacidad y mensajería de Ad Manager. De lo contrario, es posible que los socios no publiquen anuncios en tu app.
Obtén más información para habilitar el procesamiento de datos restringido (PDR) y obtener el consentimiento del RGPD con el SDK de Google User Messaging Platform (UMP).