Visão geral da biblioteca JavaScript de privacidade do Adobe

Como processador de dados, a Adobe processa dados pessoais de acordo com a permissão e as instruções de sua empresa. Como o controlador de dados, você determinará os dados pessoais que a Adobe processa e armazena em seu nome. Dependendo das informações que você escolher enviar pelas soluções da Adobe Experience Cloud, o Adobe pode armazenar informações privadas aplicáveis a regulamentos de privacidade, como o General Data Protection Regulation (GDPR) e California Consumer Privacy Act (CCPA). Consulte o documento sobre privacidade no Adobe Experience Cloud para obter mais informações sobre como as soluções Experience Cloud coletam dados privados.

A variável Biblioteca JavaScript de Privacidade Adobe permite que os controladores de dados automatizem a recuperação de todas as identidades de titulares de dados geradas pelo Experience Cloud para um domínio específico. O uso da API fornecida por Adobe Experience Platform Privacy Service, essas identidades podem ser usadas para criar, acessar e excluir solicitações de dados privados pertencentes a esses titulares de dados.

Funções

A variável Privacy JS Library O fornece várias funções para gerenciar identidades no Privacy Service. Essas funções só podem ser usadas para gerenciar as identidades armazenadas no navegador para um visitante específico. Elas não podem ser usadas para enviar informações para o Experience Cloud Central Service diretamente.

A tabela a seguir descreve as diferentes funções fornecidas pela biblioteca:

Como todas as três funções representam processos assíncronos, qualquer identidade recuperada deve ser tratada usando retornos de chamada ou promessas.

Instalação

Para começar a usar o Privacy JS Library, você deve instalá-lo em sua máquina usando um dos seguintes métodos:

Também é possível instalar a biblioteca por meio de uma extensão de tag. Consulte a visão geral no Extensão de tag de privacidade do Adobe para obter mais informações.

Instanciar o Privacy JS Library

Todos os aplicativos que utilizam o Privacy JS Library deve instanciar um novo AdobePrivacy objeto, que deve ser configurado para uma solução de Adobe específica. Por exemplo, uma instanciação do Adobe Analytics seria semelhante ao seguinte:

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

Para obter uma lista completa dos parâmetros suportados para as diferentes soluções de Adobe, consulte a seção do apêndice sobre os parâmetros suportados Parâmetros de configuração da solução Adobe.

Amostras de código samples

As amostras de código a seguir demonstram como usar o Privacy JS Library para vários cenários comuns, desde que você não esteja usando tags.

Recuperar identidades

Este exemplo demonstra como recuperar uma lista de identidades de Experience Cloud.

JavaScript

O código a seguir define uma função, handleRetrievedIDs, para ser usado como um retorno de chamada ou promessa para lidar com as identidades recuperadas pelo 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

Se o código for executado com sucesso, validIDs é preenchida com uma 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"
}

Remover identidades

Este exemplo demonstra como remover uma lista de identidades do navegador.

JavaScript

O código a seguir define uma função, handleRemovedIDs, para ser usado como um retorno de chamada ou promessa para lidar com as identidades recuperadas pelo removeIdentities após serem removidos do navegador.

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

Se o código for executado com sucesso, validIDs é preenchida com uma 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
}

Próximas etapas

Ao ler este documento, você foi apresentado às funcionalidades principais do Privacy JS Library. Depois de usar a biblioteca para recuperar uma lista de identidades, você pode usar essas identidades para criar acesso aos dados e excluir solicitações para a Privacy Service API. Consulte a Guia da API do Privacy Service para obter mais informações.

Apêndice

Esta seção contém informações adicionais para usar o Privacy JS Library.

Parâmetros de configuração da solução Adobe config-params

Veja a seguir uma lista dos parâmetros de configuração aceitos para as soluções de Adobe compatíveis, usadas quando instanciar um objeto do Adobe Privacy.

Todas as soluções

Adobe Analytics

Adobe Audience Manager

Serviço de identidade da Adobe Experience Cloud (ECID)

Adobe Target