Configuración de Piano Analytics

Piano Analytics es un socio de analytics integrado con Adjust. Nuestra integración permite que Piano Analytics 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 Piano Analytics 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 Piano Analytics.

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 Piano Analytics. 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

Collection Domain y Site ID

• Si necesitas ayuda para encontrar tus credenciales, comunícate con tu representante de Piano Analytics.

En tu panel de Piano Analytics:

Antes de habilitar la integración con Piano Analytics, debes crear los siguientes eventos en la interfaz de usuario de Piano Analytics, con los nombres escritos exactamente como aparecen a continuación, para asegurarte de que tus datos se agreguen correctamente a los informes:

• adjust.installs
• adjust.uninstalls
• adjust.reinstalls
• adjust.reattributions

Puedes encontrar las instrucciones para crear estos eventos en Piano Analytics aquí.

Selecciona Piano Analytics y la aplicación en Campaign Lab

1. En la sección Campaign Lab, selecciona Socios.
2. Selecciona Nuevo socio > Piano Analytics. Selecciona Siguiente para pasar a la siguiente pantalla.
3. 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 Piano Analytics.
4. Selecciona Siguiente.

Habilita el uso compartido de datos

Habilita el uso compartido de datos para activar la integración con Piano Analytics. Sigue estos pasos para habilitar el uso compartido de datos:

1. Escribe tus Collection Domain y Site ID.

Cuando habilites el envío de datos a Piano Analytics, nuestro sistema enviará automáticamente los siguientes datos a Piano Analytics de forma predeterminada:

• instalación
• desinstalación
• reinstalación
• reatribució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:

1. Separar las opciones de uso compartido de datos a nivel de plataforma seleccionando Utilizar configuración específica para la plataforma.
2. 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 Piano Analytics de forma predeterminada:

• instalación
• desinstalación
• reinstalación
• reatribución

Envía datos adicionales

Elige la cantidad y el tipo de datos que desees compartir con Piano Analytics por medio de callbacks. Piano Analytics puede utilizar esta información para optimizar rendimiento.

Para enviar datos adicionales, puedes revisar y personalizar las siguientes opciones:

Desinstalaciones o reinstalaciones

El envío de las desinstalaciones o reinstalaciones permite que Piano Analytics reciba los datos de desinstalaciones y/o reinstalaciones de tu aplicación medidos por Adjust.

Mapea parámetros

Por lo general, debes mapear parámetros para enviar datos personalizados a Piano Analytics.

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 Piano Analytics. Esto permite que Piano Analytics 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 Piano Analytics, sigue estos pasos.

1. 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.

2. En la sección Configura tus opciones de envío de datos, selecciona Parámetros.

3. 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:

   1. Selecciona Mapear parámetro.
   2. En el campo Parámetro de SDK, escribe el nombre del parámetro del SDK que desees compartir con la red.
   3. En el campo Parámetro de socio, escribe el parámetro de la red que corresponda con el parámetro del SDK.

Habilita a Piano Analytics 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 Piano Analytics 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

Piano Analytics requiere su ID de visitante para vincular la instalación inicial con los eventos in-app subsecuentes. Para lograrlo, deberás enviar el ID de visitante de Piano Analytics como parámetro de socio global de SDK con el nombre PAVisitorId (escrito exactamente de esta manera). Si deseas obtener más información sobre cómo adjuntar los parámetros de socios globales, consulta nuestra documentación:

• iOS
• Android
• Unity
• React Native
• Flutter
• Cordova
• Cocos2d-x

Este es un ejemplo del código que se debe implementar para Android:

const PAVisitorId = pa.getVisitorId();

Adjust.addGlobalPartnerParameter("PAVisitorId", PAVisitorId);

Lista de todos los parámetros reenviados a Piano Analytics

Piano Analytics requiere que Adjust envíe los siguientes parámetros (data points) con tus callbacks: