태그와 Platform Web SDK 확장을 사용하여 IAB TCF 2.0 지원 통합

Adobe Experience Platform Web SDK는 Interactive Advertising Bureau Transparency & Consent Framework 버전 2.0(IAB TCF 2.0)을 지원합니다. 이 안내서에서는 Adobe Experience Platform Web SDK 태그 확장을 사용하여 Adobe에 IAB TCF 2.0 동의 정보를 전송하기 위한 태그 속성을 설정하는 방법을 보여 줍니다.

태그를 사용하지 않으려면 의 안내서를 참조하십시오. 태그 없이 IAB TCF 2.0 사용.

시작하기

태그 및 Platform Web SDK 확장과 함께 IAB TCF 2.0을 사용하려면 XDM 스키마 및 데이터 세트를 사용할 수 있어야 합니다.

또한 이 안내서를 사용하려면 Adobe Experience Platform Web SDK에 대한 작업 이해 권한이 필요합니다. 빠른 새로 고침은 다음을 참조하십시오. Adobe Experience Platform Web SDK 개요 및 FAQ(자주 묻는 질문) 설명서를 참조하십시오.

기본 동의 설정

확장 구성 내에는 기본 동의에 대한 설정이 있습니다. 이는 동의 쿠키가 없는 고객의 행동을 제어합니다. 동의 쿠키가 없는 고객을 위해 경험 이벤트를 큐에 추가하려면 이 설정을 로 설정합니다. pending. 동의 쿠키가 없는 고객을 위해 경험 이벤트를 취소하려면 이 항목을 로 설정합니다. out. 데이터 요소를 사용하여 기본 동의 값을 동적으로 설정할 수도 있습니다. 다음을 참조하십시오 defaultConsent 추가 정보.

동의 정보로 프로필 업데이트 consent-code-1

을 호출하려면 setConsent 고객 동의 환경 설정이 변경된 경우 태그 규칙을 만듭니다. 새 이벤트를 추가하여 시작하고 코어 확장의 "사용자 지정 코드" 이벤트 유형을 선택합니다.

새 이벤트에 다음 코드 샘플을 사용하십시오.

// Wait for window.__tcfapi to be defined, then trigger when the customer has completed their consent and preferences.
function addEventListener() {
  if (window.__tcfapi) {
    window.__tcfapi("addEventListener", 2, function (tcData, success) {
      if (success && tcData.eventStatus === "useractioncomplete") {
        // save the tcData.tcString in a data element
        _satellite.setVar("IAB TCF Consent String", tcData.tcString);
        _satellite.setVar("IAB TCF Consent GDPR", tcData.gdprApplies);
        trigger();
      }
    });
  } else {
    // window.__tcfapi wasn't defined. Check again in 100 milliseconds
    setTimeout(addEventListener, 100);
  }
}
addEventListener();

이 사용자 지정 코드는 다음 두 가지 작업을 수행합니다.

경험 이벤트에 대한 XDM 데이터 요소 생성

동의 문자열은 XDM 경험 이벤트에 포함되어야 합니다. 이렇게 하려면 XDM 개체 데이터 요소를 사용합니다. 새 XDM 개체 데이터 요소를 만들거나 이미 만든 데이터 요소를 이벤트 전송에 사용합니다. 경험 이벤트 개인 정보 보호 스키마 필드 그룹을 스키마에 추가한 경우 consentStrings xdm 개체의 키입니다.

IAB TCF 2.0 동의 정보로 초기 경험 이벤트 보내기

페이지의 초기 경험 이벤트가 페이지 로드 이벤트로 트리거되는 경우 동의 문자열이 아직 로드되지 않았을 수 있습니다. 이 규칙은 현재 페이지 로드 이벤트를 대체하기 위한 것입니다. 동의 정보가 먼저 로드되었는지 확인하려면 새 규칙을 만들고 다음 코드를 사용자 지정 코드 이벤트로 추가합니다.

// Wait for window.__tcfapi to be defined, then trigger when there is a consent string
function addEventListener() {
  if (window.__tcfapi) {
    window.__tcfapi("addEventListener", 2, function (tcData, success) {
      if (success && (tcData.eventStatus === "useractioncomplete" || tcData.eventStatus === "tcloaded")) {
        // save the tcData.tcString in a data element
        _satellite.setVar("IAB TCF Consent String", tcData.tcString);
        _satellite.setVar("IAB TCF GDPR Applies", tcData.gdprApplies);
        trigger();
      }
    });
  } else {
    // window.__tcfapi wasn"t defined. Check again in 100 milliseconds
    setTimeout(addEventListener, 100);
  }
}
addEventListener();

이 코드는 이전 사용자 지정 코드와 동일하지만, 두 코드 모두 useractioncomplete 및 tcloaded 이벤트가 처리됩니다. 다음 이전 사용자 지정 코드 는 고객이 환경 설정을 처음 선택할 때만 트리거됩니다. 이 코드는 고객이 이미 환경 설정을 선택한 경우에도 트리거됩니다. 예를 들어 두 번째 페이지 로드 시.

Platform Web SDK 확장에서 "이벤트 보내기" 작업을 추가합니다. XDM 필드 내에서 이전 섹션에서 만든 XDM 데이터 요소를 선택합니다.

IAB TCF 2.0 동의 정보로 다른 이벤트 보내기

초기 경험 이벤트 후에 이벤트가 트리거되면 두 데이터 요소가 계속 정의되므로 IAB 동의 정보를 전송하는 데 사용할 수 있습니다. 향후 이벤트를 전송하려면 동일한 XDM 데이터 요소를 사용합니다. IAB TCF 2.0 정보가 포함되어 있습니다.

다음 단계

Platform Web SDK 확장과 함께 IAB TCF 2.0을 사용하는 방법에 대해 배웠으므로 Adobe Analytics 또는 Adobe Real-time Customer Data Platform과 같은 다른 Adobe 솔루션과 통합하도록 선택할 수도 있습니다. 다음을 참조하십시오. IAB 투명성 및 동의 프레임워크 2.0 개요 추가 정보.