Antes de empezar: Requisitos previos del SDK

• Siga los pasos en Integración de un SDK Singular:Planificación y requisitos previos.
  Estos pasos son requisitos previos para cualquier integración de Singular SDK.
• Compruebe si utiliza Google EDM4U, el gestor de dependencias externas de Google para Unity.
  ¿Qué es Google EDM4U? Más información [AQUÍ].

1. 1. Instalación del SDK

1.1. Descarga e Importación del Paquete SDK

1.2. Configuración para Android

-keep class com.singular.sdk.** { *; }
-keep public class com.android.installreferrer.** { *; }
-keep public class com.singular.unitybridge.** { *; }

1.3. Consejos para iOS

pod repo update
pod update

// Printing Identifier for Vendor (IDFV) to Xcode Console for use in Singular SDK Console


NSLog(@"Singular === IDFV: %@", [[[UIDevice currentDevice] identifierForVendor] UUIDString]);

2. Integración SDK

2.1. Crear el SingularSDKObject

Añada el SingularSDKObject a la jerarquía.

Configure los ajustes de SingularSDKObject

1. En el panel Inspección para el SingularSDKObject, pegue su Clave SDK Singular y Secreto SDK en los campos respectivos. Para recuperar la clave y el secreto del SDK, inicie sesión en su cuenta de Singular y vaya a"Developer Tools > SDK Integration > SDK Keys").
   
   
   
   IMPORTANTE: NO UTILICE la clave API de Singular Reporting o no recibirá sus datos SDK. Siga las instrucciones anteriores para recuperar la clave y el secreto adecuados.
   
   
   

   Si la clave y el secreto de Singular SDK se aplican incorrectamente, los datos no se enviarán a Singular.
   Pruebe su implementación utilizando la consola de Singular SDK para verificar el comportamiento correcto.

   Nota: Configuración predeterminada del panel de inspección para SingularSDKObject:

   Las siguientes opciones están habilitadas en el Panel de Inspección:

   #

   • Initialize On Awake (marcado)

     Esta configuración permite a Unity controlar la Inicialización del Singular SDK basado en el estado Awake de la App.

     Cumpla con los requisitos de privacidad de su aplicación y actualice esta opción según sea necesario. Desmarcando la opción se desactiva la inicialización de Singular SDK en el estado Awake y requeriría la inicialización manual.

   • SKAN Habilitado (marcado)

     A partir de Unity SDK versión 4.0.17, SKAdNetwork está habilitado por defecto. Está habilitado en Modo Administrado (en el cual Singular actualiza el valor de conversión SKAN por usted utilizando un modelo de conversión que usted elige en el tablero de Singular).

   • Esperar autorización de seguimiento, establecido en 0 (desactivado)

     Si su aplicación muestra el mensaje de transparencia de seguimiento de aplicaciones (ATT ), se recomienda establecer este tiempo de espera en 300 segundos. La adición del tiempo de espera retrasa la sesión de Singular SDK, lo que permite al usuario autorizar/denegar el consentimiento de AppTrackingTransparency antes de registrar eventos en los servidores de Singular. Una vez que el Usuario responde a la solicitud de ATT, Singular SDK continuará sin demora. Esto permite capturar el identificador IDFA para Install Attribution cuando se proporciona el consentimiento. Si no muestra ATT, el valor predeterminado de esta opción debe seguir siendo 0 (sin espera).

   • Habilitar registro (marcado)

     Habilita el registro desde Singular SDK. Debe utilizarse con la opción"Nivel de registro".
     "Log Level" debe especificarse con un número "int", tal y como se especifica en el mapeo enum a continuación. Cuanto menor sea el número en este rango, más detallados serán los registros.

     //Based on Android Logger.java log levels enum: android.util.Log
     public enum LogLevel {
        Verbose = 2,
        Debug   = 3,
        Info    = 4,
        Warn    = 5,
        Error   = 6,
        Assert  = 7
        }

     Nota: Actualmente, la mayoría de los registros sólo están disponibles en Android.

   • Ddl Timeout Sec establecido a 0

     Por defecto, el valor "0" utiliza un tiempo de espera de 60 segundos. Esto indica al servidor Singular cuánto tiempo debe buscar un valor de enlace profundo vinculado a la atribución del último toque. Si se encuentra un enlace profundo diferido, se devuelve a la aplicación en la respuesta a la solicitud de sesión del SDK y se procesa en el SingularLinkHandler. El servidor deja de buscar si no se encuentra ningún enlace profundo diferido en 60 segundos.

   • Session Timeout Sec (Tiempo de espera de sesión) establecido en 0

     Este es el tiempo de espera en segundos antes de que el SDK Singular registre una nueva sesión cuando la aplicación está en segundo plano y vuelve al primer plano. Por defecto, el valor "0" utiliza un tiempo de espera de 60 segundos. Si es necesario, puede ajustar esta configuración para una ventana más grande.

   • Tiempo de espera de Shortlink Resolve ajustado a 0

     Por defecto, el valor "0" utiliza un tiempo de espera de 10 segundos. Este tiempo de espera protege la experiencia del usuario. Si el enlace corto indicado no se resuelve en el tiempo especificado, Singular SDK no activa un controlador de enlace profundo.

   Otras opciones del panel de inspección:

   Activar Facebook (META Install Referrer)

   #

   Para admitir el método de atribución META Install Referrer, añada su ID de aplicación de Facebook al panel de inspección en el SingularSDKObject.

   1. Haga clic en el SingularSDKObject en su Escena Principal.
   2. Abra el panel de inspección y localice el campo "Facebook App ID".
   3. Añade el ID de tu aplicación de Facebook.

   ¿Qué es Meta Install Referrer?

   ¿Dónde puedo encontrar el Facebook App ID de una aplicación?

