Se usó la API de Cloud Translation para traducir esta página.

Cómo integrar AdColony con la mediación

En esta guía, se muestra cómo usar el SDK de anuncios de Google para dispositivos móviles con el fin de cargar y mostrar anuncios de AdColony mediante la mediación, lo que abarca las integraciones en cascada y las ofertas. Se explica cómo agregar AdColony a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK y el adaptador de AdColony en una app Android .

Integraciones y formatos de anuncios admitidos

El adaptador de mediación Ad Manager para AdColony tiene las siguientes capacidades:

Integración
Ofertas
Cascada
Formatos
Banner
Intersticial
Recompensado
Nativo

Requisitos

Nivel de API de Android 19 o versiones posteriores

[Para ofertas]: Adaptador AdColony 3.3.10.1 o superior (se recomienda la versión más reciente)

Versión más reciente del SDK de anuncios de Google para dispositivos móviles
Completa la guía de introducción de la mediación.

Paso 1: Establece la configuración en la IU de AdColony

Regístrate y accede a tu cuenta de AdColony. Para agregar tu app al panel del editor de AdColony, haz clic en el botón Setup New App.

AdColony configuró una nueva app

Completa el formulario y haz clic en Create en la parte inferior de la página para agregar tu app a AdColony.

Crear app de AdColony

Una vez que se haya creado tu app, puedes obtener el ID de la app en Monetización > Apps en la sección Información básica de la app.

ID de la app de AdColony

Para crear una zona de anuncios nueva, haz clic en el botón Configurar zona de anuncios nueva en la sección Zonas de anuncios de la página de tu app. Te recomendamos que crees una zona de anuncios nueva para la mediación con Ad Manager , incluso si ya tienes una.

Zona de configuración de AdColony

Para obtener más instrucciones sobre cómo crear una posición de anuncios, selecciona la pestaña correspondiente a tu formato de anuncio preferido.

Establece ¿La zona está activa? en Sí.
Ingresa un Nombre para tu zona de anuncios.
Elige Banner como el Tamaño de la zona de anuncios.
Ingresa un valor para el Límite de jugadas diarias.

Intersticial

Establece ¿La zona está activa? en Sí.
Ingresa un Nombre para tu zona de anuncios.
Elige Anuncio previo al video/Intersticial como el Tipo de zona.
Ingresa un valor para el Límite de jugadas diarias.

Recompensado

Establece ¿La zona está activa? en Sí.
Ingresa un Nombre para tu zona de anuncios.
Elige Intercambio de valor/V4VC como Tipo de zona.
Configura Client Side Only? en Yes y, luego, ingresa un Nombre de moneda virtual, Diaria cantidad máxima de videos por usuario y Reward Amount.

Nota: El adaptador reenvía el valor de recompensa especificado aquí, a menos que se anulen los valores de recompensa en la IU de Ad Manager.
Ingresa un valor para el Límite de jugadas diarias.

Cuando termines de crear la zona de anuncios, haz clic en el botón Crear.

Una vez creada la zona de anuncios, podrás encontrar tu ID de zona en la sección Integración de la zona de anuncios. El ID de zona se usará en el próximo paso.

ID de zona AdColony

Localiza tu clave de API de AdColony

Ofertas

Este paso no es obligatorio para las integraciones de ofertas.

Cascada

Necesitarás tu clave de API de AdColony para configurar tuAd Manager ID de unidad de anuncios. Navega a Account Settings en el panel del editor de AdColony para ubicar tu clave de API.

Configuración de AdColony

Activar el modo de prueba

Para habilitar los anuncios de prueba en AdColony, ve al panel de AdColony y navega a Monetization > Apps. Selecciona la zona para la que deseas habilitar los anuncios de prueba en la sección Zonas de anuncios de tu app. Para habilitar los anuncios de prueba, marca Sí en ¿Quieres mostrar solo anuncios de prueba? en la sección Desarrollo.

Prueba AdColony

Paso 2: Configura la demanda de AdColony en la Ad Manager IU

Accede a tu cuenta de Ad Manager.

Agregar AdColony en Empresas

Ofertas

Este paso no es obligatorio para las integraciones de ofertas.

