setConsent

setConsent 명령은 웹 SDK에 데이터를 전송하거나(옵트인), 데이터를 삭제하거나(옵트아웃), defaultConsent을(를) 사용해야 하는지(동의 알 수 없음) 알려줍니다.

웹 SDK는 다음 표준을 지원합니다.

이 명령을 사용하면 Web SDK는 쿠키에 사용자의 환경 설정을 기록합니다. 다음에 사용자가 브라우저에 웹 사이트를 로드할 때 SDK는 이러한 지속적인 환경 설정을 검색하여 Adobe에게 이벤트를 보낼 수 있는지 확인합니다.

Adobe은 모든 동의 대화 상자 환경 설정을 웹 SDK 동의와 별도로 저장할 것을 권장합니다. 웹 SDK는 동의를 검색하는 방법을 제공하지 않습니다. 사용자 환경 설정이 SDK와 계속 동기화되도록 하려면 페이지를 로드할 때마다 setConsent 명령을 호출할 수 있습니다. Web SDK는 동의를 변경할 때만 서버 호출을 수행합니다.

Web SDK는 두 개의 상호 보완적인 동의 구성 명령을 제공합니다.

  • defaultConsent: 이 명령은 Web SDK를 사용하는 Adobe 고객의 동의 환경 설정을 캡처하기 위한 것입니다.
  • setConsent: 이 명령은 사이트 방문자의 동의 환경 설정을 캡처하기 위한 것입니다.

이러한 설정을 함께 사용하면 구성된 값에 따라 데이터 수집 및 쿠키 설정 결과가 달라질 수 있습니다.

동의 설정을 기반으로 데이터 수집이 발생하는 시점과 쿠키가 설정되는 시점을 이해하려면 아래 표를 참조하십시오.

defaultConsent
setConsent
데이터 수집 발생
Web SDK가 브라우저 쿠키를 설정합니다.
in
in
in
out
아니요
in
설정되지 않음
pending
in
pending
out
아니요
pending
설정되지 않음
아니요
아니요
out
in
out
out
아니요
out
설정되지 않음
아니요
아니요

다음 쿠키는 동의 구성이 허용하면 설정됩니다.

이름
최대 나이
설명
AMCV_###@AdobeOrg
34128000(395일)
idMigrationEnabled이(가) 활성화된 경우 표시됩니다. 사이트의 일부 부분이 visitor.js을(를) 사용하는 동안 Web SDK로 전환하는 데 도움이 됩니다.
Demdex 쿠키
15552000(180일)
ID 동기화가 활성화된 경우 표시됩니다. Audience Manager은 사이트 방문자에게 고유 ID를 할당하도록 이 쿠키를 설정합니다. demdex 쿠키는 Audience Manger 가 방문자 식별, ID 동기화, 세그먼테이션, 모델링, 보고 등과 같은 기본 기능을 수행하는 데 도움이 됩니다.
kndctr_orgid_cluster
1800(30분)
현재 사용자의 요청을 처리하는 Edge Network 영역을 저장합니다. Edge Network이 요청을 올바른 영역으로 라우팅할 수 있도록 URL 경로에 영역이 사용됩니다. 사용자가 다른 IP 주소 또는 다른 세션에 연결하는 경우 요청이 다시 가장 가까운 영역으로 라우팅됩니다.
kndct_orgid_identity
34128000(395일)
ECID 및 ECID와 관련된 기타 정보를 저장합니다.
kndctr_orgid_consent
15552000(180일)
웹 사이트에 대한 사용자 동의 환경 설정을 저장합니다.
s_ecid
63115200(2년)
Experience Cloud ID(ECID) 또는 MID의 복사본을 포함합니다. MID는 s_ecid=MCMID|<ECID> 구문 뒤에 오는 키-값 쌍에 저장됩니다.

웹 SDK 태그 확장을 사용하여 동의 설정

