SDK de Unity - Referencia de configuración
Este documento proporciona una referencia completa de todas las opciones de configuración disponibles en el Singular SDK para aplicaciones Unity. La configuración se realiza a través del componente MonoBehaviour de SingularSDK, que puede adjuntarse a un GameObject en su escena de Unity o configurarse a través del Inspector de Unity. Cada propiedad de configuración se presenta con una descripción, firma y ejemplos prácticos de uso.
Ejemplo de configuración completa
Configuración Completa del SDK
El siguiente ejemplo demuestra cómo configurar el Singular SDK con múltiples opciones. La configuración se puede realizar a través del Inspector de Unity en el GameObject SingularSDKObject.
Panel del Inspector de SingularSDKObject
Dominios de Marca
Establece dominios de marca para la atribución de web a aplicación. Esto permite al Singular SDK reconocer el dominio de seguimiento personalizado y permitir la apertura de la app.
Ejemplo de uso
yourcompany.com
go.yourcompany.com
promo.yourcompany.com
Atribución del portapapeles
Utilice esta casilla de verificación para habilitar la atribución del portapapeles para iOS. Cuando está activada, el SDK lee el portapapeles al iniciar la aplicación para detectar enlaces de atribución. Sólo para iOS.
Recopilar OAID
Marque esta casilla para activar la recopilación de OAID (Open Anonymous Device Identifier) en dispositivos Android. OAID se utiliza como identificador alternativo en regiones en las que Google Advertising ID no está disponible. Sólo Android.
Ddl Timeout Sec
Establece el tiempo de espera en segundos para la resolución diferida de enlaces profundos. Determina el tiempo que el SDK esperará un enlace profundo diferido antes de continuar con la inicialización. El valor predeterminado es 60 segundos.
Habilitar registro
Marque esta casilla para activar el registro del SDK. Cuando se activa, el SDK mostrará información de depuración para ayudar con la integración y la resolución de problemas. Debe desactivarse en las versiones de producción.
Activar ODM con intervalo de tiempo de espera
Activa ODM (On-Device Matching) con un intervalo de tiempo de espera especificado en segundos. ODM permite una atribución más precisa comparando las huellas dactilares de los dispositivos. Establece -1 para desactivarlo. Sólo para iOS.
Id. de aplicación de Facebook
Establece el ID de la aplicación de Facebook para la integración de la atribución de Facebook. Esto permite al SDK realizar un seguimiento de la atribución de campañas de Facebook. Sólo Android.
Inicializar al despertar
Determina si el SDK debe inicializarse automáticamente cuando el GameObject se despierta. Cuando se establece en false, debe llamar manualmente a InitializeSingularSDK() para inicializar el SDK.
Limitar identificadores de publicidad
Activa el modo de identificadores de publicidad limitados en aplicaciones de audiencia mixta. Esta opción afecta al modo en que el SDK recopila y utiliza los identificadores de dispositivo para el seguimiento. Si está activada, no se recopilarán los identificadores de publicidad.
Nivel de registro
Establece el nivel de registro para el SDK. Los valores válidos son: 0 (Ninguno), 1 (Error), 2 (Advertencia), 3 (Info/Debug), 4 (Verbose). Los valores más altos proporcionan una salida de registro más detallada.
Gestión manual de la conversión SKAN
Permite gestionar manualmente los valores de conversión de SKAdNetwork. Cuando está activada, debe actualizar manualmente los valores de conversión mediante SkanUpdateConversionValue(). Sólo iOS.
Rutas de enlace de notificaciones push
Especifica las rutas JSON donde se pueden encontrar las URL de enlaces profundos en las cargas útiles de las notificaciones push. Esto permite al SDK extraer y procesar enlaces profundos de notificaciones push. sólo iOS.
notification/deep_link
data/url
custom_link
Tiempo de espera de sesión en segundos
Establece el tiempo de espera de la sesión en segundos. Determina cuánto dura una sesión de usuario después de que la aplicación pasa a segundo plano. El valor predeterminado es 60 segundos.
Tiempo de espera de resolución de enlaces cortos
Establece el tiempo de espera en segundos para la resolución de enlaces cortos. Determina cuánto tiempo esperará el SDK a que se resuelva un enlace corto. El valor predeterminado es 10 segundos.
Clave de API singular
Establece la clave de API singular para su aplicación. Se trata de un valor de configuración obligatorio que identifica su aplicación en la plataforma Singular. Puede encontrar su clave de API en el panel de control de Singular.
Secreto de la API de Singular
Establece el secreto de la API de Singular para su aplicación. Se trata de un valor de configuración obligatorio que se utiliza junto con la clave de API para una comunicación segura. Puede encontrar su secreto de API en el panel de control de Singular.
SKAN activado
Activa o desactiva la funcionalidad SKAdNetwork. Si está activada, el SDK se registrará automáticamente para la atribución de SKAdNetwork y gestionará los valores de conversión. Sólo iOS.
Esperar autorización de seguimiento con intervalo de tiempo de espera
Establece el tiempo de espera en segundos para esperar la autorización ATT (App Tracking Transparency) antes de inicializar el SDK. Establezca 0 para no esperar. Sólo iOS.