Cascada

Navega a Administrador > Empresas y, luego, haz clic en el botón Nueva empresa en la pestaña Todas las empresas. Selecciona Red de publicidad.

Selecciona AdColony como la Red de publicidad, ingresa un Nombre único y habilita la Mediación. Activa Recopilación de datos automática y, luego, ingresa el API Key que obtuviste en la sección anterior.

No es necesario que ingreses un nombre de usuario ni una contraseña. Haz clic en Save cuando termines.

Habilitar el uso compartido de indicadores seguros

Ofertas

Navega a Administrador > Configuración global. Ve a la pestaña Configuración de la cuenta de Ad Exchange, revisa y activa Uso compartido de indicadores seguros. Haz clic en Guardar.

Cascada

Este paso no es obligatorio para las integraciones en cascada.

Configura las AdColony ofertas

Ofertas

Navega a Publicación > Ofertantes y haz clic en Nuevo ofertante en la pestaña Ofertas de SDK.

Selecciona AdColony como ofertante.

Activa Agregar la biblioteca de indicadores de este ofertante a la lista de indicadores permitidos y Permitir que se compartan indicadores con este ofertante. Luego, haz clic en Continuar.

Haz clic en Continuar.

Haz clic en Listo.

Cascada

Este paso no es obligatorio para las integraciones en cascada.

Configura la asignación de unidades de anuncios

Ofertas

Navega a Publicación > Ofertantes y selecciona la empresa deAdColony en la pestaña Ofertas de SDK.

Ve a la pestaña Asignación de unidades de anuncios y haz clic en Nueva asignación de unidades de anuncios.

Elige Unidad de anuncios específica. Selecciona una unidad de anuncios y un formato, Aplicación para dispositivos móviles como el Tipo de inventario y tu Aplicación para dispositivos móviles. Luego, ingresa losApp ID and Zone ID obtenidos en la sección anterior. Por último, haz clic en Guardar.

Cascada

Navega a Publicación > Grupos de rendimiento y haz clic en el botón Nuevo grupo de rendimiento. Selecciona tu Aplicación para dispositivos móviles.

Desplázate hacia abajo y haz clic en Agregar socio de rendimiento.

Selecciona la empresa para la que creaste AdColony en la sección anterior. Elige Mediación del SDK para dispositivos móviles como el Tipo de integración, Android como la Plataforma y Activo como el Estado.

Ingresa el App ID and Zone ID obtenido en la sección anterior y el valor de CPM predeterminado. Haz clic en Guardar.

Nota: La recopilación automática de datos tarda algunos días en recopilar datos antes de poder calcular con precisión un valor de CPM dinámico para una red de mediación. Una vez que se puede calcular el eCPM, se actualiza automáticamente por ti.

Agregar AdColony 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 AdColony a la lista de socios publicitarios de las reglamentaciones estatales de EE.UU. y el GDPR en la Ad Manager IU.

Paso 3: Importa el SDK y el adaptador de AdColony

Integración de Android Studio (recomendada)

En el archivo build.gradle.kts a nivel de la app, agrega las siguientes dependencias de implementación y configuraciones. Usa las versiones más recientes del SDK y el adaptador de AdColony:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:adcolony:4.8.0.2")
}

Cómo migrar el proyecto a AndroidX

El SDK de AdColony depende de las bibliotecas de compatibilidad de Android, pero el SDK de anuncios de Google para dispositivos móviles más reciente usa bibliotecas de Jetpack.

Para asegurarte de que los SDK de AdColony y el SDK de anuncios de Google para dispositivos móviles sean compatibles, crea un archivo gradle.properties en el nivel superior de tu proyecto y agrega el siguiente código:

android.useAndroidX=true
android.enableJetifier=true

Con esta acción, se reescribirá el objeto binario del SDK de AdColony para usar las bibliotecas de Jetpack. Consulta la guía de migración de AndroidX para obtener más información sobre estas configuraciones.

Integración manual