2.2. Uso de SKAdNetwork

A partir de Unity SDK versión 4.0.17, SKAdNetwork está habilitado por defecto. Está habilitado en el modo gestionado (en el que Singular actualiza el valor de conversión de SKAN por usted utilizando un modelo de conversión que usted elige en el panel de control de Singular).

Para utilizar SKAdNetwork, no es necesario configurar nada más ni añadir ningún código, siempre y cuando esté utilizando el SDK más reciente.

Información adicional

// A sign-up event happened


Singular.Event("SignUp");

// Update the conversion value to 7


SingularSDK.SkanUpdateConversionValue(7);

int? value = SingularSDK.SkanGetConversionValue();

public class Main : MonoBehaviour, SingularConversionValueUpdatedHandler {
  void Awake() {
    SingularSDK.SetConversionValueUpdatedHandler(this);
  }

  void OnConversionValueUpdated(int value) {
    // Use the conversion value


  }
}

2.3. Manejar el consentimiento de App Tracking Transparency(ATT) de iOS

¿Está mostrando el aviso App Tracking Transparency(ATT)?

A partir de iOS 14.5, las aplicaciones deben solicitar el consentimiento del usuario (mediante el marco App Tracking Transparency) antes de poder acceder y compartir algunos datos del usuario, incluido el IDFA del dispositivo, que es útil para fines de seguimiento.

Singular y las redes publicitarias se benefician enormemente de disponer del IDFA para identificar dispositivos y realizar la atribución de instalaciones (aunque hay formas de hacerlo sin el IDFA). Recomendamos encarecidamente solicitar el consentimiento del usuario para obtener el IDFA.

Se recomienda retrasar la inicialización de Singular SDK hasta que el usuario responda a la solicitud de ATT.

Por defecto, Singular SDK envía una sesión de usuario cuando se inicializa. Cuando se envía una sesión desde un nuevo dispositivo, se activa inmediatamente el proceso de atribución de Singular, que se realiza basándose únicamente en los datos de que dispone Singular en ese momento. Por lo tanto, solicitar el consentimiento y recuperar el IDFA antes de que el SDK de Singular envíe la primera sesión es esencial.

