Show Menu
화제×

Adobe 개인 정보 보호 JavaScript 라이브러리 개요

데이터 프로세서로서 Adobe은 회사의 허가와 지침에 따라 개인 데이터를 처리합니다. 귀하는 데이터 제어자로서 Adobe가 귀하를 대신하여 처리하고 저장하는 개인 데이터를 결정합니다. Adobe은 Adobe Experience Cloud 솔루션을 통해 전송하는 정보에 따라 General Data Protection Regulation (GDPR) 및 California Consumer Privacy Act (CCPA)와 같은 개인 정보 보호 규정에 적용되는 개인 정보를 저장할 수 있습니다. Experience Cloud 솔루션이 개인 데이터를 수집하는 방법에 대한 자세한 내용은 Adobe Experience Cloud의 개인 정보 보호 문서를 참조하십시오.
데이터 관리자는 Adobe 개인 정보 보호 JavaScript 라이브러리를 사용하여 특정 도메인에 대한 Experience Cloud 솔루션에서 생성된 모든 데이터 주체 ID의 검색을 자동화할 수 있습니다. 그런 다음 Adobe Experience Platform Privacy Service 에서 제공하는 API를 사용하여 이러한 ID를 사용하여 해당 데이터 대상에 속하는 개인 데이터에 대한 액세스 및 삭제 요청을 만들 수 있습니다.
일반적으로 이 소프트웨어는 개인 정보 관련 페이지에만 설치되어야 하며 웹 사이트 또는 도메인의 모든 페이지에 설치되어야 하는 것은 아닙니다. Privacy JS Library

함수

ID Privacy JS Library 를 관리하는 데 몇 가지 기능을 제공합니다 Privacy Service. 이러한 기능은 특정 방문자를 위해 브라우저에 저장된 ID를 관리하는 데에만 사용할 수 있습니다. 정보를 Experience Cloud Central Service 직접 제출하는데 사용할 수 없습니다.
다음 표에서는 라이브러리에서 제공하는 다양한 기능에 대해 간략히 설명합니다.
함수
설명
retrieveIdentities
에서 검색된 일치하는 ID( validIds )와 Privacy Service발견되지 않은 ID 배열( failedIds )을 반환합니다.
removeIdentities
브라우저에서 일치하는 각 ID를 제거합니다. 이 ID가 삭제되었는지 여부를 나타내는 validIds isDeleteClientSide 부울을 포함하는 각 ID와 일치하는 ID(Matching ID)의 배열을 반환합니다.
retrieveThenRemoveIdentities
일치하는 ID( validIds )의 배열을 검색한 다음 브라우저에서 해당 ID를 제거합니다. 이 기능은 유사한 기능이지만, 삭제하기 전에 사용 중인 Adobe 솔루션에 액세스 요청이 필요한 경우(예: 삭제 요청에 제공하기 전에 고유 식별자를 검색해야 하는 경우) 가장 많이 사용됩니다. removeIdentities
removeIdentities 브라우저에서 ID만 retrieveThenRemoveIdentities 제거할 수 있습니다. 예를 들어, Adobe Audience Manager은 타사 쿠키에 저장된 demdex ID를 삭제하지 않고 Adobe Target은 해당 ID를 저장하는 모든 쿠키를 삭제합니다.
세 가지 기능이 모두 비동기 프로세스를 나타내므로 검색된 모든 ID는 콜백이나 약속을 사용하여 처리해야 합니다.

설치

이 소프트웨어를 사용하려면 다음 방법 Privacy JS Library중 하나를 사용하여 컴퓨터에 설치해야 합니다.
  • 다음 명령을 실행하여 npm을 사용하여 설치합니다. npm install @adobe/adobe-privacy
  • 이름 아래에 있는 Adobe 실행 확장 사용 AdobePrivacy
  • https://github.com/Adobe-Marketing-Cloud/adobe-privacy에서 다운로드

인스턴스화 Privacy JS Library

이 변수를 사용하는 모든 앱은 Privacy JS Library 특정 Adobe 솔루션으로 구성해야 하는 새 AdobePrivacy 개체를 인스턴스화해야 합니다. 예를 들어 Adobe Analytics 인스턴스화는 다음과 비슷합니다.
var adobePrivacy = new AdobePrivacy({
    imsOrgID: "{IMS_ORG}",
    key: "{DATA_SUBJECT_ID}",
    reportSuite: "{REPORT_SUITE_ID}",
    trackingServer: "{SERVER_URL}",
    clientCode: "{TARGET_CLIENT_CODE}"
});

