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

Adobe Experience Platform Web SDK는 대화형 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 개요 및 자주 묻는 질문 설명서를 참조하십시오.

기본 동의 설정

확장 구성 내에는 기본 동의에 대한 설정이 있습니다. 이는 동의 쿠키가 없는 고객의 행동을 제어합니다. 동의 쿠키가 없는 고객을 위해 경험 이벤트를 큐에 넣으려면 이를 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 개체 데이터 요소를 만들거나 이미 만든 데이터 요소를 이벤트 전송에 사용합니다. 스키마에 경험 이벤트 개인 정보 보호 스키마 필드 그룹을 추가한 경우 XDM 개체에 consentStrings 키가 있어야 합니다.

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 Transparency & Consent Framework 2.0 개요를 참조하십시오.