RudderStack es una plataforma de datos de clientes (CDP) de código abierto que permite a las empresas recopilar, unificar y dirigir los datos de los clientes a varios destinos. Proporciona una plataforma centralizada para gestionar los flujos de datos de los 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 características y funcionalidades de Singular.
El enfoque híbrido consiste en:
- Implementar el SDK de Singular de forma independiente a Rudderstack, permitiendo que el SDK de Singular gestione el seguimiento de Sesiones, soporte adicional para SDK Frameworks (React Native, Unity, etc.), SkAdNetwork, deep link y deferred deep links, y funcionalidades avanzadas.
- Habilitación de la opción "Cloud-Mode" en Rudderstack para un Destino Singular. Esto permite que todos los eventos de seguimiento móvil de Rudderstack se envíen al Destino Singular.
Las siguientes instrucciones ilustran cómo configurar una implementación Singular Hybrid con Rudderstack.
| Guía para | Equipos de ingeniería |
| Requisitos previos | Este artículo asume que usted ya tiene el Rudderstack Mobile SDK integrado en su aplicación. |
Para utilizar esta integración, debe utilizar los SDK móviles de Rudderstack.
El SDK Singular proporcionará soporte para:
- Instalar Atribución
- Soporte SkAdNetwork
- Soporte para Google Install Referrer
- Soporte para META Install Referrer
- Atribución de anuncios de búsqueda de Apple
- Seguimiento personalizado de eventos en la aplicación
- Seguimiento de ingresos
- ID de usuario personalizado
- Propiedades globales
- Opciones de privacidad
La integración Rudderstack "Cloud-Mode" proporcionará soporte para:
- Seguimiento personalizado de eventos en la aplicación
- Seguimiento de ingresos
- ID de usuario personalizado
Configuración híbrida
-
Integrar el SDK Singular
Implemente el SDK Singular independientemente de Rudderstack. Ver las opciones de SDK y Frameworks AQUÍ.
-
Habilitar el Rudderstack - Destino Singular (Cloud-Mode)
Siga la Guía AQUÍ.
Configuración adicional recomendada
Cuando se utiliza una Metodología Híbrida, se recomienda pasar el AnonymousId de Rudderstack y el ID de Usuario de Rudderstack al SDK de Singular.
Tome nota y cuidado especial para implementar estas características opcionales de la documentación SDK. Los pasos pueden variar ligeramente dependiendo del framework que esté utilizando.
Implementar propiedades globales
Pase el AnonymousId de Rudderstack a una propiedad global de Singular. Esto asociará el Rudderstack AnonymousId a los datos a nivel de dispositivo del SDK.
La propiedad global debe configurarse al inicializar Singular SDK con la clave: rudderstack_anonymous_id y el valor del Rudderstack anonymousId recuperado del Rudderstack SDK. El Rudderstack AnonymousID puede obtenerse del Rudderstack SDK utilizando este método [iOS][Android].
[RSClient getInstance].anonymousId;Ejemplo Singular SDK Config
- (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 ID de usuario personalizado
Pase el Rudderstack UserId en el método Singular Custom User ID. Esto asociará el Rudderstack UserId a los datos a nivel de dispositivo del SDK. Proporcionar este valor a Singular en el objeto Singular Config en el momento de la Inicialización de Singular SDK también permitirá a Singular enviar el UserId en el postback de Instalación a Rudderstack. Más información sobre la documentación del SDK Framework que está utilizando para la integración de Singular. Ejemplo de[iOS][Android]
Además, el UserID se asociará a 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 Rudderstack User ID.