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 이(가) 활성화되었습니다. 사이트의 일부 부분이 여전히 을 사용하는 동안 웹 SDK로 전환하는 데 도움이 됩니다 visitor.js.
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. 에 로그인 experience.adobe.com Adobe ID 자격 증명을 사용합니다.
  2. 다음으로 이동 데이터 수집 > 태그.
  3. 원하는 태그 속성을 선택합니다.
  4. 다음으로 이동 규칙 ​을 클릭한 다음 원하는 규칙을 선택합니다.
  5. 아래 작업를 클릭하고 기존 작업을 선택하거나 작업을 만듭니다.
  6. 설정 확장 드롭다운 필드 Adobe Experience Platform 웹 SDK, 및 설정 작업 유형 끝 동의 설정.
  7. 다음을 포함하여 오른쪽에서 원하는 필드를 설정합니다. 표준일반 동의.
  8. 클릭 변경 내용 유지 ​그런 다음 게시 워크플로우를 실행합니다.

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

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

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

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

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

  • standard: 사용자가 선택하는 동의 표준입니다. 이 속성을 다음으로 설정 "Adobe" Adobe 2.0 표준용.

  • version: 동의 표준의 버전을 나타내는 문자열입니다. 이 속성을 다음으로 설정 "2.0" Adobe 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-enabled XDM ExperienceEvent 스키마. 의 섹션을 참조하십시오. ExperienceEvent 스키마 업데이트 을 구성하는 방법에 대한 단계는 데이터 세트 준비 안내서에서 참조하십시오.

  • standard: 사용자가 선택하는 동의 표준입니다. 이 속성을 다음으로 설정 "IAB TCF" IAB TCF 2.0 표준의 경우.
  • version: 동의 표준의 버전을 나타내는 문자열입니다. 이 속성을 다음으로 설정 "2.0" IAB TCF 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" Adobe 1.0 표준용.
  • version: 동의 표준의 버전을 나타내는 문자열입니다. 이 속성을 다음으로 설정 "1.0" Adobe 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

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

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

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

기본 동의(다음을 통해 설정됨)인 경우 defaultConsent 매개 변수)가 로 설정되어 있습니다. pending 또는 out, setConsent 설정은 나가서 id를 설정하는 첫 번째 요청일 수 있습니다. 이러한 이유로 첫 번째 요청에 대한 ID를 동기화하는 것이 중요할 수 있습니다. ID 맵을 setConsent 다음과같이 명령: sendEvent 명령입니다. 다음을 참조하십시오 identityMap 사용 명령에 id 맵을 포함하는 방법의 예입니다.

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