Información general sobre Adobe Privacy JavaScript Library

Como procesador de datos, el Adobe procesa los datos personales de acuerdo con los permisos e instrucciones que su empresa proporcione. Como responsable del tratamiento de datos, usted determina los datos personales que el Adobe trata y almacena en su nombre. Según la información que decida enviar a través de las soluciones de Adobe Experience Cloud, el Adobe puede almacenar información privada aplicable a las regulaciones de privacidad como General Data Protection Regulation (RGPD) y California Consumer Privacy Act (CCPA). Consulte el documento sobre la privacidad en Adobe Experience Cloud para obtener más información sobre cómo las soluciones de Experience Cloud recopilan datos privados.

La Biblioteca JavaScript de privacidad de Adobe permite a los controladores de datos automatizar la recuperación de todas las identidades de sujetos de datos generadas por las soluciones de Experience Cloud para un dominio específico. Usando la API proporcionada por Adobe Experience Platform Privacy Service, estas identidades se pueden usar para crear solicitudes de acceso y eliminación de datos privados que pertenecen a esos interesados.

Funciones

Privacy JS Library proporciona varias funciones para administrar identidades en Privacy Service. Estas funciones solo se pueden utilizar para administrar las identidades almacenadas en el explorador para un visitante específico. No se pueden usar para enviar información directamente a Experience Cloud Central Service.

En la tabla siguiente se describen las diferentes funciones que proporciona la biblioteca:

Dado que las tres funciones representan procesos asincrónicos, cualquier identidad recuperada debe gestionarse mediante llamadas de retorno o promesas.

Instalación

Para empezar a usar Privacy JS Library, debe instalarlo en el equipo mediante uno de los métodos siguientes:

También puede instalar la biblioteca mediante una extensión de etiqueta. Consulte la descripción general de la extensión de Adobe de privacidad para obtener más información.

Crear una instancia de Privacy JS Library

Todas las aplicaciones que usan Privacy JS Library deben crear una instancia de un nuevo objeto AdobePrivacy, que debe configurarse para una solución de Adobe específica. Por ejemplo, una instancia para Adobe Analytics tendría un aspecto similar al siguiente:

var adobePrivacy = new AdobePrivacy({
    imsOrgID: "{ORG_ID}",
    reportSuite: "{REPORT_SUITE_ID}",
    trackingServer: "{SERVER_URL}",
    clientCode: "{TARGET_CLIENT_CODE}"
});

Para obtener una lista completa de los parámetros admitidos para las distintas soluciones de Adobe, consulte la sección del apéndice sobre parámetros de configuración de la solución de Adobe admitidos.

Muestras de código samples

Los siguientes ejemplos de código muestran cómo utilizar Privacy JS Library en varios escenarios comunes, siempre que no utilice etiquetas.

Recuperar identidades

Este ejemplo muestra cómo recuperar una lista de identidades de Experience Cloud.

JavaScript

El siguiente código define una función, handleRetrievedIDs, que se utilizará como llamada de retorno o como promesa para gestionar las identidades recuperadas por retrieveIdentities.

function handleRetrievedIDs(ids) {
    const validIDs = ids.validIDs;
    const failedIDs = ids.failedIDs;
}

// If using callbacks:
adobePrivacy.retrieveIdentities(handleRetrievedIDs);

// If using promises:
adobePrivacy.retrieveIdentities().then(handleRetrievedIDs);

Resultado

Si el código se ejecuta correctamente, validIDs se rellena con una lista de identidades recuperadas.

{
    "company": "adobe",
    "namespace": "ECID",
    "namespaceId": 4,
    "type": "standard",
    "name": "Experience Cloud ID",
    "description": "This is the ID generated by the ID Service.",
    "value": "79352169365966186342525781172209986543"
},
{
    "company": "adobe",
    "namespace": "gsurfer_id",
    "namespaceId": 411,
    "type": "standard",
    "value": "WqmIJQAAB669Ciao"
}

Eliminar identidades

En este ejemplo se muestra cómo quitar una lista de identidades del explorador.

JavaScript

El siguiente código define una función, handleRemovedIDs, que se utilizará como llamada de retorno o promesa para gestionar las identidades recuperadas por removeIdentities después de que se hayan eliminado del explorador.

function handleRemovedIDs(ids) {
    const validIDs = ids.validIDs;
    const failedIDs = ids.failedIDs;
}

// If using callbacks:
adobePrivacy.removeIdentities(handleRemovedIDs);

// If using promises:
adobePrivacy.removeIdentities().then(handleRemovedIDs)…

Resultado

Si el código se ejecuta correctamente, validIDs se rellena con una lista de identidades recuperadas.

{
    "company": "adobe",
    "namespace": "ECID",
    "namespaceId": 4,
    "type": "standard",
    "name": "Experience Cloud ID",
    "description": "This is the ID generated by the ID Service.",
    "value": "79352169365966186342525781172209986543",
    "isDeletedClientSide": false
},
{
    "company": "adobe",
    "namespace": "AMO",
    "namespaceId": 411,
    "type": "standard",
    "value": "WqmIJQAAB669Ciao",
    "isDeletedClientSide": true
}

Pasos siguientes

Al leer este documento, se le han presentado las funcionalidades principales de Privacy JS Library. Después de usar la biblioteca para recuperar una lista de identidades, puede usar esas identidades para crear solicitudes de acceso a datos y eliminación para la API Privacy Service. Consulte la guía de API de Privacy Service para obtener más información.

Apéndice

Esta sección contiene información complementaria para utilizar Privacy JS Library.

Parámetros de configuración de solución de Adobe config-params

A continuación se muestra una lista de los parámetros de configuración aceptados para las soluciones de Adobe admitidas que se usaron al crear una instancia de un objeto AdobePrivacy.

Todas las soluciones

Adobe Analytics

Adobe Audience Manager

Servicio de identidad de Adobe Experience Cloud (ECID)

Adobe Target