설명서Experience Platform데이터 수집

defaultConsent

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 개발자

defaultConsent 속성은 setConsent 명령을 호출하기 전에 데이터 수집 동의를 처리하는 방법을 결정합니다. 이 속성은 데이터를 수집하기 전에 동의가 필요한 영역에 거주하는 개인의 데이터를 실수로 수집하지 않으려는 경우 유용합니다.

방문자가 GDPR(일반 데이터 보호 규정)의 적용을 받지 않는 경우 기본 동의를 in(으)로 설정할 수 있습니다. GDPR 관할권 내의 방문자는 기본 동의를 pending(으)로 설정할 수 있습니다. CMP(동의 관리 플랫폼)가 고객의 지역을 감지하고 gdprApplies 플래그를 IAB TCF 2.0에 제공할 수 있습니다. 이 플래그는 기본 동의를 설정하는 데 사용할 수 있습니다.

defaultConsent 명령을 실행할 때 configure 문자열 속성을 원하는 동의 수준으로 설정하십시오. 이 속성은 대/소문자를 구분하며 "in", "out" 및 "pending" 세 가지 값만 지원합니다. 다른 값을 사용하려고 하면 라이브러리에서 오류가 발생합니다. configure 명령에 설정되지 않은 경우 기본값은 in​입니다.

IMPORTANT
페이지 로드 사이에 defaultConsent 값이 유지되지 않습니다. configure 명령을 호출할 때마다 원하는 기본 동의를 설정해야 합니다.
alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  defaultConsent: "pending"
});
  • in: 사용자가 옵트아웃할 때까지 데이터 수집이 정상적으로 작동합니다.
  • out: 사용자가 옵트인할 때까지 데이터가 영구적으로 삭제됩니다.
  • pending: 사용자가 setConsent 명령을 사용하여 옵트인할 때까지 데이터가 로컬에 저장됩니다.
NOTE
Adobe은 Adobe 기능 및 제품 오퍼링에 해당하는 보다 강력한 목적 또는 카테고리 세트를 구축할 계획이지만 현재 구현은 옵트인에 대한 양자택일의 접근 방식입니다. 이 제한은 웹 SDK에만 적용되며 다른 Adobe JavaScript 라이브러리에는 적용되지 않습니다.

웹 SDK은 두 가지 상호 보완적인 동의 옵션을 제공합니다.

  • defaultConsent(이 페이지): 기본 동의 환경 설정을 결정합니다.
  • setConsent: 방문자의 동의 환경 설정을 캡처합니다.

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

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

defaultConsent
setConsent
데이터 수집 발생
웹 SDK 브라우저 쿠키 설정
in
in
예
예
in
out
아니요
예
in
설정되지 않음
예
예
pending
in
예
예
pending
out
아니요
예
pending
설정되지 않음
아니요
아니요
out
in
예
예
out
out
아니요
예
out
설정되지 않음
아니요
아니요

라이브러리에서 설정하는 쿠키 목록은 Adobe Experience Platform Web SDK 쿠키를 참조하십시오.

NOTE
ID 및 동의 쿠키는 방문자가 추적을 옵트아웃하는 경우에도 설정됩니다. 이러한 쿠키는 해당 데이터 수집 환경 설정을 준수하는 데 필요합니다.

gdprApplies을(를) 기반으로 기본 동의 설정 중

일부 CMP에서는 GDPR(일반 데이터 보호 규정)이 고객에게 적용되는지 여부를 확인하는 기능을 제공합니다. GDPR이 적용되지 않는 고객에 대한 동의를 얻으려면 TCF API 호출에 gdprApplies 플래그를 사용할 수 있습니다. 예:

var alloyConfiguration = { ... };
window.__tcfapi('getTCData', 2, function (tcData, success) {
  if (success) {
    alloyConfiguration.defaultConsent = tcData.gdprApplies ? "pending" : "in";
    window.alloy("configure", alloyConfiguration);
  }
});

위의 코드 블록에서 configure 명령은 TCF API에서 tcData을(를) 가져온 후에 호출됩니다. gdprApplies이(가) true이면 기본 동의가 pending(으)로 설정됩니다. gdprApplies이(가) false이면 기본 동의가 in(으)로 설정됩니다. 구성을 사용하여 alloyConfiguration 변수를 채우십시오.

웹 SDK 태그 확장을 사용한 기본 동의

태그를 사용하여 이러한 작업을 수행하는 방법에 대해 알아보려면 웹 SDK 태그 확장 설명서에서 동의 설정을 참조하십시오.

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1