동의 설정은 Adobe Experience Platform 데이터 수집 태그 인터페이스의 규칙 내에서 작업으로 수행됩니다.

  1. Adobe ID 자격 증명을 사용하여 experience.adobe.com에 로그인합니다.
  2. 데이터 수집 > 태그(으)로 이동합니다.
  3. 원하는 태그 속성을 선택합니다.
  4. 규칙(으)로 이동한 다음 원하는 규칙을 선택합니다.
  5. 작업에서 기존 작업을 선택하거나 작업을 만드십시오.
  6. 확장 드롭다운 필드를 Adobe Experience Platform Web SDK(으)로 설정하고 작업 유형을(를) 동의 설정(으)로 설정합니다.
  7. 표준일반 동의 ​를 포함하여 오른쪽에 원하는 필드를 설정하십시오.
  8. 변경 내용 유지 ​를 클릭한 다음 게시 워크플로우를 실행하십시오.

이 작업 내에 여러 동의 개체를 포함할 수 있습니다.

웹 SDK JavaScript 라이브러리를 사용하여 동의 설정

웹 SDK의 구성된 인스턴스를 호출할 때 setConsent 명령을 실행합니다. 이 명령에 다음 개체를 포함할 수 있습니다.

  • consent[]: consent 개체의 배열입니다. 동의 개체는 선택하는 표준 및 버전에 따라 다른 형식으로 지정됩니다. 동의 표준에 따라 각 동의 오브젝트의 예는 아래 탭을 참조하십시오.
  • identityMap: ECID 생성 방법과 연결된 ID 동의 정보를 제어하는 개체입니다. Adobe은 sendEvent과 같은 다른 명령보다 먼저 setConsent을(를) 실행할 때 이 개체를 포함할 것을 권장합니다.
  • edgeConfigOverrides: 데이터스트림 구성 재정의를 포함하는 개체입니다.
Adobe 2.0

Adobe Experience Platform을 사용하는 경우 프로필 스키마에 개인 정보 스키마 필드 그룹을 포함해야 합니다. Adobe 2.0 표준에 대한 자세한 내용은 Adobe Experience Platform의 거버넌스, 개인 정보 및 보안을 참조하십시오. 동의 및 환경 설정 프로필 필드 그룹의 consents 필드 스키마에 해당하는 아래 값 개체 내에 데이터를 추가할 수 있습니다.

  • standard: 선택한 동의 표준입니다. Adobe 2.0 표준에 대해 이 속성을 "Adobe"(으)로 설정합니다.

  • version: 동의 표준의 버전을 나타내는 문자열입니다. Adobe 2.0 표준에 대해 이 속성을 "2.0"(으)로 설정합니다.

  • value: 동의 값이 포함된 개체입니다.

    • value.collect.val: 동의 값입니다. 사용자가 옵트인할 때는 "y"(으)로 설정하고 사용자가 옵트아웃할 때는 "n"(으)로 설정합니다.
    • value.metadata.time: 사용자가 동의 설정을 마지막으로 업데이트한 타임스탬프.
code language-js
// Set consent using the Adobe 2.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "2.0",
    "value": {
      "collect": {
        "val": "y"
      },
      "metadata": {
        "time": "YYYY-03-17T15:48:42-07:00"
      }
    }
  }]
});
IAB TCF 2.0

IAB(Interactive Advertising Bureau Europe) TCF(Transparency and Consent Framework) 표준을 통해 제공된 사용자 동의 환경 설정을 기록하려면 아래와 같이 동의 문자열을 설정합니다.

이렇게 동의를 설정하면 실시간 고객 프로필이 동의 정보로 업데이트됩니다. 이를 수행하려면 프로필 XDM 스키마에 프로필 개인 정보 보호 스키마 필드 그룹이 있어야 합니다. 이벤트를 보낼 때 IAB 동의 정보를 이벤트 XDM 개체에 수동으로 추가해야 합니다. 웹 SDK는 이벤트에 동의 정보를 자동으로 포함하지 않습니다.

이벤트에서 동의 정보를 보내려면 Profile 사용 XDM ExperienceEvent 스키마에 경험 이벤트 개인 정보 보호 필드 그룹을 추가해야 합니다. 구성 방법에 대한 단계는 데이터 집합 준비 안내서의 ExperienceEvent 스키마 업데이트에 대한 섹션을 참조하십시오.

  • standard: 선택한 동의 표준입니다. IAB TCF 2.0 표준에 대해 이 속성을 "IAB TCF"(으)로 설정합니다.
  • version: 동의 표준의 버전을 나타내는 문자열입니다. IAB TCF 2.0 표준에 대해 이 속성을 "2.0"(으)로 설정합니다.
  • value: 동의 값이 포함된 문자열입니다.
  • gdprApplies: GDPR이 이 동의 값에 적용되는지 여부를 결정하는 부울입니다. 기본값은 true입니다.
  • gdprContainsPersonalData: 이 사용자와 연결된 이벤트 데이터에 개인 데이터가 포함되어 있는지 여부를 결정하는 부울입니다. 기본값은 false입니다.