Para configurar el waitForTrackingAuthorizationWithTimeoutInterval ajuste la opción de configuración en el panel de Inspección de SingularSDKObject . Esto establece el tiempo máximo (en segundos) para que el Singular SDK espere a que el Usuario autorice/deniegue el Consentimiento de AppTrackingTransparency antes de registrar eventos en los servidores de Singular.

2.4. Manejo de enlaces profundos

Los enlaces profundos son URLs que dirigen a los usuarios a contenidos específicos dentro de una aplicación. Cuando un usuario hace clic en un enlace profundo en un dispositivo con la aplicación ya instalada, la aplicación se abre y muestra un producto o experiencia en particular.

Los enlaces de seguimiento singulares pueden incorporar tanto enlaces profundos como enlaces profundos diferidos. Para más detalles, puede consultar nuestras Preguntas frecuentes sobre enlaces profundos y las Preguntas frecuentes sobre enlaces singulares.

Amplíe las secciones a continuación para obtener más detalles sobre la compatibilidad de plataformas y el código del controlador:

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using Singular;

public class SingularMain : MonoBehaviour, SingularLinkHandler
{
    // Start is called before the first frame update


    void Start()
    {
        
    }
    
    void Awake () {
        Debug.Log("Singular === Awake");
        /* Register the class as the Singular Link handler. 
           You can call this method at any point in the app's run. 
           It will fetch the tracking link details and call OnSingularLnkResolved. */
        SingularSDK.SetSingularLinkHandler(this);
    }
    
    public void OnSingularLinkResolved(SingularLinkParams linkParams) {
        Debug.Log("Singular === OnSingularLinkResolved");
        
        // The deep link destination, as configured in the Manage Links page


        string deeplink = linkParams.Deeplink;

        // The passthrough parameters added to the link, if any.


        string passthrough = linkParams.Passthrough;

        // Whether the link configured as a deferred deep link.


        bool isLinkDeferred = linkParams.IsDeferred;

        // Add code here to process the deeplink


        Debug.Log("Singular === deeplink: "+deeplink);
        Debug.Log("Singular === passthrough: "+passthrough);
        Debug.Log("Singular === isLinkDeferred: "+isLinkDeferred);      
    }
}

public void SetSingularLinkHandler(SingularLinkHandler 
handler)

public class Main : MonoBehaviour, SingularLinkHandler {
    void Awake () {
        SingularSDK.SetSingularLinkHandler(this)
    }
}

public void OnSingularLinkResolved(SingularLinkParams
linkParams)

public void OnSingularLinkResolved(SingularLinkParams
linkParams){
    // Read the tracking link details and log them


    Debug.Log("deeplink: " + linkParams.Deeplink);
    Debug.Log("passthrough: " + linkParams.Passthrough);
    Debug.Log("is_deferred: " + linkParams.IsDeferred);
}

2.5. Inicialización del SDK

El código de inicialización del SDK debe ejecutarse cada vez que se abra la aplicación. Es un requisito previo para toda la funcionalidad de atribución de Singular y envía una nueva sesión a Singular, que se utiliza para calcular la retención de usuarios.

Por defecto, SingularSDK.cs inicializa el SDK automáticamente cuando se crea la escena a través del método Awake.

Inicialización manual

Si prefiere inicializar el SDK manualmente en un momento posterior de la ejecución de la aplicación, haga lo siguiente:

1. Desactive la opción Initialize on Awake en el panel de inspección del objeto SingularSDK.
2. Utilice el método estático SingularSDK.InitializeSingularSDK para inicializar el SDK:

public void InitializeSingularSDK()

// SDK Key and SDK Secret are set on the 


// game object associated with SingularSDK 


SingularSDK.InitializeSingularSDK();

2.6. Configuración del tiempo de espera de la sesión (opcional)

Por defecto, si la aplicación se ejecuta en segundo plano durante 60 segundos o más antes de volver al primer plano, Singular SDK registra una nueva sesión. Puede cambiar el valor predeterminado del tiempo de espera modificando la propiedad Session Timeout Sec de su SingularSDKObject.

2.7. Envío del ID de usuario a Singular (opcional)

Puede enviar su ID de usuario interno a Singular utilizando un método de Singular SDK.

