Configuración de Tapjoy
Tapjoy es una red de publicidad integrada con Adjust. Nuestra integración permite que Tapjoy reciba los datos de atribución y eventos in-app por medio de callbacks automatizados.
En este artículo, puedes obtener información sobre cómo configurar la medición con Tapjoy para tu aplicación. Esto incluye la activación de la integración, la creación de un link de campaña y la elección de los datos que Adjust puede enviar a Tapjoy.
Antes de comenzar
Requisitos
- Permisos de administrador, editor o editor personalizado en Adjust.
- Versión 4.0.0 o posterior del SDK de Adjust para asignar los parámetros de SDK a los parámetros de Tapjoy. Sigue las guías disponibles en los siguientes links para utilizar esta función.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Credenciales
APP ID
- Si necesitas ayuda para encontrar tus credenciales, comunícate con tu representante de Tapjoy.
Selecciona Tapjoy y la aplicación en Campaign Lab
- En la sección Campaign Lab, selecciona Socios.
- Selecciona Nuevo socio > Tapjoy. Selecciona Siguiente para pasar a la siguiente pantalla.
- En la pantalla Selección de aplicación, elige la aplicación para la que desees crear el link y habilita la integración a fin de enviar los datos a Tapjoy.
- Selecciona Siguiente.
Habilitar el uso compartido de datos
Habilita el uso compartido de datos para activar la integración con Tapjoy. Sigue estos pasos para habilitar el uso compartido de datos:
- Escribe tus APP ID.
Cuando habilites el envío de datos a Tapjoy, nuestro sistema enviará automáticamente los siguientes datos a Tapjoy de forma predeterminada:
- install
- session
- event
- rejectedInstall
- ad revenue
Configura tus opciones de envío de datos
Si trabajas con una aplicación multiplataforma que tiene habilitado el uso compartido de datos para varias plataformas, puedes hacer lo siguiente:
- Separar las opciones de uso compartido de datos a nivel de plataforma seleccionando Utilizar configuración específica para la plataforma.
- Utilizar las mismas opciones de uso compartido de datos para varias plataformas seleccionando Usar configuración global.
En el apartado ¿Qué se enviará de forma predeterminada?, revisa las actividades que nuestro sistema enviará a Tapjoy de forma predeterminada.
- install
- session
- event
- rejectedInstall
- ad revenue
Enviar datos adicionales
Elige la cantidad y el tipo de datos que desees compartir con Tapjoy por medio de callbacks. Tapjoy puede utilizar esta información para optimizar rendimiento.
- En el apartado ¿Qué fuentes de datos deseas compartir?, elige la fuente de atribución de los datos que desees compartir con Tapjoy:
- Datos de todas las fuentes de atribución
- Únicamente los datos atribuidos a Tapjoy
Ingresos publicitarios (de visualizaciones de anuncios)
El envío de ingresos publicitarios permite que Tapjoy reciba los datos de ingresos publicitarios de los usuarios. Esto permite que Tapjoy utilice los datos de ingresos publicitarios para optimizar tu targeting de usuarios y tus campañas.
Esta función está disponible con el paquete de ingresos publicitarios de Adjust. Para comprar nuestro paquete de ingresos publicitarios, comunícate con tu representante de ventas.
Para enviar los ingresos publicitarios a Tapjoy, selecciona una o más fuentes de ingresos publicitarios.
- Si dejas este campo vacío, enviaremos los datos de ingresos publicitarios de todas las fuentes de mediación integradas.
Sesiones
Adjust no envía automáticamente los callbacks de sesión debido al alto volumen de sesiones. Si envías las sesiones, Tapjoy recibirá la actividad de sesiones de tu aplicación.
Ingresos in-app (de compras in-app)
El envío de ingresos in-app permite que Tapjoy reciba los montos de los ingresos junto con tus datos de eventos de ingresos. Debes mapear eventos que generen ingresos para enviar estos datos.
Mapear eventos
Asigna los eventos que desees compartir a los valores que Tapjoy pueda recibir. Los datos de los eventos que no estén mapeados no se compartirán con Tapjoy.
Cómo mapear los eventos individuales
Si tienes una aplicación multiplataforma, puedes compartir diferentes eventos por plataforma con Tapjoy. Esto te permite hacer lo siguiente:
- Configurar eventos individuales para administrar las estrategias de tus campañas en cada plataforma.
- Personalizar el uso compartido de datos por plataforma.
En la sección Mapear eventos, sigue estos pasos para elegir los eventos in-app que desees enviar directamente a Tapjoy.
Selecciona Mapear evento.
En la lista de eventos de Adjust, elige el evento de Adjust que desees compartir con Tapjoy.
En la opción Evento de socio, debes seleccionar el evento de Tapjoy que corresponda con el evento de Adjust.
En el caso de las aplicaciones de una sola plataforma y las aplicaciones multiplataforma que tienen habilitado el uso compartido de datos para una sola plataforma, únicamente debes mapear los eventos para esa plataforma. En el caso de las aplicaciones multiplataforma que tienen habilitado el uso compartido de datos para varias plataformas, puedes hacer lo siguiente:
- Selecciona Utilizar mapeo específico para la plataforma si deseas mapear eventos independientes a nivel de plataforma, o si no deseas mapear ningún evento para determinadas plataformas.
- Selecciona Utilizar mapeo global si deseas mapear los mismos eventos para todas las plataformas.
En la lista de eventos de socio, elige o escribe el nombre del evento personalizado al que desees asignar el evento de Adjust.
Selecciona Aplicar.
Al hacer esto, Tapjoy recibirá los datos de eventos in-app de todos tus eventos vinculados.
Mapear todos los eventos
Si Tapjoy admite el mapeo automático de todos los eventos, en la opción Mapear eventos selecciona Mapear todos los eventos. Esto te permite ahorrar tiempo al no tener que mapear los eventos de forma individual.
Cuando hagas esto, Tapjoy recibirá los datos de eventos in-app de todos tus eventos vinculados.
Mapear parámetros
Por lo general, debes mapear parámetros para enviar datos personalizados a Tapjoy.
Los parámetros de socios (disponibles a partir de la versión 4.0 del SDK de Adjust) permiten que Adjust recopile puntos de datos personalizados de tu aplicación y los envíe directamente hacia Tapjoy. Esto permite que Tapjoy reciba los detalles de eventos personalizados de todos tus eventos vinculados.
Antes de agregar nuevos parámetros de socios al SDK de Adjust, asegúrate de que no haya ningún parámetro de socio preexistente que cumpla con tus requisitos.
Para enviar los parámetros de socios a Tapjoy, sigue estos pasos.
Configura los parámetros de socios en el SDK de Adjust.
- En la sección Antes de comenzar puedes encontrar los links de todas las plataformas de desarrollo de SDK.
En la sección Configura tus opciones de envío de datos, selecciona Parámetros.
En la sección Mapear parámetros, puedes especificar cómo deseas enviar a la red los parámetros de socios definidos en el SDK:
- Selecciona Mapear parámetro.
- En el campo Parámetro de SDK, escribe el nombre del parámetro del SDK que desees compartir con la red.
- En el campo Parámetro de socio, escribe el parámetro de la red que corresponda con el parámetro del SDK.
Si configuras los parámetros de socios en el SDK de Adjust sin configurar el uso compartido de parámetros en el Dashboard, nuestro sistema reenviará los parámetros con el nombre que tengan en el SDK de Adjust.
Configura tu link y tus ajustes
Tienes la opción de configurar lo siguiente:
Cómo crear tu link y compartirlo con Tapjoy
En la sección Revisión de la configuración , puedes revisar tus opciones. También puedes regresar y hacer cambios en los siguientes elementos:
- La aplicación que seleccionaste
- Opciones de uso compartido de datos
- Parámetros de estructura de links
- Destinos de los usuarios
- Configuración de la atribución
Selecciona Crear link para crear tu URL de clic, URL de impresión, código QR y token del link. Cuando creas un link, también se habilita el envío de datos y la integración con Tapjoy.
Después de crear el link, compártelo con Tapjoy para que se coloque en las campañas.
Instrucciones de configuración específicas para los socios
Si deseas enviar únicamente el tráfico atribuido hacia Tapjoy, activa el interruptor correspondiente. Nota: este indicador aplica para todas las actividades enviadas hacia Tapjoy.
Nota: el ID de la aplicación de Tapjoy y los ID de engagement de los nombres de eventos deben tener el siguiente formato:
- 8 caracteres seguidos por un guión, seguidos por tres conjuntos de 4 caracteres delimitados por un guión, seguidos por los últimos 12 caracteres.
- Todos los caracteres deben estar en formato hexadecimal. Por ejemplo: c8196876-64ef-4fab-bed6-c9306fe35b05
Nota: Adjust no envía ningún callback hacia Tapjoy cuando el IDFA está vacío, lo que principalmente se refiere a los usuarios LAT de iOS cuyo IDFA está compuesto exclusivamente por ceros.
Lista de todos los parámetros reenviados a Tapjoy
Tapjoy requiere que Adjust envíe los siguientes parámetros (data points) con tus callbacks:
Placeholder | Information |
{adid} | Adjust device ID (all platforms) |
{android_id} | Android ID (Android only) |
{click_attribution_window} | Attribution window settings for device matching (hours) |
{country} | Device two-character country code |
{currency} | Original ISO 4217 currency code sent from Adjust SDK |
{device_name} | Device model number |
{device_type} | Device type |
{idfa||gps_adid} | IDFA, or GPS ADID if IDFA is empty |
{impression_attribution_window} | Attribution window settings for impression matching (hours) |
{ip_address} | Device IP address |
{label} | Value of the Adjust "label" parameter sent on click |
{language} | Device two-character language code |
{mac_sha1} | Uppercase MAC SHA-1 hash |
{match_type} | Attribution method |
{mcc} | Mobile country code: three-digit code identifying a device's country. Use with the mobile network code to identify a device's carrier. |
{mnc} | Mobile network code: two-digit code. Use with the mobile country code to identify a device's carrier. |
{os_name} | Device operating system |
{os_version} | Operating system version number |
{partner_parameters} | Custom partner parameters collected by the Adjust SDK or S2S request and transmitted to third party providers via postbacks |
{revenue} | Revenue, as sent from Adjust SDK in cents |
{sdk_version} | Adjust SDK version (per app) |
{timezone} | Device time zone |
{tracking_limited} | 1 if tracking is limited, 0 if not |
{user_agent} | Incoming raw user agent |
{activity_kind} | Type of user activity |
{app_id} | Store App ID or Google Play Store |
{app_name} | Name of the app |
{app_version_short} | App version number (Android), release-version-number for the bundle (iOS) |
{app_version} | App version number (Android), build-version-number for the bundle (iOS) |
{click_time} | Attributed click timestamp |
{connection_type} | Internet connection type |
{cpu_type} | CPU type |
{created_at} | Activity timestamp |
{hardware_name} | Hardware name |
{impression_based} | 1 if impression-based engagement, 0 if not |
{install_begin_time} | App download began timestamp (Android and Google Play Store only) |
{install_finish_time} | App download completion timestamp |
{referral_time} | User landed on app Play Store page timestamp (Android and Google Play Store only) |
{rejection_reason} | Reason for a rejected attribution |
{ad_revenue_network} | Ad network that displayed the ad |
{ad_revenue_unit} | Ad unit that generated the revenue |
{ad_revenue_payload} | Impression-level revenue data (ILRD) as a JSON |