code language-js
// Set consent using the IAB TCF 2.0 standard
alloy("setConsent", {
  consent: [{
    "standard": "IAB TCF",
    "version": "2.0",
    "value": "CO052l-O052l-DGAMBFRACBgAIBAAAAABIYgEawAQEagAAAA",
    "gdprApplies": true,
    "gdprContainsPersonalData": true
  }]
});
Adobe 1.0
  • standard: 선택한 동의 표준입니다. Adobe 1.0 표준에 대해 이 속성을 "Adobe"(으)로 설정합니다.
  • version: 동의 표준의 버전을 나타내는 문자열입니다. Adobe 1.0 표준에 대해 이 속성을 "1.0"(으)로 설정합니다.
  • value.general: 동의 값입니다. 사용자가 옵트인할 때는 "in"(으)로 설정하고 사용자가 옵트아웃할 때는 "out"(으)로 설정합니다.
code language-js
// Set consent using the Adobe 1.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "1.0",
    "value": {
      "general": "in"
    }
  }]
});

한 번의 요청으로 여러 표준 보내기 multiple-standards

또한 웹 SDK는 아래 예와 같이 요청에 두 개 이상의 동의 개체 전송을 지원합니다.

alloy("setConsent", {
    consent: [{
        standard: "Adobe",
        version: "2.0",
        value: {
            collect: {
                val: "y"
            },
            metadata: {
                time: "2021-03-17T15:48:42-07:00"
            }
        }
    }, {
        standard: "IAB TCF",
        version: "2.0",
        value: "CO1Z4yuO1Z4yuAcABBENArCsAP_AAH_AACiQGCNX_T5eb2vj-3Zdt_tkaYwf55y3o-wzhhaIse8NwIeH7BoGP2MwvBX4JiQCGBAkkiKBAQdtHGhcCQABgIhRiTKMYk2MjzNKJLJAilsbe0NYCD9mnsHT3ZCY70--u__7P3fAwQgkwVLwCRIWwgJJs0ohTABCOICpBwCUEIQEClhoACAnYFAR6gAAAIDAACAAAAEEEBAIABAAAkIgAAAEBAKACIBAACAEaAhAARIEAsAJEgCAAVA0JACKIIQBCDgwCjlACAoAAAAA.YAAAAAAAAAAA",
        gdprApplies: true
    }]
});

동의 환경 설정 지속성 persistence

setConsent 명령을 사용하여 사용자 환경 설정을 웹 SDK에 전달하면 SDK는 사용자 환경 설정을 쿠키에 유지합니다. 다음에 사용자가 브라우저에서 웹 사이트를 로드할 때 웹 SDK는 이러한 지속 환경 설정을 검색하여 사용하여 이벤트를 Adobe으로 보낼 수 있는지 여부를 결정합니다.

현재 환경 설정으로 동의 대화 상자를 표시할 수 있도록 사용자 환경 설정을 개별적으로 저장해야 합니다. 웹 SDK에서 사용자 환경 설정을 검색할 수 있는 방법이 없습니다. 사용자 환경 설정이 SDK와 계속 동기화되도록 하려면 페이지를 로드할 때마다 setConsent 명령을 호출할 수 있습니다. 웹 SDK는 기본 설정이 변경된 경우에만 서버를 호출합니다.

동의를 설정하는 동안 ID 동기화 sync-identities

기본 동의(defaultConsent 매개 변수를 통해 설정)가 pending 또는 out(으)로 설정된 경우 setConsent 설정이 ID를 설정하고 시작하는 첫 번째 요청일 수 있습니다. 이러한 이유로 첫 번째 요청에 대한 ID를 동기화하는 것이 중요할 수 있습니다. ID 맵을 sendEvent 명령에서와 같이 setConsent 명령에 추가할 수 있습니다. 명령에 ID 맵을 포함하는 방법에 대한 예는 identityMap 사용을 참조하십시오.

recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636