Info
Contenido

[Unidad] 1. consentmanager Integración SDK

En este documento encontrará información general sobre cómo integrar nuestro SDK a su proyecto. Para obtener más detalles, consulte nuestra Referencia de la API documentación.

1. Instalación

consentmanager SDK es una solución integral para gestionar el consentimiento de los usuarios en aplicaciones móviles. Diseñado para gestionar el cumplimiento del RGPD, las preferencias de privacidad del usuario y la transparencia del seguimiento de anuncios, este SDK proporciona una integración perfecta para las plataformas iOS y Android. Además, ofrece complementos y puentes de contenedor para React Native, Flutter y Unity, lo que lo hace versátil en varios entornos de desarrollo.

Pasos: descripción de alto nivel

  1. Integración y Configuración:

    • Integre el SDK en su aplicación.
    • Configure los ajustes del SDK según sus necesidades.
  2. Creación de una instancia y visualización de la capa de consentimiento:

    • Al iniciar la aplicación, cree una instancia de CMPManager clase. Esta instancia se encargará del proceso de consentimiento.
    • El SDK mostrará automáticamente la pantalla de consentimiento si es necesario.
  3. Tratamiento de los datos de consentimiento del usuario:

    • Una vez que se recopilan los consentimientos, la información se almacena y está disponible para su consulta a través de diferentes propiedades y métodos expuestos por nuestro SDK. Tendrás información sobre consentimientos rechazados o aceptados, proveedores y propósitos.

En términos de compatibilidad, tenemos:

  • Unidad 20XX.XX o posterior
  • iOS (a través de DllImport)
  • Android (a través de JNI)

1. Importación del paquete SDK

En sólo dos pasos podrás tenerlo todo configurado.

    • Descargue la última versión del complemento.
    • Importe el paquete a su proyecto de Unity usando Activos > Importar paquete > Paquete personalizado.

Configurar JSON

En CmpSdkConfig.json puede configurar la versión nativa del SDK para iOS y Android que se utilizará para el proceso de compilación: 

Encuentre las versiones nativas del SDK compatibles aquí

{
  "displayName": "Consentmanager SDK",
  "name": "CmpSdk",
  "androidBasePath": "net.consentmanager.sdk",
  "version": "3.0.0",
  "androidLibraryVersion": "x.xx.x",
  "iosLibraryVersion": "x.xx.x",
  "description": "Unity plugin helps you to use native Consentmanager functionality on Android and iOS."
}

Configuración de compilación

Para cambiar la configuración de compilación, vaya a Window -> CmpSdk 

pluginwindow-unity.png

Configuración de compilación de iOS

  • Habilite el script de compilación de iOS: Cambie esto para habilitar o deshabilitar el script de compilación responsable de integrar el SDK de iOS en el proyecto de Unity.
  • Ruta xcFramework: Especifique la ruta al directorio xcFramework. Esta ruta se puede editar directamente o navegar usando el botón adjunto.
  • Incluir etiqueta de versión: Cuando está habilitado, agrega la versión del SDK de iOS a la ruta xcFramework, lo que permite configuraciones específicas de la versión.
  • Ruta del marco resultante: Muestra la ruta completamente resuelta a xcFramework, incluida la versión del SDK si se incluye la etiqueta de versión.
  • Habilite la transparencia del seguimiento de aplicaciones: Cambie esto para habilitar la función Transparencia de seguimiento de aplicaciones para iOS, que es necesaria para obtener el consentimiento del usuario según las pautas de privacidad de iOS.
  • Mensaje de consentimiento de transparencia de seguimiento de aplicaciones: Un campo de texto para ingresar el mensaje personalizado que se muestra a los usuarios cuando solicitan consentimiento para el seguimiento. Este mensaje debe ser claro y conciso, explicando por qué se necesita el consentimiento.

Configuración de compilación de Android

  • Habilite el script de compilación de Android: Cambie para habilitar o deshabilitar el script de compilación para integrar el SDK de Android en el proyecto de Unity. 
  • Integrar diseño personalizado: Cuando está habilitado, esto permite el uso de un diseño personalizado para la capa de consentimiento para el fragmento UIView.

    Si desea utilizar un diseño personalizado con fragmentos, asegúrese de que su proyecto de Unity agregue el appcompat Dependencia. Agregue una plantilla principal personalizada: 
    Activos/Complementos/Android/mainTemplate.gradle
    y agregue la dependencia:
    implementación 'androidx.appcompat:appcompat:1.xx'

2. Usando el SDK

Consulte el ejemplo a continuación para ver una ilustración del uso de nuestro SDK. Para obtener más información, consulte el documento completo Referencia de la API.

Tenga en cuenta que las funciones relacionadas con la determinación de si se necesita o no el consentimiento, así como la visualización de la capa de consentimiento, dependen de una conexión de red fiable. Si no hay conexión disponible o si el mecanismo de reintento no logra llegar a nuestro servidor, el evento didReceiveError devolverá un error de tiempo de espera, por lo que el SDK no podrá determinar la necesidad de un consentimiento, ya que no podrá mostrar la capa de consentimiento. Asegúrese de que su lógica tenga esto en cuenta.

Script de ejemplo

    private static void CheckConsentWithServer(){     
    	CmpManager.Instance.CheckWithServerAndOpenIfNecessary();}
    }  
        
    private static void SetCmpUrlConfig() {
      	const string id = "id";           
      	const string domain = "domain";           
      	const string language = "en";           
      	const string appName = "AppName";           
      
      	CmpManager.Instance.SetUrlConfig(id, domain, language, appName);       
    }         
    
    private void OpenConsentLayer() {            
      	CmpManager.Instance.OpenConsentLayer();        
    }        
    
    private void JumpToSettings() {            
      	CmpManager.Instance.JumpToSettings();        
    }        
    
    private void HasVendorConsent(string vendorId) {            
      	var hasConsent = CmpManager.Instance.HasVendorConsent(vendorId);            
      	Debug.Log($"Has vendor consent: {hasConsent}");        
    }        
    
    private void HasPurposeConsent(string purposeId) {            
      	var hasConsent = CmpManager.Instance.HasPurposeConsent(purposeId);            
      	Debug.Log($"Has purpose consent: {hasConsent}");        
    }

    Inicio de sesión

    Al utilizar nuestro SDK de iOS, es posible que necesite depurar o analizar información de registro para diversos fines. Los registros generados por nuestro SDK están etiquetados como "CMP", lo que le permite filtrar y ver fácilmente solo los registros relevantes. Para obtener más información, consulte esta sección de nuestra documentación.

     

    Volver