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 los clientes a diversos destinos. Ofrece una plataforma centralizada para administrar los pipelines de datos de clientes, permitiendo a las organizaciones recopilar fácilmente datos de diversas fuentes, como sitios web, aplicaciones móviles, servidores y servicios en la nube.

Singular Device ID (SDID) y versión de la API

La versión de la API de Singular que utiliza RudderStack depende de los campos de identificador presentes en el evento:

• Si el Singular Device ID (SDID) está presente en el evento, RudderStack utiliza automáticamente la API v2 de Singular e ignora los identificadores tradicionales específicos de la plataforma ( idfa , andi , idfv , aifa ).
• De lo contrario, RudderStack recurre a los identificadores específicos de la plataforma y envía el evento utilizando la API v1 de Singular.

Para enviar el Singular Device ID (y, opcionalmente, el consentimiento de intercambio de datos), incluya singularDeviceId y limitDataSharing dentro del objeto integrations.Singular de su evento:

rudderanalytics.track(
  "Order Completed", {
    revenue: 30,
    currency: "USD"
  }, {
    integrations: {
      Singular: {
        singularDeviceId: "SINGULAR_DEVICE_ID",
        limitDataSharing: true  // optional
      }
    }
  }
);

Primeros pasos

1. Desde su panel de RudderStack , agregue la fuente. Luego, en la lista de destinos, seleccione Singular .
2. Asigne un nombre a su destino y haga clic en Continuar .

Configuración de la conexión

Para configurar correctamente Singular como destino, debe establecer los siguientes ajustes:

• API Key: Ingrese aquí su "SDK Key" de Singular. Este es un campo obligatorio.

  Obtenga su "SDK KEY" de Singular, que se encuentra en el Singular Dashboard, en "Developer Tools > SDK Integration > SDK Keys" .

  
  

  Nota: Para la integración "Cloud-Mode", SOLO ingresará el valor de la API Key (SDK Key) .
  Deje el campo "Secret" en blanco.

• Session Event Name: Ingrese los nombres de los eventos que se usarán como eventos de sesión. Este ajuste solo aplica al envío de eventos mediante cloud mode.

  RudderStack envía los eventos de sesión a Singular a través de la API launch de Singular.

  RudderStack considera un evento como evento de sesión solo si está especificado en la configuración del panel o si es uno de los siguientes tres eventos de ciclo de vida :

  • Application Installed
  • Application Opened
  • Application Updated

  RudderStack rastrea automáticamente los tres eventos de ciclo de vida anteriores si el seguimiento de eventos de ciclo de vida está habilitado.

• Use device mode to send events: Estas opciones deben estar deshabilitadas cuando se usa "Cloud Mode" . Al usar las plataformas Android o iOS, puede habilitar este ajuste para enviar eventos mediante device mode. Luego, siga la guía de Singular Device Mode para conocer los pasos para agregar Singular a su proyecto.
• Filtrado de eventos del lado del cliente: Especifica qué eventos deben bloquearse o permitirse hacia Singular. Consulta la guía Client-side Events Filtering para obtener más información.
• Configuración de gestión de consentimiento: Configura los ajustes de gestión de consentimiento para la fuente eligiendo el proveedor de gestión de consentimiento en el menú desplegable e ingresando los IDs de categoría de consentimiento correspondientes. Consulta Consent Management in RudderStack para obtener más información.

Configuración del SDK de Unity

La siguiente configuración se aplica cuando se usa Unity como fuente:

Configuración	Descripción
Match ID mapping	Usa esta configuración para asignar el match ID de Singular a uno de los siguientes campos de evento: context.device.advertisingId o properties.match_id.

Requisitos de los eventos de sesión

Mapeos de eventos de SESSION admitidos

context.os.name

p

context.app.namespace

i

context.app.version

app_v

context.ip / request_ip 

ip

context.os.version

ve

context.device.model

mo

context.device.manufacturer

ma

context.locale

lc

context.device.id

idfv

context.device.id

andi

context.app.build

bd

context.device.adTrackingEnabled

dnt

context.app.name

n

timestamp / originalTimestamp

utime

context.network.wifi

c

context.network.carrier

cn

integrations.Singular.limitDataSharing

data_sharing_options.limit_data_sharing

properties.install_ref

install_ref

properties.referring_application

install_source

properties.install_receipt

install_receipt

properties.asid

asid

properties.url

openui

context.device.attTrackingStatus

att_authorization_status

userId

custom_user_id

properties.attribution_token

attribution_token

properties.skan_conversion_value

skan_conversion_value

properties.skan_first_call_timestamp

skan_first_call_timestamp

properties.skan_last_call_timestamp

skan_last_call_timestamp

properties.install

install

properties.install_time / timestamp / originalTimestamp

install_time

properties.update_time / timestamp / originalTimestamp

update_time

context.device.token

fcm

context.device.token

apns_token

context.device.advertisingId

idfa

context.device.advertisingId

aifa

Requisitos de los eventos personalizados

RudderStack envía todos los eventos que no sean eventos de sesión como eventos personalizados a través del endpoint evt de Singular.

Mapeos de EVENT admitidos

context.os.name

p

context.app.namespace

i

context.ip / request_ip 

ip

context.device.advertisingId

idfa

context.device.advertisingId

aifa

context.device.id

idfv

context.device.id

andi

context.os.version

ve

timestamp / originalTimestamp

utime

integrations.Singular.limitDataSharing

data_sharing_options.limit_data_sharing

event

n

context.device.attTrackingStatus

att_authorization_status

userId

custom_user_id

properties.skan_conversion_value

skan_conversion_value

properties.skan_first_call_timestamp

skan_first_call_timestamp

properties.skan_last_call_timestamp

skan_last_call_timestamp

properties.eventAttributes

e

properties.is_revenue_event

is_revenue_event

properties.receipt_signature

receipt_signature

properties.total/ properties.value / properties.revenue

amt

properties.currency

cur

properties.purchase_receipt

purchase_receipt

properties.product_id/properties.sku

purchase_product_id

properties.orderId / properties.purchase_transaction_id

purchase_transaction_id

Pruebas

¿Cómo puedo verificar si los eventos se entregan correctamente a Singular?

Para verificar si los eventos se entregan correctamente a Singular, puede usar la función Destination live events de RudderStack.

También puede verificar la entrega de eventos accediendo a su Singular dashboard y siguiendo estos pasos:

Siga la guía detallada aquí sobre cómo usar la Testing Console

1. Vaya a "Developer Tools > Testing Console" .

   

2. Haga clic en Add Device e ingrese el identificador de dispositivo correspondiente:

   

3. Debería poder ver un registro en tiempo real de todos los eventos enviados a Singular:

   

Preguntas frecuentes

¿Qué atributos de device ID se requieren para Android?

Para las solicitudes de Android, Singular requiere uno de los siguientes atributos, en este orden de preferencia:

1. aifa

2. asid

3. andi

Si ninguno de ellos está disponible, debe enviar al menos uno con un valor vacío (en lugar de null o undefined). Si los envía todos, RudderStack descarta el atributo andi conforme a las políticas de datos de Google.