다양한 Adobe 솔루션에 대해 지원되는 매개 변수의 전체 목록은 지원되는 Adobe 솔루션 구성 매개 변수에 대한 부록 섹션을 참조하십시오 .

코드 샘플

다음 코드 샘플에서는 DTM을 사용하지 않는 경우 여러 가지 일반적인 시나리오에 대해 Privacy JS Library 를 사용하는 방법을 Launch 보여 줍니다.

ID 검색

이 예에서는 ID 목록을 검색하는 방법을 보여 줍니다 Experience Cloud.

JavaScript

다음 코드는 콜백이나 handleRetrievedIDs 로 검색된 ID를 처리하기 위한 약속으로 사용할 함수를 정의합니다 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);

변수
설명
validIds
검색된 모든 ID가 포함된 JSON 개체입니다.
failedIDs
검색되지 않았거나 찾을 수 없는 모든 ID가 포함된 JSON 개체 Privacy Service를 찾을 수 없습니다.

결과

코드가 성공적으로 실행되면 검색된 ID 목록 validIDs 으로 채워집니다.
{
    "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"
}

ID 제거

이 예에서는 브라우저에서 ID 목록을 제거하는 방법을 보여 줍니다.

JavaScript

다음 코드는 브라우저에서 제거된 ID handleRemovedIDs removeIdentities 를 처리하기 위해 콜백 또는 약속으로 사용되는 함수를 정의합니다.
function handleRemovedIDs(ids) {
    const validIDs = ids.validIDs;
    const failedIDs = ids.failedIDs;
}

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

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

변수
설명
validIds
검색된 모든 ID가 포함된 JSON 개체입니다.
failedIDs
검색되지 않았거나 찾을 수 없는 모든 ID가 포함된 JSON 개체 Privacy Service를 찾을 수 없습니다.

결과

코드가 성공적으로 실행되면 검색된 ID 목록 validIDs 으로 채워집니다.
{
    "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
}

다음 단계

이 문서를 읽음으로써, 당신은 이 회사의 핵심 기능에 익숙해졌다 Privacy JS Library. 라이브러리를 사용하여 ID 목록을 검색한 후 이러한 ID를 사용하여 데이터 액세스를 만들고 Privacy Service API에 대한 요청을 삭제할 수 있습니다. 자세한 내용은 Privacy Service 개발자 안내서를 참조하십시오.

부록

이 섹션에는 해당 항목을 사용하기 위한 보충 정보가 포함되어 있습니다 Privacy JS Library.

Adobe 솔루션 구성 매개 변수

다음은 AdobePrivacy 개체를 인스턴스화할 때 사용되는 지원되는 Adobe 솔루션에 대해 허용된 구성 매개 변수 목록입니다 .
Adobe Analytics
매개 변수
설명
cookieDomainPeriods
쿠키 추적을 위한 도메인의 기간 수(기본값은 2).
dataCenter
Adobe 데이터 수집 데이터 센터 이 값은 JavaScript 웹 비콘에 지정된 경우에만 포함되어야 합니다. 잠재적 값은 다음과 같습니다.
  • "d1": San Jose 데이터 센터.
  • "d2": 달라스 데이터 센터
reportSuite
JavaScript 웹 비콘에 지정된 보고서 세트 ID(예: "s_code.js" 또는 "dtm").
trackingServer
데이터 수집 도메인(SSL이 아님). 이 값은 JavaScript 웹 비콘에 지정된 경우에만 포함되어야 합니다.
trackingServerSecure
데이터 수집 도메인(SSL). 이 값은 JavaScript 웹 비콘에 지정된 경우에만 포함되어야 합니다.
visitorNamespace
방문자를 그룹화하는 데 사용되는 네임스페이스입니다. 이 값은 JavaScript 웹 비콘에 지정된 경우에만 포함되어야 합니다.
Adobe Target
매개 변수
설명
clientCode
Adobe Target 시스템에서 클라이언트를 식별하는 클라이언트 코드입니다.
Adobe Audience Manager
매개 변수
설명
aamUUIDCookieName
Adobe Audience Manager에서 반환된 고유 사용자 ID를 포함하는 퍼스트 파티 쿠키의 이름입니다.
Adobe ID 서비스(ECID)
매개 변수
설명
imsOrgID
IMS 조직 ID.