Descarga el SDK de AdColony para Android, extrae el adcolony.jar de la carpeta Library y agrégalo a tu proyecto.
El SDK de AdColony depende de la biblioteca de compatibilidad con anotaciones. Consulta Cómo mejorar la inspección de código con anotaciones para obtener información detallada sobre cómo agregar la biblioteca de compatibilidad de anotaciones a tu proyecto.
Navega a los artefactos del adaptador AdColony en el repositorio de Maven de Google. Selecciona la versión más reciente, descarga el archivo .aar del adaptador AdColony y agrégalo a tu proyecto.

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

Consentimiento de la UE y GDPR

Según la Política de Consentimiento de Usuarios de la UE de Google, debes asegurarte de que se proporcionen ciertas divulgaciones a los usuarios del Espacio Económico Europeo (EEE) y el consentimiento de estos respecto del uso de datos personales y identificadores de dispositivos. Esta política refleja los requisitos de la Directiva de Privacidad Electrónica y el Reglamento General de Protección de Datos (GDPR) de la UE. Cuando solicites el consentimiento, debes identificar cada red de publicidad en tu cadena de mediación que pueda recopilar, recibir o usar 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.

El adaptador AdColony proporciona el método AdColonyMediationAdapter.getAppOptions() para personalizar los parámetros que se enviarán al SDK de AdColony. Dos métodos relevantes para el GDPR en estas opciones son setPrivacyFrameworkRequired() y setPrivacyConsentString(). En el siguiente código de muestra, se muestra cómo pasar información de consentimiento al adaptador AdColony, que luego se usa en el método de inicialización de AdColony. Estas opciones se deben configurar antes de inicializar el SDK de anuncios de Google para dispositivos móviles a fin de garantizar que se reenvíen correctamente al SDK de AdColony.

Java

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter;
//...

AdColonyAppOptions appOptions = AdColonyMediationAdapter.getAppOptions();
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.GDPR, true);
appOptions.setPrivacyConsentString(AdColonyAppOptions.GDPR, "1");

Kotlin

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter
//...

val appOptions = AdColonyMediationAdapter.getAppOptions()
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.GDPR, true)
appOptions.setPrivacyConsentString(AdColonyAppOptions.GDPR, "1")

Consulta los detalles de implementación del GDPR de AdColony para obtener más detalles sobre los valores que se pueden proporcionar en estos métodos.

Leyes de privacidad estatales de EE.UU.

Las leyes de privacidad estatales de EE.UU. exigen otorgar a los usuarios el derecho a rechazar la "venta" de su "información personal" (según la definición de esos términos en la ley), con un vínculo destacado "No vender mi 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 capacidad de habilitar el procesamiento de datos restringido para la publicación de anuncios de Google, pero Google no puede aplicar esta configuración a cada red de publicidad de la 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 adaptador AdColony proporciona el método AdColonyMediationAdapter.getAppOptions() para personalizar los parámetros que se enviarán al SDK de AdColony. setPrivacyFrameworkRequired() y setPrivacyConsentString() son dos métodos relevantes para la CCPA en estas opciones. En el siguiente código de muestra, se muestra cómo pasar información de consentimiento al adaptador AdColony, que luego se usa en el método de inicialización de AdColony. Estas opciones se deben configurar antes de inicializar el SDK de anuncios de Google para dispositivos móviles a fin de garantizar que se reenvíen correctamente al SDK de AdColony.

Java

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter;
//...

AdColonyAppOptions appOptions = AdColonyMediationAdapter.getAppOptions();
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.CCPA, true);
appOptions.setPrivacyConsentString(AdColonyAppOptions.CCPA, "1");

Kotlin

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter
//...

val appOptions = AdColonyMediationAdapter.getAppOptions()
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.CCPA, true)
appOptions.setPrivacyConsentString(AdColonyAppOptions.CCPA, "1")

Consulta los detalles de implementación de la CCPA de AdColony para obtener más información sobre los valores que se pueden proporcionar en estos métodos.

Paso 5: Agrega el código obligatorio

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

Paso 6: Prueba tu implementación

Habilitar anuncios de prueba

Asegúrate de registrar tu dispositivo de prueba en Ad Manager y habilitar el modo de prueba en la AdColony IU.

Cómo verificar los anuncios de prueba