• El ID de usuario puede ser cualquier identificador y no debe exponer PII (Personally Identifiable Information). Por ejemplo, no debe utilizar la dirección de correo electrónico, el nombre de usuario o el número de teléfono del usuario. Singular recomienda utilizar un valor hash único sólo para sus datos de origen.
• El valor de ID de usuario que se pasa a Singular también debe ser el mismo ID de usuario interno que se captura en todas las plataformas (Web/Móvil/PC/Consola/Offline).
• Singular incluirá el ID de usuario en las exportaciones a nivel de usuario, ETL y devoluciones internas de BI (si está configurado). El ID de usuario es un dato de origen y Singular no lo comparte con terceros.
• Cuando se establece con el método Singular SDK, el valor del ID de usuario persiste hasta que se desestablece utilizando el método UnsetCustomUserId o hasta que se desinstala la aplicación. Cerrar o reiniciar la aplicación no anula el ID de usuario.

Para establecer el ID de usuario, utilice el método SetCustomUserId. Para desactivarlo (por ejemplo, si el usuario "cierra sesión" en la cuenta), llame a UnsetCustomUserId.

Si ya conoce el ID de usuario cuando se abre la aplicación, llame a SetCustomUserId antes de inicializar Singular SDK. De este modo, Singular puede obtener el ID de usuario desde la primera sesión. Sin embargo, el ID de usuario no suele estar disponible hasta que el usuario se registra o realiza un inicio de sesión. En ese caso, llame a SetCustomUserId una vez finalizado el flujo de registro.

SingularSDK.SetCustomUserId("custom_user_id");

SingularSDK.UnsetCustomUserId();

SingularSDK.SetDeviceCustomUserId('CustomUserId');

3. Seguimiento de eventos e ingresos

3.1. Seguimiento de eventos (no ingresos)

Singular puede recopilar datos sobre eventos dentro de la aplicación para ayudar a analizar el rendimiento de sus campañas y medir los KPI. Por ejemplo, es posible que su organización desee recopilar datos sobre inicios de sesión de usuarios, registros, finalización de tutoriales o subidas de nivel en una aplicación de juegos.

Singular admite una variedad de eventos estándar. Las redes publicitarias suelen admitir estos eventos de uso común para la elaboración de informes y la optimización. Otra ventaja es que cuando utiliza nombres de eventos estándar, Singular los reconoce automáticamente y los añade a la lista de eventos sin que tenga que definirlos manualmente. Recomendamos utilizar eventos estándar siempre que sea posible.

La lista de eventos enviados a Singular (con los atributos que los acompañan) debe ser compilada por el equipo de UA/marketing/negocio basándose en los KPI de marketing de su organización. El equipo comercial puede seguir Cómo realizar el seguimiento de eventos en la aplicación: Guía para clientes de Singular Attribution.

Con cada evento que rastree, puede pasar varios atributos. Consulte los atributos estándar recomendados por evento.

Envíe eventos estándar a Singular utilizando los métodos event o eventWithArgs en su código.

SingularSDK.Event(Events.sngLogin);

public static void Event(string name)

public static void Event(string name, params object[] args)

public static void Event(Dictionary<string, object> args, string name)

// 1) Send the standard event Login


SingularSDK.Event(Events.sngLogin);

// 2) An example custom event passing two key value pairs


SingularSDK.Event("myEventName", "Key1", "Value1", "Key2", 1234);

// 3) An example JSON Event passing a dictionary


// Create a dictionary for attributes


Dictionary<string, object> attributes = new Dictionary<string, object>();

// Add attributes


attributes["key1"] = "value1";
attributes["key2"] = "value2";
attributes["key3"] = "value3";
// Add more attributes as needed



SingularSDK.Event(attributes, "myEventName");

3.2. Seguimiento de ingresos

Singular puede recopilar datos sobre los ingresos obtenidos a través de la aplicación para ayudar a analizar el rendimiento y el ROI de sus campañas. Singular hará que los datos estén disponibles en informes, exportación de registros y postbacks.

