Cómo integrar AppLovin con la mediación

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

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.