Configuración de OneSignal
OneSignal es un socio de analytics integrado con Adjust. Nuestra integración permite que OneSignal reciba los datos medidos en Adjust por medio de callbacks automatizados. Puedes utilizar estos datos junto con las herramientas de los socios para fines analíticos.
En este artículo, puedes obtener información sobre cómo configurar la medición con OneSignal para tu aplicación. Esto incluye la activación de la integración y la elección de los datos que Adjust puede enviar a OneSignal.
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 OneSignal. 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
OneSignal App ID
- Si necesitas ayuda para encontrar tus credenciales, comunícate con tu representante de OneSignal.
Selecciona OneSignal y la aplicación en Campaign Lab
- En la sección Campaign Lab, selecciona Socios.
- Selecciona Nuevo socio > OneSignal. 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 OneSignal.
- Selecciona Siguiente.
Habilita el uso compartido de datos
Habilita el uso compartido de datos para activar la integración con OneSignal. Sigue estos pasos para habilitar el uso compartido de datos:
- Escribe tus OneSignal App ID.
Cuando habilites el envío de datos a OneSignal, nuestro sistema enviará automáticamente los siguientes datos a OneSignal de forma predeterminada:
- Instalación
- Sesión
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 OneSignal de forma predeterminada:
- Instalación
- Sesión
Envía datos adicionales
Elige la cantidad y el tipo de datos que desees compartir con OneSignal por medio de callbacks. OneSignal puede utilizar esta información para optimizar rendimiento.
Para enviar datos adicionales, puedes revisar y personalizar las siguientes opciones:
Sesiones
Adjust no envía automáticamente los callbacks de sesión debido al alto volumen de sesiones. Si envías las sesiones, OneSignal 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 OneSignal reciba los montos de los ingresos junto con tus datos de eventos de ingresos. Debes mapear eventos que generen ingresos para enviar estos datos.
Mapea eventos
Asigna los eventos que desees compartir a los valores que OneSignal pueda recibir. Los datos de los eventos que no estén mapeados no se compartirán con OneSignal.
Cómo mapear los eventos individuales
Si tienes una aplicación multiplataforma, puedes compartir diferentes eventos por plataforma con OneSignal. 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 OneSignal.
Selecciona Mapear evento.
En la lista de eventos de Adjust, elige el evento de Adjust que desees compartir con OneSignal.
En la opción Evento de socio, debes seleccionar el evento de OneSignal 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, OneSignal recibirá los datos de eventos in-app de todos tus eventos vinculados.
Mapear todos los eventos
Si OneSignal 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, OneSignal recibirá los datos de eventos in-app de todos tus eventos vinculados.
Habilita a OneSignal para tu aplicación
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
Selecciona Habilitar socio a fin de habilitar a OneSignal para tu aplicación. Los socios de analytics no utilizan links para las campañas. Cuando lo habilites, nuestra integración enviará los datos de atribución y eventos in-app por medio de callbacks automatizados.
Instrucciones de configuración específicas para los socios
Debes implementar tokens push en tu SDK de Adjust para que se realice correctamente el tracking de las solicitudes en el panel de OneSignal.
Si deseas más información, revisa las guías del SDK de Adjust: Android, iOS
Lista de todos los parámetros reenviados a OneSignal
OneSignal requiere que Adjust envíe los siguientes parámetros (data points) con tus callbacks:
| Placeholder | Información |
{adid} | ID del dispositivo de Adjust (todas las plataformas) |
{country} | Código de país de dos caracteres del dispositivo |
{currency} | Código ISO 4217 de la moneda original enviado desde el SDK de Adjust |
{event_name} | Nombre del evento, como se configuró en el Dashboard |
{idfa||gps_adid} | IDFA, o GPS ADID, si el IDFA está vacío |
{ip_address} | Dirección IP del dispositivo |
{language} | Código de idioma de dos caracteres del dispositivo |
{last_time_spent} | Duración de la última sesión del usuario, en segundos |
{os_version} | Número de versión del sistema operativo |
{push_token} | Token de notificación push, es decir, token de registro (Android), token de dispositivo (iOS) |
{revenue_float} | Ingresos, como se enviaron desde el SDK de Adjust, en unidades de moneda enteras |
{session_count} | Número de sesiones registradas por la versión actual del SDK de Adjust |
{app_version} | Número de versión de la aplicación (Android), número de versión del paquete (iOS) |
{campaign_name} | Nombre de la campaña como aparece en el tracker |
{created_at} | Marca de tiempo de la actividad |
{installed_at} | Marca de tiempo de la instalación (es decir, la primera vez que se abre la aplicación) |
{last_session_time} | Marca de tiempo de la última sesión |
{network_name} | Nombre de la red como aparece en el tracker |