[Reaccionar nativo] 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. Para ver nuestra aplicación de demostración que muestra los casos de uso y una implementación que podría servir como punto de partida, consulte Nuestro repositorio.
1. Instalación
El consentmanager El SDK para aplicaciones de iOS implementa y proporciona funcionalidad para informar al usuario sobre la protección de datos y solicitar y obtener el consentimiento del usuario. Permite a los desarrolladores de aplicaciones integrar fácilmente consentmanager servicio en su aplicación.
Pasos: descripción de alto nivel
-
Integración y Configuración:
- Integre el SDK en su aplicación.
- Configure los ajustes del SDK según sus necesidades.
-
Creando una instancia:
- Al iniciar la aplicación, cree una instancia de
CMPConsentToolclase. Esta instancia se encargará del proceso de consentimiento.
- Al iniciar la aplicación, cree una instancia de
-
Inicialización del SDK:
- Una vez que la instancia está lista, el SDK recupera automáticamente la información necesaria del consentmanager servidores para prepararse para su funcionamiento.
-
Mostrar la pantalla de consentimiento:
- El SDK mostrará automáticamente la pantalla de consentimiento si es necesario cuando el
CMPConsentToolSe crea la instancia.
- El SDK mostrará automáticamente la pantalla de consentimiento si es necesario cuando el
-
Procesamiento de datos personales:
- Una vez que se recopilan los consentimientos, la información se almacena y está disponible para consultar a través de diferentes propiedades y métodos expuestos por nuestro SDK. Dispondrás de información sobre consentimientos rechazados o aceptados, proveedores, finalidades, etc.
Al seguir estos pasos, se asegura de que su aplicación cumpla con los requisitos de consentimiento y que el consentimiento del usuario se administre y almacene adecuadamente.
Consent Manager Diagrama de secuencia del SDK del proveedor
Para ilustrar los pasos anteriores, revisemos en el diagrama siguiente tres posibles flujos de secuencia del SDK.
1. Al crear una instancia usando el inicializar función, hay dos resultados posibles. La primera es cuando la API de consentmanger informa al SDK que el CMP no se abrirá, lo que desencadena el OnCmpNotOpenedDevolución de llamada. El segundo resultado es cuando se abre la capa de consentimiento, lo que permite al usuario interactuar con ella, y esto desencadena la Al abrir devolución de llamada. Una vez que el usuario da su consentimiento y se procesa el consentimiento, el OnCmpCloseDevolución de llamada se llama.
Tenga en cuenta que la Devolución de llamada en error está representado por las líneas de flechas discontinuas rojas para proporcionar ejemplos de cuándo pueden ocurrir errores durante el proceso.
2. Creando una instancia y llamando al abrir y comprobar el consentimiento funciones conducirán a un proceso similar. La diferencia es que al desacoplar la creación de la instancia y la verificación de la API de consentmanger, obtiene la capacidad de agregar lógica empresarial e interactuar con la API de las bibliotecas.
3. Creando una instancia y llamando al capa abierta La función abrirá la capa sin verificar el consentmanager, si es necesario. Si ya se ha dado el consentimiento, se mostrarán las opciones y configuraciones al usuario. El flujo del proceso se verá así:
Para obtener más información sobre nuestra descripción general de la versión del SDK y el registro de cambios, consulte este enlace.
Instalación mediante NPM
npm install cmp-sdkVinculación (React Native 0.59 y versiones anteriores)
Si está utilizando React Native 0.59 o inferior, debe vincular los módulos nativos manualmente:
react-native link cmp-sdkImportar el Consentmanager de la cmp-sdk paquete en su código:
import { Consentmanager } from 'cmp-sdk';2. Inicializando el SDK
Puede inicializar el SDK de CMP mediante la configuración directa o un objeto de configuración:
Inicialización directa:
Consentmanager.createInstance('Code-ID from consentmanager, e.g. bfa712361a....',
'Server-Domain from consentmanager, e.g. delivery.consentmanager.net',
'App Name, e.g. MyReactApp',
'Language, e.g. FR');Inicialización utilizando el objeto de configuración:
Consentmanager.createInstanceByConfig(yourConfigObject);3. Usando el SDK
Para gestionar la capa de consentimiento:
Abrir capa de consentimiento:
Consentmanager.openConsentlayer();Manejo de eventos
Agregue detectores de eventos para manejar varios eventos relacionados con el consentimiento:
const removeListeners = Consentmanager.addEventListeners({
onOpen: () => console.log('Consent layer opened'),
onClose: () => console.log('Consent layer closed'),
// Add other event handlers as needed
});
Recuerde eliminar los detectores de eventos cuando ya no sean necesarios:
removeListeners();Consultas de consentimiento
Puede verificar los consentimientos del proveedor y del propósito:
Verifique el consentimiento del proveedor:
Consentmanager.hasVendor('vendorID').then((hasConsent) => {
console.log('Has vendor consent: ', hasConsent);
});Verificar el consentimiento del propósito:
Consentmanager.hasPurpose('purposeID').then((hasConsent) => {
console.log('Has purpose consent: ', hasConsent);
});Restablecer el consentimiento
Consentmanager.reset();Exportación de cadena de consentimiento
Consentmanager.exportCmpString().then((cmpString) => {
console.log('CMP String: ', cmpString);
});Métodos adicionales
El SDK de CMP proporciona varios métodos para recuperar o gestionar datos de consentimiento, como por ejemplo:
getAllVendors()getAllPurposes()getEnabledVendors()getEnabledPurposes()getDisabledVendors()getDisabledPurposes()getUSPrivacyString()getGoogleACString()
Consulte la documentación del SDK para obtener información detallada sobre estos métodos.
