Información general sobre la biblioteca JavaScript de Adobe Privacy

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, determinará qué datos personales 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 normas de privacidad como la General Data Protection Regulation (RGPD) y California Consumer Privacy Act (CCPA). Consulte el documento sobre privacidad en Adobe Experience Cloud para obtener más información sobre cómo las soluciones de Experience Cloud recopilan datos privados.

El Biblioteca JavaScript de privacidad de Adobe permite a los responsables del tratamiento de datos automatizar la recuperación de todas las identidades de los interesados generadas por Experience Cloud soluciones para un dominio específico. Uso de la API proporcionada por Adobe Experience Platform Privacy ServiceSin embargo, estas identidades se pueden utilizar para crear solicitudes de acceso y eliminación de datos privados que pertenezcan a dichos interesados.

Funciones

El 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 utilizar para enviar información al Experience Cloud Central Service directamente.

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 utilizar Privacy JS Library, debe instalarlo en su equipo mediante uno de los siguientes métodos:

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

Crear una instancia de Privacy JS Library

Todas las aplicaciones que utilizan Privacy JS Library debe crear una instancia nueva AdobePrivacy objeto, 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 diferentes soluciones de Adobe, consulte la sección del apéndice sobre Parámetros de configuración de solución de Adobe.

Ejemplos de código samples

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

Recuperar identidades

En este ejemplo se muestra cómo recuperar una lista de identidades de Experience Cloud.

JavaScript

El siguiente código define una función, handleRetrievedIDs, para utilizarse 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, para utilizarse como llamada de retorno o como promesa para gestionar las identidades recuperadas por removeIdentities después de haberlas 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 introducido las funcionalidades básicas de la Privacy JS Library. Después de utilizar la biblioteca para recuperar una lista de identidades, puede utilizarlas para crear solicitudes de acceso a datos y eliminación en Privacy Service API. 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 la variable 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 utilizan cuando creación de instancias de un objeto AdobePrivacy.

Todas las soluciones

Adobe Analytics

Adobe Audience Manager

Servicio de identidad de Adobe Experience Cloud (ECID)

Adobe Target