Puede realizar un seguimiento de los eventos de ingresos utilizando el objeto IAP (In-App Purchases) integrado de Unity. De esta manera, Singular obtiene toda la información disponible sobre la compra para obtener informes más completos. Singular también obtiene el recibo de compra, que Singular utiliza en el back-end para validar la compra y descartar el fraude de atribución.

public static void InAppPurchase(Product product, Dictionary<string, object> attributes, bool isRestored = false)

public static void InAppPurchase(string eventName, Product product, Dictionary<string, object> attributes, bool isRestored = false)

public static void InAppPurchase(IEnumerable<Product> products,
Dictionary<string, object> attributes, bool isRestored = false)

public static void InAppPurchase(string eventName,IEnumerable<Product> products, Dictionary<string, object> attributes, bool isRestored = false)

// IAP with a single product and no extra attributes


SingularSDK.InAppPurchase(myProduct, null);

// IAP with a single product and attributes


var attr = new Dictionary<string, object>() {
["my_first_attribute"] = "value1",
["my_second_attribute"] = "value2"};
 
SingularSDK.InAppPurchase(myProduct, attr);

// IAP with with a single product, 


// no extra attributes and a custom event name



SingularSDK.InAppPurchase("MyCustomProduct",
myProduct, null);

// IAP with list of products, no extra attributes


SingularSDK.InAppPurchase(myProductList, null);

// IAP with with list of products, no extra attributes


// and a custom event name



SingularSDK.InAppPurchase("MyCustomProducts",
myProductList, null);

public static void Revenue(string currency, double amount)

public static void Revenue(string currency, double amount, string productSKU, string productName, string productCategory, int productQuantity, double productPrice)

public static void Revenue(string currency, double amount, Dictionary<string, object> attributes)

// Send a revenue event with no product details


SingularSDK.Revenue("USD", 1.99);

// Send a revenue event with product details


SingularSDK.Revenue("USD", 4.99, "coin_package_abc123", "Coin Pack 5", "Bundles", 1, 4.99);

// Send a revenue event with JSON Dictionary for attributes


Dictionary<string, object> attributes = new Dictionary<string, object>();

// Add attributes


attributes["productSKU"] = "coin_package_abc123";
attributes["productName"] = "Coin Pack 5";
attributes["productCategory"] = "Bundles";
attributes["productQuantity"] = 2;
attributes["productPrice"] = 4.99;

SingularSDK.Revenue("USD", 9.98, attributes);

public static void CustomRevenue(string eventName, string currency, double amount)

public static void CustomRevenue(string eventName, string currency, double amount, string productSKU, string productName, string productCategory, int productQuantity, double productPrice)

public static void CustomRevenue(string eventName, string currency, double amount, Dictionary<string, object> attributes)

// Send a revenue event with a custom name


SingularSDK.CustomRevenue("MyCustomRevenue", "USD", 9.99);

// Send a revenue event with a custom name + product details


SingularSDK.CustomRevenue("MyCustomRevenue", "USD", 50.50, "abc123", "myProductName", "myProductCategory", 2, 25.50);

// Send a revenue event with a custom name + JSON Dictionary for attributes


// Create a dictionary for attributes


Dictionary<string, object> attributes = new Dictionary<string, object>();

// Add attributes


attributes["productSKU"] = "coin_package_abc123";
attributes["productName"] = "Coin Pack 5";
attributes["productCategory"] = "Bundles";
attributes["productQuantity"] = 2;
attributes["productPrice"] = 4.99;
// Add more attributes as needed



SingularSDK.CustomRevenue("MyCustomRevenue", "USD", 9.98, attributes);

3.3. Seguimiento de eventos híbrido (avanzado)

Singular recomienda enviar todos los eventos e ingresos a través del SDK de Singular integrado en su aplicación. Sin embargo, Singular puede recopilar eventos e ingresos de otras fuentes.

Cualquier evento NO enviado desde el SDK de Singular debe cumplir con los requisitos de documentación de eventos de servidor a servidor de Singular y proporcionar el identificador de dispositivo correspondiente para atribuir correctamente un evento.

