Implementar Mixpanel

Implementar Mixpanel

Mixpanel mantiene SDKs para una fácil implementación en distintas plataformas. Utiliza la API de ingestión si no hay un SDK que admita tu caso de uso.

Sigue las páginas de integración para implementar Mixpanel programáticamente con un SDK. Además del seguimiento de eventos, las páginas de integración cubren las dependencias de Mixpanel como la gestión de identidades, la implementación de grupos, etc.

Usa la especificación HTTP para implementaciones que no usan un SDK. Esto incluye implementaciones del lado del servidor que no tienen una biblioteca y pueden adaptarse a la implementación en cualquier dispositivo con conexión de red.

Plan de seguimiento

Es importante crear un plan de seguimiento antes de implementar Mixpanel. Un plan de seguimiento conecta la implementación de Mixpanel con objetivos e indicadores de rendimiento, lo que optimizará el caso de uso de Mixpanel.

Tu plan de seguimiento sirve como un mapa para implementar Mixpanel y como referencia para garantizar que se recopilen eventos y propiedades importantes. También guía el proceso de desarrollo.

Ver ejemplos de planes de seguimiento en el Centro de ayuda para obtener más detalles. (Nota: los documentos están en inglés)

SDK de Mixpanel

Mixpanel ofrece una variedad de bibliotecas del lado del cliente y del lado del servidor. El cliente se refiere al navegador o la aplicación con la que interactúan los usuarios finales. El servidor aloja la información que muestra el navegador o la aplicación del usuario final. Este artículo explicará las diferencias entre los SDK del lado del servidor y del lado del cliente para que puedas decidir cómo realizar un seguimiento de cada evento.

Es mejor “trackear” o rastrear  algunos eventos directamente desde el dispositivo del usuario final, como por ejemplo seleccionar “Registrarse”. Otros eventos se rastrean mejor desde tu servidor, como una transacción.

Por ejemplo, puedes tener una implementación híbrida del lado del servidor y del lado del cliente donde los usuarios se registran en un sitio web. El usuario hace clic en registrarse y rellena un formulario, lo que desencadena un evento del lado del cliente. La información que el usuario ha rellenado se envía a tu servidor. Puedes enviar un evento desde tu servidor a Mixpanel para confirmar que el registro se ha completado correctamente.

SDK del lado del cliente

Es mejor realizar un seguimiento de algunos eventos en el SDK del lado del cliente, como las acciones realizadas en páginas web y aplicaciones móviles. La siguiente lista describe algunas de las ventajas del seguimiento del SDK del lado del cliente:

  • Puedes usar superpropiedades para enviar propiedades con cada evento, sin tener que agregarlas manualmente a cada evento.
  • Los SDK del lado del cliente asignan automáticamente una identificación distinta a cualquier usuario que realice un evento en tu sitio web o aplicación.
  • Puedes encontrar una lista de las propiedades predeterminadas en este artículo. Las propiedades predeterminadas te ayudan a realizar un seguimiento de las propiedades importantes con cada evento sin tener que agregarlas manualmente. Por ejemplo, si deseas analizar cómo se comportan tus usuarios premium en comparación con tus usuarios gratuitos, puedes registrar una super-propiedad «Tipo de usuario». Con «Tipo de usuario» como super-propiedad, podrás segmentar y filtrar todos los eventos del lado del cliente mediante la propiedad «Tipo de usuario».

Puedes usar el distinto_id que Mixpanel asigna a cada usuario para ayudar a rastrear usuarios anónimos.

Puedes utilizar los siguientes SDK del lado del cliente con Mixpanel (Nota: los documentos están en inglés):

SDK del lado del servidor

Es mejor realizar el seguimiento de algunos eventos mediante un SDK del lado del servidor. La siguiente lista describe algunas de las ventajas del seguimiento del SDK del lado del servidor:

  • El seguimiento del lado del servidor te permite enviar datos que deseas asociar con tus usuarios a Mixpanel desde tu base de datos, incluidos los datos de ingresos. Para garantizar la precisión de los datos de ingresos, muchos usuarios de Mixpanel eligen enviar estos datos utilizando una de las bibliotecas del lado del servidor.

Puedes utilizar los siguientes SDK del lado del servidor con Mixpanel (Nota: los documentos están en inglés):

Especificación HTTP

El punto final api.mixpanel.com/, o API de ingestión, ingiere eventos, información de usuario e información de grupo. Si envías datos utilizando el formato JSON adecuado, Mixpanel ingiere y muestra esos datos.

La capacidad de ingestión de Mixpanel te permite rastrear eventos en cualquier dispositivo que esté conectado a una red.

