Show Menu
TEMAS×

Información general sobre la biblioteca JavaScript de privacidad de Adobe

Como procesador de datos, Adobe procesa los datos personales de acuerdo con las instrucciones y los permisos de su compañía. Como responsable del tratamiento de datos, determinará qué datos personales Adobe trata y almacena en su nombre. Según la información que elija enviar a través de las soluciones de Adobe Experience Cloud, Adobe puede almacenar información privada aplicable a las normativas de privacidad, como el Reglamento General de Protección de Datos (RGPD) y la Ley de privacidad del consumidor de California (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.
La biblioteca JavaScript de privacidad de Adobe permite a los controladores de datos automatizar la recuperación de todas las identidades de sujeto de datos generadas por las soluciones de Experience Cloud para un dominio específico. Mediante la API proporcionada por Adobe Experience Platform Privacy Service , estas identidades se pueden utilizar para crear solicitudes de acceso y eliminación de datos privados pertenecientes a dichos temas.
La Biblioteca de JS de privacidad generalmente solo necesita instalarse en páginas relacionadas con la privacidad y no es necesario que esté instalada en todas las páginas de un sitio web o dominio.

Funciones

La Biblioteca de JS de privacidad proporciona varias funciones para administrar identidades en Privacy Service. Estas funciones solo se pueden usar para administrar las identidades almacenadas en el navegador para un visitante específico. No se pueden usar para enviar información directamente al servicio central de Experience Cloud.
La siguiente tabla describe las diferentes funciones proporcionadas por la biblioteca:
Función
Descripción
retrieveIdentities
Devuelve una matriz de identidades coincidentes ( validIds ) que se recuperaron de Privacy Service, así como una matriz de identidades que no se encontraron ( failedIds ).
removeIdentities
Quita cada identidad coincidente (válida) del explorador. Devuelve una matriz de identidades coincidentes ( validIds ), con cada identidad que contiene un valor isDeleteClientSide booleano que indica si este ID se ha eliminado.
retrieveThenRemoveIdentities
Recupera una matriz de identidades coincidentes ( validIds ) y, a continuación, elimina dichas identidades del explorador. Aunque esta función es similar a removeIdentities , es mejor utilizarla cuando la solución de Adobe que está utilizando requiere una solicitud de acceso antes de poder eliminarla (por ejemplo, cuando se debe recuperar un identificador único antes de proporcionarlo en una solicitud de eliminación).
removeIdentities y retrieveThenRemoveIdentities solo elimine identidades del navegador para soluciones específicas de Adobe que las admitan. Por ejemplo, Adobe Audiencia Manager no elimina los ID de demdex almacenados en cookies de terceros, mientras que Adobe Destinatario elimina todas las cookies que almacenan sus ID.
Dado que las tres funciones representan procesos asincrónicos, cualquier identidad recuperada debe gestionarse mediante rellamadas o promesas.

Instalación

Para realizar inicios con la biblioteca de privacidad de JS, debe instalarla en el equipo mediante uno de los siguientes métodos:

Crear una instancia de la biblioteca de privacidad de JS

Todas las aplicaciones que utilicen la biblioteca de JS de privacidad deben crear una instancia de un AdobePrivacy objeto nuevo, que debe configurarse en una solución de Adobe específica. Por ejemplo, una instancia de Adobe Analytics tendría un aspecto similar al siguiente:
var adobePrivacy = new AdobePrivacy({
    imsOrgID: "{IMS_ORG}",
    key: "{DATA_SUBJECT_ID}",
    reportSuite: "{REPORT_SUITE_ID}",
    trackingServer: "{SERVER_URL}",
    clientCode: "{TARGET_CLIENT_CODE}"
});

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

Ejemplos de código

Los siguientes ejemplos de código muestran cómo utilizar la biblioteca de privacidad de JS en varios casos comunes, siempre que no utilice Launch o DTM.

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 , que se utilizará como llamada de retorno o 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);

Variable
Descripción
validIds
Un objeto JSON que contiene todos los ID que se recuperaron correctamente.
failedIDs
Un objeto JSON que contiene todos los ID que no se recuperaron de Privacy Service o que no se encontraron.

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

Este ejemplo muestra cómo eliminar 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 haber sido eliminadas 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)…

Variable
Descripción
validIds
Un objeto JSON que contiene todos los ID que se recuperaron correctamente.
failedIDs
Un objeto JSON que contiene todos los ID que no se recuperaron de Privacy Service o que no se encontraron.

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 principales funcionalidades de la Biblioteca de JS de privacidad. Después de utilizar la biblioteca para recuperar una lista de identidades, puede utilizarlas para crear acceso a datos y eliminar solicitudes a la API de Privacy Service. Consulte la guía para desarrolladores de Privacy Service para obtener más información.

Apéndice

Esta sección contiene información adicional sobre el uso de la Biblioteca de JS de privacidad.

Parámetros de configuración de la solución Adobe

A continuación se muestra una lista de los parámetros de configuración aceptados para las soluciones de Adobe admitidas, que se utilizan al crear una instancia de un objeto AdobePrivacy.
Adobe Analytics
Parámetro
Descripción
cookieDomainPeriods
Períodos numéricos en un dominio para el seguimiento de cookies (el valor predeterminado es 2).
dataCenter
Centro de datos de recopilación de datos de Adobe. Esto solo debe incluirse si se especifica en la señalización web JavaScript. Los valores posibles son:
  • "d1": Centro de datos de San José.
  • "d2": Centro de datos de Dallas.
reportSuite
ID del grupo de informes tal como se especifica en la señalización web JavaScript (por ejemplo, "s_code.js" o "dtm").
trackingServer
Dominio de recopilación de datos (no SSL). Esto solo debe incluirse si se especifica en la señalización web JavaScript.
trackingServerSecure
Dominio de recopilación de datos (SSL). Esto solo debe incluirse si se especifica en la señalización web JavaScript.
visitorNamespace
Área de nombres utilizada para agrupar visitantes. Esto solo debe incluirse si se especifica en la señalización web JavaScript.
Adobe Target
Parámetro
Descripción
clientCode
Código de cliente que identifica a un cliente en Adobe Destinatario System.
Adobe Audience Manager
Parámetro
Descripción
aamUUIDCookieName
Nombre de la cookie de origen que contiene el ID de usuario único devuelto por el Administrador de Audiencias de Adobe.
Servicio de ID de Adobe (ECID)
Parámetro
Descripción
imsOrgID
Su identificador de organización de IMS.