Guías de seguimiento de eventos híbridos

4. Opciones Avanzadas

4.1. Creación de Enlaces de Referencia Cortos

Utilice los enlaces cortos para transformar enlaces singulares largos y llenos de parámetros en enlaces más cortos y seguros que sean convenientes para compartir.

Normalmente, querrá crear enlaces cortos de forma dinámica para que los usuarios de su aplicación puedan compartirlos con sus amigos para invitarles a utilizar la aplicación.

Para crear un enlace corto, necesitas

• Un Enlace Singular que lleve a la descarga de tu app (consulta las Preguntas Frecuentes sobre Enlaces Singulares).
• Puede añadir los parámetros que desee al enlace de forma dinámica (consulte Parámetros del enlace de seguimiento para ver la lista de opciones).
• Si desea realizar un seguimiento de las nuevas instalaciones de la aplicación hasta el usuario que compartió el enlace, debe proporcionar el Nombre de remitente y el ID de remitente del usuario remitente.

Utilice el método createReferrerShortLink para crear un enlace corto, como en el ejemplo siguiente.

void callback(string shortLinkURL, string error){
    // Add your share logic here if shortLinkURL is not null


    // If there was an error, add logic to retry/abort/modify the params


    // passed to the function, based on the cause of the error


}

SingularSDK.createReferrerShortLink(
    "https://sample.sng.link/B4tbm/v8fp?_dl=https%3A%2F%2Fabc.com",
    "John Doe", // Referrer Name


    "342", // Referrer ID


    new Dictionary<string, string>() { 
        // a Dictionary object containing any parameters you want to add


        {"channel", "sms"}
    },
    callback 
);

4.2. Añadir soporte de atribución de ingresos publicitarios

4.3. Seguimiento de desinstalaciones

Seguimiento de desinstalaciones en Android

Para habilitar el seguimiento de desinstalaciones para su aplicación Android, primero configure la aplicación en la plataforma Singular como se detalla en Configuración del seguimiento de desinstalaciones. A continuación, siga las siguientes instrucciones.

Habilitación del seguimiento de desinstalaciones mediante Firebase Cloud Messaging (FCM):

1. Integrarse con FCM:

Para realizar un seguimiento de las desinstalaciones, puedes utilizar los servicios de la plataforma Firebase Cloud Messaging (FCM). Si aún no utiliza FCM, siga las instrucciones de Google sobre cómo configurar una aplicación cliente de Firebase Cloud Messaging en Android.

2. Actualice el archivo AndroidManifest.xml:

Actualiza tu archivo AndroidManifest.xml para añadir el filtro de intent necesario para tu app (sustituye MyFirebaseMessagingService por tu clase que implemente el servicio Firebase):

<service android:name=".java.MyFirebaseMessagingService" android:exported="false">
  <intent-filter>
    <action android:name="com.google.firebase.MESSAGING_EVENT" />
  </intent-filter> 
</service>

3. Registrar y enviar el token de dispositivo FCM:

Después de recuperar el token FCM, pásalo como parámetro al método 'RegisterTokenForUninstall':

SingularSDK.RegisterTokenForUninstall(String fcmDeviceToken);

El método 'RegisterTokenForUninstall' debe llamarse antes que elmétodo 'SingularSDK.InitializeSingularSDK()'.

Seguimiento de desinstalaciones en iOS

El seguimiento de la desinstalación en iOS se basa en la tecnología de notificaciones push de Apple. Si su aplicación no es compatible con las notificaciones push, consulte la guía de Apple. Si su aplicación ya admite notificaciones push, debe pasar el token de dispositivo devuelto por APNS mediante el método RegisterTokenForUninstall una vez inicializado el SDK.

public static void RegisterTokenForUninstall
(string APNSToken)

