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

Adobe은 데이터 처리자로서 귀사의 허가 및 지침에 따라 개인 데이터를 처리합니다. 귀하는 데이터 관리자로서 Adobe이 귀하를 대신하여 처리하고 저장하는 개인 데이터를 결정합니다. Adobe Experience Cloud 솔루션을 통해 보내도록 선택한 정보에 따라 Adobe은 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를 사용하여 해당 데이터 주체에 속하는 개인 데이터에 대한 액세스 및 삭제 요청을 만드는 데 사용할 수 있습니다.

함수

Privacy JS Library은(는) Privacy Service에서 ID를 관리하기 위한 몇 가지 기능을 제공합니다. 이러한 함수는 특정 방문자의 브라우저에 저장된 ID를 관리하는 데만 사용할 수 있습니다. Experience Cloud Central Service에 직접 정보를 제출하는 데 사용할 수 없습니다.

다음 표에서는 라이브러리에서 제공하는 다양한 기능에 대해 설명합니다.

세 함수 모두 비동기 프로세스를 나타내므로, 콜백이나 약속을 사용하여 검색된 모든 ID를 처리해야 합니다.

설치

Privacy JS Library을(를) 사용하려면 다음 방법 중 하나를 사용하여 컴퓨터에 설치해야 합니다.

태그 확장을 통해 라이브러리를 설치할 수도 있습니다. 자세한 내용은 Adobe 개인 정보 보호 태그 확장에 대한 개요를 참조하십시오.

Privacy JS Library 인스턴스화

Privacy JS Library을(를) 사용하는 모든 앱은 새 AdobePrivacy 개체를 인스턴스화해야 하며, 이 개체는 특정 Adobe 솔루션에 구성해야 합니다. 예를 들어 Adobe Analytics에 대한 인스턴스화는 다음과 유사합니다.

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

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

코드 샘플 samples

다음 코드 샘플은 태그를 사용하지 않는 경우 몇 가지 일반적인 시나리오에 Privacy JS Library을(를) 사용하는 방법을 보여 줍니다.

ID 검색

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

JavaScript

다음 코드는 retrieveIdentities이(가) 검색한 ID를 처리하기 위한 콜백 또는 약속으로 사용할 함수 handleRetrievedIDs을(를) 정의합니다.

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 목록으로 채워집니다.

{
    "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

다음 코드는 removeIdentities이(가) 검색한 ID를 브라우저에서 제거한 후 해당 ID를 처리하기 위한 콜백 또는 약속으로 사용할 함수 handleRemovedIDs을(를) 정의합니다.

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 목록으로 채워집니다.

{
    "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 API 안내서를 참조하십시오.

부록

이 섹션에는 Privacy JS Library 사용에 대한 추가 정보가 포함되어 있습니다.

Adobe 솔루션 구성 매개 변수 config-params

다음은 AdobePrivacy 개체를 인스턴스화할 때 사용되는 지원되는 Adobe 솔루션에 대해 허용되는 구성 매개 변수의 목록입니다.

모든 솔루션

Adobe Analytics

Adobe Audience Manager

ECID(Adobe Experience Cloud Identity Service)

Adobe Target