Platform Web SDK와 IAB TCF 2.0 지원 통합

이 안내서에서는 태그를 사용하지 않고 Interactive Advertising Bureau Transparency & Consent Framework, 버전 2.0(IAB TCF 2.0)을 Adobe Experience Platform Web SDK와 통합하는 방법을 보여줍니다. IAB TCF 2.0과 통합하는 방법에 대한 개요는 개요를 참조하십시오. 태그와 통합하는 방법에 대한 안내서는 IAB TCF 2.0 안내서 (태그에 대한)를 참조하십시오.

시작하기

이 안내서에서는 __tcfapi 인터페이스를 사용하여 동의 정보에 액세스합니다. 를 CMP(클라우드 관리 제공자)와 직접 통합하는 것이 더 쉬워질 수 있습니다. 그러나 CMP는 일반적으로 TCF API와 유사한 기능을 제공하므로 이 안내서의 정보는 여전히 유용할 수 있습니다.

노트

이러한 예에서는 코드가 실행될 때까지 페이지에 window.__tcfapi이 정의되어 있다고 가정합니다. CMP는 __tcfapi 개체가 준비되었을 때 이러한 함수를 실행할 수 있는 후크를 제공할 수 있습니다.

태그 및 Adobe Experience Platform Web SDK 확장과 함께 IAB TCF 2.0을 사용하려면 XDM 스키마를 사용할 수 있어야 합니다. 이 중 하나를 설정하지 않았다면 계속 진행하기 전에 이 페이지를 본 다음 페이지를 확인하십시오.

또한 이 안내서에서는 Adobe Experience Platform Web SDK에 대한 작업 이해를 필요로 합니다. 빠른 리프레셔를 보려면 Adobe Experience Platform Web SDK 개요자주 묻는 질문 설명서를 참조하십시오.

기본 동의 활성화

알 수 없는 모든 사용자를 동일하게 처리하려면 기본 동의를 pending 또는 out로 설정할 수 있습니다. 이렇게 하면 동의 환경 설정이 수신될 때까지 경험 이벤트를 큐에 추가하거나 삭제합니다.

기본 동의에 대한 자세한 내용은 Platform Web SDK 구성 설명서의 기본 동의 섹션을 참조하십시오.

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 변수를 구성으로 입력해야 합니다.

노트

기본 동의를 in(으)로 설정하면 setConsent 명령을 사용하여 고객의 동의 기본 설정을 기록할 수 있습니다.

setConsent 이벤트 사용

IAB TCF 2.0 API는 고객이 동의를 업데이트할 때 이벤트를 제공합니다. 이 문제는 고객이 처음 기본 설정을 지정하고 고객이 기본 설정을 업데이트할 때 발생합니다.

다음 예제에서는 이 방법을 보여 줍니다.

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 변수를 반드시 채워야 합니다. setConsent 호출에 대한 자세한 내용은 지원 동의의 안내서를 참조하십시오.

sendEvent에 동의 정보 포함

XDM 스키마 내에서 Experience Events의 동의 기본 설정 정보를 저장할 수 있습니다. 모든 이벤트에 이 정보를 추가하는 방법에는 두 가지가 있습니다.

먼저 모든 sendEvent 호출 시 관련 XDM 스키마를 제공할 수 있습니다. 다음 예제에서는 이 방법을 보여 줍니다.

var sendEventOptions = { ... };
window.__tcfapi('getTCData', 2, function (tcData, success) {
  if (success) {
    sendEventOptions.xdm.consentStrings = [{
      consentStandard: "IAB TCF"
      consentStandardVersion: "2.0"
      consentStringValue: tcData.tcString,
      gdprApplies: tcData.gdprApplies
    }];
    window.alloy("sendEvent", sendEventOptions);
  }
});

이 예제는 TCF API에 대한 동의 정보를 가져온 다음 XDM 스키마에 동의 정보가 추가된 이벤트를 보냅니다. sendEvent 명령 옵션의 내용을 이해하려면 추적 이벤트 안내서를 참조하십시오.

모든 요청에 동의 정보를 추가하는 다른 방법은 onBeforeEventSend 콜백을 사용하는 것입니다. 이를 수행하는 방법에 대한 자세한 내용은 추적 이벤트 설명서 내에서 전역적으로 이벤트 수정< a1/>에 대한 섹션을 참조하십시오.

다음 단계

이제 Platform Web SDK 확장과 함께 IAB TCF 2.0을 사용하는 방법을 알았으므로 Adobe Analytics 또는 실시간 고객 데이터 플랫폼과 같은 다른 Adobe 솔루션과 통합하도록 선택할 수도 있습니다. 자세한 내용은 IAB Transparency & Consent Framework 2.0 개요를 참조하십시오.

이 페이지에서는