RudderStack es una plataforma de datos de clientes (CDP) de código abierto que permite a las empresas recopilar, unificar y enrutar los datos de sus clientes hacia diversos destinos. Ofrece una plataforma centralizada para gestionar los pipelines de datos de clientes, lo que permite a las organizaciones recopilar fácilmente datos de diversas fuentes, como sitios web, aplicaciones móviles, servidores y servicios en la nube.
El SDK de Singular ofrece muchas funciones que no están disponibles a través de las opciones de integración estándar "Device-Mode" o "Cloud-Mode" .
Se recomienda la integración a través de una metodología híbrida cuando se utiliza Rudderstack con Singular, para aprovechar todas las funciones y funcionalidades de Singular.
El enfoque híbrido consiste en:
- Implementar el SDK de Singular de forma independiente de Rudderstack, lo que permite que el SDK de Singular gestione el seguimiento de sesiones, el soporte adicional para SDK Frameworks (React Native, Unity, etc.), SkAdNetwork, deep links y deferred deep links, y funciones avanzadas.
- Habilitar la opción "Cloud-Mode" en Rudderstack para un Singular Destination. Esto permite que todos los eventos de track móviles de Rudderstack se envíen al Destination de Singular.
Las siguientes instrucciones ilustran cómo configurar una implementación híbrida de Singular con Rudderstack.
| Guía para | Equipos de ingeniería |
| Requisitos previos | Este artículo asume que ya tienes el Rudderstack Mobile SDK integrado en tu aplicación. |
Para utilizar esta integración, debes estar usando los Mobile SDKs de Rudderstack.
El SDK de Singular brindará soporte para:
- Atribución de instalación
- Soporte de SkAdNetwork
- Soporte de Google Install Referrer
- Soporte de META Install Referrer
- Atribución de Apple Search Ads
- Seguimiento de eventos in-app personalizados
- Seguimiento de ingresos
- Custom User ID
- Soporte de Global Properties
- Opciones de privacidad
La integración "Cloud-Mode" de Rudderstack brindará soporte para:
- Seguimiento de eventos in-app personalizados
- Seguimiento de ingresos
- Custom User ID
Configuración híbrida
-
Integra el SDK de Singular
Implementa el SDK de Singular de forma independiente de Rudderstack. Consulta las opciones y frameworks del SDK AQUÍ .
-
Habilita el Rudderstack - Singular Destination (Cloud-Mode)
Sigue la guía AQUÍ .
Evita eventos de sesión duplicados: En el enfoque híbrido, el SDK de Singular ya gestiona el seguimiento de sesiones. Al configurar el Rudderstack - Singular Destination (Cloud-Mode), no configures el ajuste de conexión "Session Event Name" y no envíes los eventos de ciclo de vida Application Installed , Application Opened ni Application Updated a Singular a través de Rudderstack. Hacerlo provoca que Rudderstack envíe eventos de sesión en paralelo con el SDK de Singular, lo que resulta en eventos de sesión duplicados en Singular.
Configuración adicional recomendada
Al utilizar una metodología híbrida, se recomienda pasar el AnonymousId de Rudderstack y el User ID de Rudderstack al SDK de Singular.
Presta especial atención y cuidado al implementar estas funciones opcionales de la documentación del SDK. Los pasos pueden variar ligeramente según el framework que estés utilizando.
Implementar Global Properties
Pasa el AnonymousId de Rudderstack a una Global Property de Singular. Esto asociará el AnonymousId de Rudderstack con los datos a nivel de dispositivo del SDK.
Proporcionar este valor a Singular en el objeto Singular Config al momento de la inicialización del SDK de Singular también permitirá que Singular envíe un postback de instalación a Rudderstack cuando el UserId sea desconocido.Singular SOLO puede proporcionar la información de atribución a Rudderstack desde la instalación de la aplicación utilizando el AnonymousId de Rudderstack y/o el valor UserId de Rudderstack. Consulta las Global Properties de Singular [ iOS ][ Android ] como ejemplos de cómo se configura esto.
La Global Property debe configurarse al inicializar el SDK de Singular con la clave: rudderstack_anonymous_id y el valor del anonymousId de Rudderstack obtenido del SDK de Rudderstack. El AnonymousID de Rudderstack se puede obtener del SDK de Rudderstack utilizando este método [iOS] [Android] .[RSClient getInstance].anonymousId;Ejemplo de configuración del SDK de Singular
- (SingularConfig *)getConfig {
// Get the 3rd-party identifiers to set in Global Properties:
// If 3rd-party SDKs are providing any identifiers to Singular, the
// respective SDK must be initialized before Singular.
NSString* thirdPartyKey = @"rudderstack_anonymous_id";
NSString* thirdPartyValue = [RSClient getInstance].anonymousId;
// Singular Config Options
SingularConfig* config = [[SingularConfig alloc]
initWithApiKey:APIKEY andSecret:SECRET];
...
// Using Singular Global Properties feature to capture 3rd-party identifiers
[config setGlobalProperty:thirdPartyKey
withValue:thirdPartyValue overrideExisting:YES];
...
return config;}// (Optional) Get 3rd-party identifiers to set in Global Properties:
// If 3rd-party SDKs are providing any identifiers to Singular, the
// respective SDK must be initialized before Singular.
String thirdPartyKey = new String("rudderstack_anonymous_id");
String thirdPartyValue = new String(RudderClient.getInstance()?.anonymousId);
// Singular Config Options
SingularConfig config = new SingularConfig("SDK KEY", "SDK SECRET")
.withGlobalProperty(thirdPartyKey, thirdPartyValue, true);Implementar Custom User ID
Pasa el UserId de Rudderstack al método Custom User ID de Singular. Esto asociará el UserId de Rudderstack con los datos a nivel de dispositivo del SDK. Proporcionar este valor a Singular en el objeto Singular Config al momento de la inicialización del SDK de Singular también permitirá que Singular envíe el UserId en el postback de instalación a Rudderstack. Consulta más información en la documentación del SDK Framework que estés utilizando para la integración de Singular. Ejemplo de [ iOS ][ Android ]
Además, el UserID se asociará con cualquier evento in-app activado de forma nativa desde el SDK de Singular.
Para los eventos "Cloud-Mode" recibidos, Singular ha mapeado el Custom User ID al valor del User ID de Rudderstack.