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 개요 그리고 FAQ 설명서.

기본 동의 활성화

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

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

기본 동의 설정 기준 gdprApplies

일부 CMP에서는 GDPR(일반 데이터 보호 규정)이 고객에게 적용되는지 여부를 확인하는 기능을 제공합니다. GDPR이 적용되지 않는 고객에 대한 동의를 가정하려는 경우 gdprApplies TCF API 호출에 플래그 지정

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

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

이 예에서 configure 명령은 다음에 호출됩니다. tcData 는 TCF API에서 가져옵니다. If gdprApplies true이면, 기본 동의는 pending. If gdprApplies is false (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의 동의 기본 설정 정보를 저장할 수 있습니다. 모든 이벤트에 이 정보를 추가하는 방법에는 두 가지가 있습니다.

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

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 콜백입니다. 다음 섹션 읽기 전역적으로 이벤트 수정 를 참조하십시오.

다음 단계

이제 Platform Web SDK 확장과 함께 IAB TCF 2.0을 사용하는 방법을 알았으므로 Adobe Analytics 또는 Adobe Real-time Customer Data Platform과 같은 다른 Adobe 솔루션과 통합하도록 선택할 수도 있습니다. 자세한 내용은 IAB Transparency & Consent Framework 2.0 개요 추가 정보.

이 페이지에서는