setConsent

Adobe 2.0 standard consent 개체

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

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

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

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

  • value.collect.val: 동의 값입니다. 사용자가 옵트인할 때는 "y"(으)로 설정하고 사용자가 옵트아웃할 때는 "n"(으)로 설정합니다.
  • value.metadata.time: 사용자가 동의 설정을 마지막으로 업데이트한 타임스탬프.

// 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 표준 consent 개체

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입니다.

// 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
  }]
});

IAB TCF 2.0 API는 고객이 동의를 업데이트할 때에 대한 이벤트를 제공합니다. 이 문제는 고객이 처음에 환경 설정을 지정하고 고객이 환경 설정을 업데이트할 때 발생합니다. 이벤트 수신기를 추가하여 setConsent 명령을 실행할 수 있습니다.

const identityMap = { ... };
window.__tcfapi('addEventListener', 2, function (tcData, success) {
  if (success && tcData.eventStatus === 'useractioncomplete') {
    window.alloy("setConsent", {
      identityMap,
      consent: [
        {
          standard: "IAB TCF",
          version: "2.0",
          value: tcData.tcString,
          gdprApplies: tcData.gdprApplies
        }
      ]
    });
  }
});

위의 코드 블록은 useractioncomplete 이벤트를 수신한 다음 동의를 설정하여 동의 문자열과 gdprApplies 플래그를 전달합니다. 고객에 대한 사용자 지정 ID가 있는 경우 identityMap 변수를 채우십시오.

Adobe 1.0 standard consent 개체

• standard: 선택한 동의 표준입니다. Adobe 1.0 표준에 대해 이 속성을 "Adobe"(으)로 설정합니다.
• version: 동의 표준의 버전을 나타내는 문자열입니다. Adobe 1.0 표준에 대해 이 속성을 "1.0"(으)로 설정합니다.
• value.general: 동의 값입니다. 사용자가 옵트인할 때는 "in"(으)로 설정하고 사용자가 옵트아웃할 때는 "out"(으)로 설정합니다.

// Set consent using the Adobe 1.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "1.0",
    "value": {
      "general": "in"
    }
  }]
});