Para verificar que recibes anuncios de prueba deAdColony, habilita las pruebas de fuentes de anuncios individuales en el inspector de anuncios mediante la AdColony (Bidding) and AdColony (Waterfall) fuente de anuncios.

Pasos opcionales

Permisos

Para obtener un rendimiento óptimo, AdColony recomienda agregar los siguientes permisos opcionales al archivo AndroidManifest.xml de tu app:

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.VIBRATE" />

Cómo usar anuncios intersticiales y recompensados

Parámetros específicos de la red

El adaptador AdColony admite parámetros de solicitud adicionales que se pueden pasar al adaptador a través de la clase AdColonyBundleBuilder. AdColonyBundleBuilder incluye los siguientes métodos:

setShowPrePopup(boolean): Establece si se muestra o no una ventana emergente antes de mostrar un anuncio. Se establece como falsa para que no se muestre ninguna ventana emergente antes de que se muestre el anuncio.
setShowPostPopup(boolean): Establece si se muestra o no una ventana emergente después de mostrar un anuncio. Se establece como falsa para que no se muestre ninguna ventana emergente después de que se muestra el anuncio.

A continuación, se incluye un ejemplo de código de cómo establecer estos parámetros de solicitud de anuncio:

Java

AdColonyBundleBuilder.setShowPrePopup(true);
AdColonyBundleBuilder.setShowPostPopup(true);

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdColonyAdapter.class, AdColonyBundleBuilder.build())
  .build();
rewardedInterstitialAd.loadAd(request);

Kotlin

AdColonyBundleBuilder.setShowPrePopup(true)
AdColonyBundleBuilder.setShowPostPopup(true)

val request = AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdColonyAdapter::class.java, AdColonyBundleBuilder.build())
  .build()
rewardedInterstitialAd.loadAd(request)

Verifica las versiones del adaptador y del SDK

Para registrar las versiones del adaptador y del SDK, usa el siguiente fragmento de código:

AdColonyMediationAdapter adapter = new AdColonyMediationAdapter();
VersionInfo adapterVersion = adapter.getVersionInfo();
VersionInfo sdkVersion = adapter.getSDKVersionInfo();
// Log the adapter patch version to 3 digits to represent the x.x.x.x versioning
// used by adapters.
Log.d("TAG", String.format(
    "Adapter version: %d.%d.%03d",
    adapterVersion.getMajorVersion(),
    adapterVersion.getMinorVersion(),
    adapterVersion.getMicroVersion()));
Log.d("TAG", String.format(
    "SDK version: %d.%d.%d",
    sdkVersion.getMajorVersion(),
    sdkVersion.getMinorVersion(),
    sdkVersion.getMicroVersion()));

Códigos de error

Si el adaptador no recibe un anuncio de AdColony, los publicadores pueden verificar el error subyacente de la respuesta del anuncio mediante ResponseInfo.getAdapterResponse() en las siguientes clases:

com.jirbo.adcolony.AdColonyAdapter
com.google.ads.mediation.adcolony.AdColonyMediationAdapter

Estos son los códigos y los mensajes correspondientes que arroja el adaptador AdColony cuando un anuncio no se carga:

Código de error	Motivo
100	El SDK de AdColony mostró un error.
101	Los parámetros del servidor no son válidos (p.ej., falta el ID de zona).
102	Ya se solicitó un anuncio para el mismo ID de zona.
103	El SDK de AdColony mostró un error de inicialización.
104	El tamaño de banner solicitado no se asigna a un tamaño de anuncio de AdColony válido.
105	Error de presentación debido a que no se cargó el anuncio.
106	El contexto que se usó para inicializar el SDK de AdColony no fue una instancia de `Activity`.
0 - 3	El SDK de AdColony mostró un error. Consulta la documentación para obtener más detalles.
101	Los parámetros del servidor no son válidos (p.ej., falta el ID de zona).
102	El controlador de vista raíz que presenta el anuncio es `nil`.
103	El SDK de AdColony mostró un error de inicialización.
104	El SDK de AdColony no admite la configuración dos veces en un período de cinco segundos.
105	No se pudo mostrar el anuncio.
106	La zona que se usa para la recompensa no es una zona de recompensas en el portal AdColony.

Registro de cambios del adaptador de mediación de Android de AdColony