// pass the APNS token as a hex-string 


  SingularSDK.RegisterTokenForUninstall("ba85ab31a7c7
f5c2f012587f29fb0e596d4b67e7b7b2838fa1a8582c1f7dbdee");

4.4. Añadir propiedades globales

Con cada sesión y evento enviado desde la aplicación, el SDK de Singular le permite definir propiedades adicionales personalizadas para enviar a los servidores de Singular. Estas propiedades pueden representar cualquier información que desee sobre el usuario, el modo de la aplicación, el estado o cualquier otra cosa. Una vez definidas estas propiedades, estarán disponibles como dimensiones en sus informes, y podrá utilizarlas para desglosar sus datos.

Por ejemplo, si tienes una aplicación de juegos, puedes definir una propiedad llamada "Nivel" y establecerla inicialmente en "0". Cualquier sesión y evento enviado desde la app se enviará con "Nivel": "0". Una vez que el usuario sube de nivel, restableces la propiedad a "1" y así sucesivamente. A continuación, puede obtener sus informes, incluyendo sesiones, recuentos de eventos y datos de ingresos, desglosados por nivel de usuario.

Configuración de propiedades globales antes de la inicialización

Puede utilizar el método SetGlobalProperty para establecer propiedades globales a través de SingularSDK antes de inicializar el SDK. Si desea que sus propiedades globales se incluyan en la sesión, desactive el indicador 'Initialize On awake'.

Dado que las propiedades globales y sus valores persisten entre las ejecuciones de la aplicación, es posible que la propiedad que está configurando ya tenga un valor diferente. Utilice el parámetro overrideExisting para indicar al SDK si debe anular una propiedad existente con el nuevo valor.

Configuración de propiedades globales tras la inicialización

Puede utilizar los siguientes métodos para establecer, desestablecer y recuperar propiedades globales en cualquier momento durante la ejecución de la aplicación.

bool result = SingularSDK.SetGlobalProperty("key", "value", false);

Dictionary<string, string> props = SingularSDK.GetGlobalProperties();

SingularSDK.UnsetGlobalProperty(“test_key”);

SingularSDK.clearGlobalProperties();

4.5. Recopilación de la referencia de instalación en dispositivos Android antiguos

En Android, la referencia de instalación es la herramienta más precisa de Singular para determinar la atribución y ayudar a Singular a detectar y analizar los intentos de fraude. Se trata de un identificador proporcionado por Google Play Store que apunta al anuncio en el que el usuario hizo clic antes de instalar la aplicación.

En dispositivos con la última versión de Google Play Store, el SDK de Singular recopila automáticamente el valor de referencia de instalación (ya que Singular está integrado con la última API de referencia de Google Play).

Para recopilar el referrer de instalación en dispositivos más antiguos, siga las instrucciones de la guía Android SDK.

5. Cumplimiento de las leyes de privacidad de datos

5.1. LimitDataSharing

Singular proporciona una funcionalidad de protección de la privacidad para ayudarle a cooperar con cualquier socio que pueda estar cumpliendo con las leyes de privacidad del consumidor, como GDPR y CCPA(California Consumer Privacy Act). Estos socios quieren ser notificados si el usuario final ha dado su consentimiento para compartir su información privada.

Limitar el uso compartido de datos

Si ha implementado una forma de solicitar a los usuarios su consentimiento para compartir su información, utilice el método limitDataSharing para notificar a Singular la elección del usuario:

• Utilice limitDataSharing:NO para indicar que el usuario ha dado su consentimiento (optado) para compartir su información.
• Utilice limitDataSharing:YES si el usuario no dio su consentimiento.

Singular utiliza LimitDataSharing en los"Postbacks de privacidad del usuario" y transmite esta información a los socios que la requieren para cumplir con la normativa pertinente. Consulte"Privacidad del usuario y Limitar el uso compartido de datos" para obtener más información.

// User has opted in to sharing data


SingularSDK.LimitDataSharing(false);

5.2. Métodos adicionales para el cumplimiento de GDPR

Singular SDK proporciona varios métodos para ayudarle a cumplir con las políticas GDPR y permitir que Singular conozca el consentimiento o no consentimiento del usuario para el seguimiento.

SingularSDK.TrackingOptIn();

SingularSDK.StopAllTracking();

SingularSDK.ResumeAllTracking();

SingularSDK.IsAllTrackingStopped();