Los ejemplos incluyen dispositivos IoT, hardware con una conexión de red (como un dron con capacidades de red), implementaciones del lado del servidor que no tienen un SDK o implementaciones del lado del servidor sobre las que deseas un control más granular.

Consulta la documentación de HTTP Spec para obtener más información.

API de Mixpanel

Mixpanel admite una colección de API que pueden usar la funcionalidad de Mixpanel fuera de la aplicación web.

En la siguiente página podrás ver una descripción general de las API de Mixpanel.

Implementación de Mixpanel en la Unión Europea (UE)

SDK de Android

Específica diferentes puntos finales utilizando etiquetas de metadatos específicas. En el archivo AndroidManifest.xml  de la aplicación, debes agregar las siguientes etiquetas (o tags) bajo la etiqueta <application>. Esto anulará nuestros puntos finales de seguimiento, participación y grupos:

XML

<meta-data android:name=«com.mixpanel.android.MPConfig.EventsEndpoint»

          android:value=«https://api-eu.mixpanel.com/track?ip=1» />

 

<meta-data android:name=«com.mixpanel.android.MPConfig.PeopleEndpoint»

           android:value=«https://api-eu.mixpanel.com/engage?ip=1» />

 

<meta-data android:name=«com.mixpanel.android.MPConfig.GroupsEndpoint»

           android:value=«https://api-eu.mixpanel.com/groups» />

SDK de iOS

Sigue la documentación normal, establece el distinto punto final utilizando la propiedad serverURL después de inicializar el cliente.

Objective-C

Objective-C

self.mixpanel = [Mixpanel sharedInstanceWithToken:@«MIXPANEL_TOKEN» launchOptions:launchOptions];

self.mixpanel.serverURL = @«https://api-eu.mixpanel.com»;

Swift

mixpanel = Mixpanel.initialize(token: «MIXPANEL_TOKEN»)

mixpanel.serverURL = «https://api-eu.mixpanel.com»

 

JavaScript SDK

Sigue la documentación normal, excepto al inicializar el cliente. En lugar de mixpanel.init («YOUR_TOKEN»); utiliza

JavaScript

mixpanel.init(«YOUR_TOKEN», { «api_host»: «https://api-eu.mixpanel.com» });

Node.js

Sigue la documentación normal, excepto al inicializar el cliente. En lugar de mixpanel.init («YOUR_TOKEN»); utiliza

JavaScript

var mixpanel = Mixpanel.init(‘YOUR_TOKEN’, { «host»: «api-eu.mixpanel.com» })

Python

Inicializa la instancia de Mixpanel con un Consumer personalizado

import mixpanel

mixpanel_client = mixpanel.Mixpanel(

  «YOUR_TOKEN»,

  consumer=mixpanel.Consumer(api_host=«api-eu.mixpanel.com»),

)

PHP

Sigue la documentación normal, excepto al inicializar el cliente. En lugar de $ mp = Mixpanel :: getInstance («YOUR TOKEN»), usa

PHP

<?php

// importa las dependencias (usando el autoload de composer)

// si no usas Composer, haz require del archivo lib/Mixpanel.php aquí:

require «vendor/autoload.php»;

// genera la instancia de la clase Mixpanel con el token de tu proyecto

$mp = Mixpanel::getInstance(«YOUR TOKEN», array(«host» => «api-eu.mixpanel.com»));

Capacidad de consulta

Para que el proyecto sea accesible en eu.mixpanel.com y puedas consultar informes, el clúster del proyecto debe configurarse en mixpanel-prod-eu en el lado de Mixpanel. Ponte en contacto con tu RM, CSM o AE y ellos pueden coordinar este cambio.

Una vez que se completa la configuración, el cliente puede iniciar sesión en su cuenta en eu.mixpanel.com. En este punto, estarán presentes todas las funciones básicas de Mixpanel.

Iniciar sesión a través de SSO

Anteponer eu. al comienzo de tu URL de notificación si deseas que el flujo iniciado por IDP dirija al sitio eu.mixpanel.com (por ejemplo, mixpanel.com/security/login/1 se convertiría en eu.mixpanel.com/security/login/1)

Si necesitas que los usuarios puedan elegir su flujo iniciado por IDP, crea una versión con eu. y una versión sin eu. y asigna el correcto al usuario correcto (por ejemplo, en Okta podría crear una aplicación «Mixpanel» y «Mixpanel (EU)»).

¿Tiene preguntas?

Obtenga respuestas a sus preguntas en la comunidad Mixpanel

Hacer una pregunta