Visão geral da biblioteca JavaScript de privacidade do Adobe | Adobe Experience Platform
Visão geral da biblioteca JavaScript de privacidade do Adobe
Como processador de dados, o 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 por meio das soluções da Adobe Experience Cloud, o Adobe pode armazenar informações privadas aplicáveis às regulamentações de privacidade, como a General Data Protection Regulation (GDPR) e California Consumer Privacy Act (CCPA). Consulte o documento em privacidade na Adobe Experience Cloud para obter mais informações sobre como as soluções do Experience Cloud coletam dados privados.
O Biblioteca JavaScript de privacidade do Adobe permite que os controladores de dados automatizem a recuperação de todas as identidades do titular de dados geradas por Experience Cloud para um domínio específico. Uso da API fornecida por Adobe Experience Platform Privacy Service, essas identidades podem ser usadas para criar solicitações de acesso e exclusão de dados privados pertencentes a esses titulares de dados.
O Privacy JS Library O geralmente só precisa ser instalado em páginas relacionadas à privacidade e não precisa ser instalado em todas as páginas de um site ou domínio.
O 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 que são armazenadas no navegador para um visitante específico. Eles não podem ser usados para enviar informações para a Experience Cloud Central Service diretamente.
retrieveIdentities Retorna uma matriz de identidades correspondentes (validIds) que foram recuperados de Privacy Service, bem como uma matriz de identidades que não foram encontradas (failedIds).
removeIdentities Remove cada identidade (válida) correspondente do navegador. Retorna uma matriz de identidades correspondentes (validIds), com cada identidade contendo um isDeletedClientSide booleano que indica se essa ID foi excluída.
retrieveThenRemoveIdentities Recupera uma matriz de identidades correspondentes (validIds) e remove essas identidades do navegador. Embora essa função seja semelhante a removeIdentities, ele é melhor usado quando a solução Adobe que você está usando requer uma solicitação de acesso antes da exclusão ser possível (como quando um identificador exclusivo deve ser recuperado antes de fornecê-lo em uma solicitação de exclusão).
removeIdentities e retrieveThenRemoveIdentities remover somente identidades do navegador para soluções específicas do Adobe que as suportam. Por exemplo, o Adobe Audience Manager não exclui as IDs demdex armazenadas em cookies de terceiros, enquanto o Adobe Target exclui todos os cookies que armazenam suas IDs.
Como todas as três funções representam processos assíncronos, quaisquer identidades recuperadas devem ser tratadas usando retornos de chamada ou promessas.
Para começar a usar o Privacy JS Library, você deve instalá-lo em sua máquina usando um dos seguintes métodos:
Faça o download do Repositório GitHub do Experience Cloud
Você também pode instalar a biblioteca por meio de uma extensão de tag na interface do usuário da coleta de dados. Consulte a visão geral no Extensão de tag do Adobe Privacy para obter mais informações.
Todos os aplicativos que utilizam a variável Privacy JS Library deve instanciar um novo AdobePrivacy , que deve ser configurado para uma solução Adobe específica. Por exemplo, uma instanciação do Adobe Analytics seria semelhante ao seguinte:
Para obter uma lista completa dos parâmetros suportados para diferentes soluções de Adobe, consulte a seção de apêndice sobre os Parâmetros de configuração da solução Adobe.
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.
O código a seguir define uma função, handleRetrievedIDs, a utilizar como um retorno de chamada ou promessa para tratar as identidades recuperadas por retrieveIdentities.
validIds Um objeto JSON contendo todas as IDs que foram recuperadas com êxito.
failedIDs Um objeto JSON contendo todas as IDs que não foram recuperadas de Privacy Service, ou não foi possível encontrá-lo.
Se o código for executado com êxito, validIDs é preenchida com uma lista de identidades recuperadas.
O código a seguir define uma função, handleRemovedIDs, a utilizar como um retorno de chamada ou promessa para tratar as identidades recuperadas por removeIdentities após terem sido removidos do navegador.
Ao ler este documento, você foi introduzido nas 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.
Esta seção contém informações complementares sobre o uso da variável Privacy JS Library.
Veja a seguir uma lista dos parâmetros de configuração aceitos para soluções de Adobe compatíveis, usados quando instanciamento de um objeto do AdobePrivacy.
key Uma ID exclusiva que identifica o usuário ou o titular dos dados. Essa propriedade deve ser usada para fins de rastreamento interno e não é usada pelo Adobe.
cookieDomainPeriods O número de períodos em um domínio usado para rastreamento de cookies (o padrão é 2, por exemplo .domain.com). Não o defina aqui, a menos que especificado no beacon da Web do JavaScript.
dataCenter O data center de coleta de dados do Adobe. Isso só deve ser incluído se for especificado no beacon da Web do JavaScript. Os valores potenciais são:
d1: Data center de San Jose
d2: data center de Dallas
reportSuite A ID do conjunto de relatórios conforme especificado no beacon da Web do JavaScript (por exemplo, s_code.js ou dtm).
trackingServer Um domínio de coleta de dados não SSL. Isso só deve ser incluído se for especificado no beacon da Web do JavaScript.
trackingServerSecure Um domínio de coleta de dados SSL. Isso só deve ser incluído se for especificado no beacon da Web do JavaScript.
visitorNamespace O namespace usado para agrupar visitantes. Isso só deve ser incluído se for especificado no beacon da Web do JavaScript.
aamUUIDCookieName Nome do cookie primário contendo a ID de usuário exclusiva retornada do Adobe Audience Manager.