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

Cómo integrar Tapjoy con Mediación

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

Integraciones y formatos de anuncios admitidos

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

Integración
Ofertas
Cascada
Formatos
Banner
Intersticial
Recompensado
Nativo

Requisitos

Objetivo de implementación de iOS 12.0 o posterior
[Para ofertas]: Adaptador Tapjoy 12.3.1.0 o una versión posterior (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 parámetros de configuración en la IU de Tapjoy

Regístrate o accede a tu panel de Tapjoy.

Agregar app

Para agregar tu app al panel de Tapjoy, ve a la lista de apps en la parte superior derecha y haz clic en el botón Agregar app. Luego, se te solicitará que ingreses los detalles de tu app.

Completa el formulario y haz clic en el botón Crear ahora para agregar tu app al panel de Tapjoy.

Puedes omitir los pasos de integración presentados por Tapjoy y continuar con la creación de posiciones para usar con la Ad Manager mediación.

Posición, moneda virtual y contenido

Posición

Ve a Monetización > Posiciones y haz clic en el botón Crear posición en la esquina superior derecha. Incluso si ya tienes una posición, es mejor crear una nueva para Ad Manager , de modo que se pueda realizar un seguimiento de esta y generar informes sobre ella por separado.

Ingresa un Nombre para tu posición, marca la casilla de verificación Mediación y selecciona AdMob en la lista desplegable. Cuando termines, haz clic en Create (Crear).

El Nombre de la posición que ingresas aquí se usa a fin de configurar tuAd Manager Unidad de anuncios para la mediación en la siguiente sección. En este ejemplo, se utilizó "Ad Manager Mediación", pero puedes asignar el nombre que desees a tu posición.

Moneda virtual

Navega a Monetización > Moneda virtual y haz clic en el botón Crear moneda virtual en la esquina superior derecha.

Completa el formulario y haz clic en Crear ahora. Usa NO_CALLBACK como URL de devolución de llamada. De esta manera, se garantiza que el SDK de Tapjoy evite una llamada innecesaria a tu servidor.

El adaptador de Tapjoy no reenvía el valor ni el nombre de la moneda, por lo que puedes elegir cualquier valor genérico para el nombre y el importe de tu moneda.

Contenido

Navega a Monetización > Crear contenido para crear contenido que se mostrará con las posiciones.

Para obtener más instrucciones sobre cómo crear contenido, selecciona la pestaña correspondiente a tu formato de anuncio preferido:

Ofertas

Intersticial

Haz clic en el botón Crear para el contenido de Video intersticial programático.

Proporciona un Nombre para el contenido y elige tu Plataforma.

Selecciona la moneda virtual creada anteriormente como Virtual Currency.

Selecciona la posición de anuncio intersticial que creaste anteriormente. Cuando termines de crear el contenido, haz clic en el botón Guardar en la parte inferior.

Recompensado

Haz clic en el botón Crear en el contenido de Video recompensado programático.

Selecciona la moneda virtual que creaste antes como Virtual Currency.

Selecciona la posición de recompensa creada anteriormente. Cuando termines de crear el contenido, haz clic en el botón Save que se encuentra en la parte inferior.

Cascada

Intersticial

Haz clic en el botón Crear para el contenido de Video intersticial.

Proporciona un Nombre para el contenido y elige tu Plataforma.

Selecciona la moneda virtual creada anteriormente como Virtual Currency.

Selecciona la posición de anuncio intersticial que creaste anteriormente. Cuando termines de crear el contenido, haz clic en el botón Guardar en la parte inferior.

Recompensado

Haz clic en el botón Crear para el contenido de Video recompensado.

Proporciona un Nombre para el contenido y elige tu Plataforma.

Selecciona la moneda virtual creada anteriormente como Virtual Currency.

Selecciona la posición de recompensa creada anteriormente. Cuando termines de crear el contenido, haz clic en el botón Save que se encuentra en la parte inferior.

Ubica la clave del SDK

Además del nombre de la posición, también necesitas la clave del SDK para configurar tu Ad Manager unidad de anuncios.

Ve a Configuración > Configuración de la app. Puedes obtener la clave del SDK en la Información de tu app, en la pestaña Plataformas de aplicaciones.

Ubica las claves de informes

Ofertas

Este paso no es obligatorio para las integraciones de ofertas.

Cascada

Necesitas tu clave OAuth de publicador y tu clave de mediación para continuar. Puedes obtener tu clave OAuth de publicador en la misma página, en la pestaña Claves de API.

Puedes obtener tu clave de mediación en la misma página, en la pestaña Claves de mediación de la columna Clave de API de informes. La clave está etiquetada como “AdMob”.

Activar el modo de prueba

Los anuncios de prueba se pueden habilitar en el panel de Tapjoy, en Configuración > Configuración de la app > Dispositivos de prueba. Crea un dispositivo de prueba nuevo con el ID de publicidad del dispositivo:

Para obtener el ID de publicidad del dispositivo, agrega el siguiente código a tu app. Asegúrate de importar el framework de AdSupport a la app antes de usar el código que aparece a continuación.

Swift

  let advertisingId: String = ASIdentifierManager.shared().advertisingIdentifier.uuidString
  print("Advertising ID: \(advertisingId)")

Objective‑C

  NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
  NSLog(@"Advertising ID: %@", advertisingId);

A continuación, modifica el contenido que creaste anteriormente.

Para modificar tu contenido, primero navega a Monetización > Posiciones y haz clic en la pestaña User Initiated. Luego, selecciona el menú desplegable para el contenido que deseas editar y elige Editar.

En la sección Básico del contenido, marca la casilla de verificación Solo para dispositivos de prueba. Luego, haz clic en Guardar en la parte inferior de la página. Listo. Ahora tienes una integración de mediación activa con Tapjoy.

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

Accede a tu cuenta de Ad Manager.

Agregar Tapjoy 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 Tapjoy como la Red de publicidad, ingresa un Nombre único y habilita la Mediación.

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 Tapjoy ofertas

Ofertas

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

Selecciona Tapjoy 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 deTapjoy 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 losSDK Key and Placement Name 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 Tapjoy en la sección anterior. Elige Mediación del SDK para dispositivos móviles como el Tipo de integración, iOS como la Plataforma y Activo como el Estado.

Ingresa el SDK Key and Placement Name obtenido en la sección anterior y el valor de CPM predeterminado. Haz clic en Guardar.

Agregar Tapjoy 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 Tapjoy 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 Tapjoy

Usa CocoaPods (recomendado)

Agrega la siguiente línea al Podfile de tu proyecto:
```
pod 'GoogleMobileAdsMediationTapjoy'
```
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 Tapjoy y vincula Tapjoy.embeddedframework en tu proyecto.
Descarga la versión más reciente del adaptador de Tapjoy desde el vínculo de descarga en el registro de cambios y vincula TapjoyAdapter.framework en tu proyecto.

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

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.

En la versión 12.6.0 del SDK de Tapjoy, Tapjoy agregó una API de consentimiento del usuario para admitir la configuración de privacidad. En el siguiente código de muestra, se indica cómo pasar esta información de consentimiento al SDK de Tapjoy. Si decides llamar a este método, te recomendamos que lo hagas antes de solicitar anuncios a través del SDK de anuncios de Google para dispositivos móviles.

Swift

import Tapjoy
...

let privacyPolicy = TJPrivacyPolicy()
privacyPolicy.setSubjectToGDPR(true)
privacyPolicy.setUserConsent("0")

Objective‑C

#import <Tapjoy/Tapjoy.h>
...

TJPrivacyPolicy *privacyPolicy = [Tapjoy getPrivacyPolicy];
[privacyPolicy setSubjectToGDPR: YES];
[privacyPolicy setUserConsent: @"0"];

Consulta la Guía de privacidad del usuario de Tapjoy para obtener más detalles y los valores que se pueden proporcionar en cada método.

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.

Swift

import Tapjoy
...

let privacyPolicy = TJPrivacyPolicy()
privacyPolicy.setUSPrivacy("1YYY")

Objective‑C

#import <Tapjoy/Tapjoy.h>
...

TJPrivacyPolicy *privacyPolicy = [Tapjoy getPrivacyPolicy];
[privacyPolicy setUSPrivacy: @"1YYY"];

Consulta la Guía de privacidad del usuario de Tapjoy para obtener más detalles y los valores que se pueden proporcionar en cada método.

Paso 5: Agrega el código obligatorio

Integración de SKAdNetwork

Sigue la documentación de Tapjoy 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 Ad Manager y habilitar el modo de prueba en la Tapjoy IU.

Cómo verificar los anuncios de prueba

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

Pasos opcionales

Agregar Tapjoy a la lista de socios publicitarios de la CCPA

Sigue los pasos que se indican en la Configuración de la CCPA para agregar Tapjoy a la lista de socios publicitarios de la CCPA en la Ad Manager IU.

Parámetros específicos de la red

El adaptador de Tapjoy admite parámetros de solicitud adicionales que se pueden pasar al adaptador mediante la clase GADMTapjoyExtras. Esta clase incluye la siguiente propiedad:

debugEnabled: Configúralo como YES para habilitar el registro en el SDK de Tapjoy para el modo de depuración.

A continuación, se incluye un ejemplo de código de cómo establecer este parámetro en una solicitud de anuncio:

Swift

let request = GAMRequest()
let extras = GADMTapjoyExtras()
extras.debugEnabled = true
request.register(extras)

Objective‑C

GAMRequest *request = [GAMRequest request];
GADMTapjoyExtras *extras = [[GADMTapjoyExtras alloc] init];
extras.debugEnabled = YES;
[request registerAdNetworkExtras:extras];

Verifica las versiones del adaptador y del SDK

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

Class<GADMediationAdapter> adapterClass = NSClassFromString(@"GADMediationAdapterTapjoy");
if (adapterClass != nil) {
  GADVersionNumber adapterVersion = [adapterClass version];
  GADVersionNumber sdkVersion = [adapterClass adSDKVersion];
  NSLog(@"Adapter version: %ld.%ld.%ld.%ld",
        adapterVersion.majorVersion,
        adapterVersion.minorVersion,
        adapterVersion.patchVersion / 100,
        adapterVersion.patchVersion % 100);
  NSLog(@"SDK version: %ld.%ld.%ld",
        sdkVersion.majorVersion,
        sdkVersion.minorVersion,
        sdkVersion.patchVersion);
}

No es posible registrar la versión del adaptador en Swift, ya que la función del entorno de ejecución dinámico no existe en Swift, por lo que es inviable crear la clase de forma dinámica a partir del nombre de la clase. Si esto es necesario en Swift, debes escribirlo primero en Objective-C y, luego, importarlo con un encabezado puente.

Códigos de error

Si el adaptador no recibe un anuncio de Tapjoy, puedes verificar el error subyacente de la respuesta del anuncio mediante GADResponseInfo.adNetworkInfoArray en las siguientes clases:

Formato	Nombre de clase
Intersticial	GADMAdapterTapjoy
Recompensado	GADMAdapterTapjoy

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

Código de error	Motivo
101	Faltan los parámetros del servidor de Tapjoy configurados en la Ad Manager IU o no son válidos.
103	El publicador debe solicitar anuncios con un contexto de `Activity`.
104	No se pudo inicializar el SDK de Tapjoy.
105	Se produjo un error en la presentación de Tapjoy durante la reproducción del video.
106	El SDK de Tapjoy no puede cargar dos anuncios para el mismo ID de posición a la vez.
107	La app no solicitó anuncios nativos.
108	El SDK de Tapjoy no tiene contenido de anuncios disponible.
101	Faltan los parámetros del servidor de Tapjoy configurados en la Ad Manager IU o no son válidos.
102	No se pudo inicializar el SDK de Tapjoy.
103	El adaptador de Tapjoy no admite el formato de anuncio que se solicita.
104	Tapjoy envió una devolución de llamada de carga exitosa, pero no había contenido disponible.
105	Ya se cargó un anuncio para esta configuración de red.
106	El SDK de Tapjoy mostró una devolución de llamada de error de falla de video.

Registro de cambios del adaptador de mediación de iOS de Tapjoy