Platform Web SDK를 통합하여 고객 동의 데이터 처리

Adobe Experience Platform Web SDK를 사용하면 동의 관리 플랫폼(CMP)에서 생성된 고객 동의 신호를 검색하고 동의 변경 이벤트가 발생할 때마다 Adobe Experience Platform으로 전송할 수 있습니다.

SDK가 기본 CMP와 인터페이스하지 않습니다. SDK를 웹 사이트에 통합하는 방법을 결정하고 CMP에서 동의 변경 사항을 수신하고 적절한 명령을 호출하는 것은 사용자가 결정합니다. 이 문서에서는 CMP를 Platform Web SDK와 통합하는 방법에 대한 일반적인 지침을 제공합니다.

전제 조건 prerequisites

이 자습서에서는 CMP 내에서 동의 데이터를 생성하는 방법을 이미 결정하고 Adobe 표준 또는 IAB TCF(Transparency and Consent Framework) 2.0 표준을 준수하는 동의 필드를 포함하는 데이터 세트를 만들었다고 가정합니다. 이 데이터 세트를 아직 만들지 않은 경우 이 안내서로 돌아가기 전에 다음 튜토리얼을 참조하십시오.

이 안내서는 UI에서 태그 확장을 사용하여 SDK를 설정하는 워크플로를 따릅니다. 확장을 사용하지 않고 사이트에 독립 실행형 SDK 버전을 직접 포함하려는 경우 이 안내서 대신 다음 문서를 참조하십시오.

이 안내서의 설치 단계에서는 태그 확장 및 웹 애플리케이션에 태그 확장을 설치하는 방법을 이해해야 합니다. 자세한 내용은 다음 설명서를 참조하십시오.

데이터 스트림 설정

SDK가 데이터를 Experience Platform으로 보내려면 먼저 데이터 스트림을 구성해야 합니다. 데이터 수집 UI 또는 Experience Platform UI의 왼쪽 탐색에서 데이터스트림 ​을 선택합니다.

새 데이터 스트림을 만들거나 편집할 기존 데이터 스트림을 선택한 후 Adobe Experience Platform 옆에 있는 전환 단추를 선택합니다. 그런 다음 아래 나열된 값을 사용하여 양식을 작성합니다.

데이터 스트림 필드
샌드박스
데이터 스트림을 설정하는 데 필요한 스트리밍 연결 및 데이터 세트가 포함된 Platform sandbox의 이름입니다.
이벤트 데이터 세트
SDK를 사용하여 이벤트 데이터를에 전송할 XDM ExperienceEvent 데이터 집합입니다. Platform 데이터 스트림을 만들기 위해 이벤트 데이터 세트를 제공해야 하지만, 이벤트를 통해 전송된 동의 데이터는 다운스트림 시행 워크플로우에서 적용되지 않습니다.
프로필 데이터 세트
이전에 만든 고객 동의 필드가 있는 Profile 사용 데이터 집합입니다.

완료되면 화면 하단에서 저장 ​을 선택하고 추가 프롬프트에 따라 계속 구성을 완료합니다.

Platform Web SDK 설치 및 구성

이전 섹션에서 설명한 대로 데이터 스트림을 생성했으면 궁극적으로 사이트에 배포할 Platform Web SDK 확장을 구성해야 합니다. 태그 속성에 SDK 확장이 설치되어 있지 않은 경우 왼쪽 탐색에서 확장 ​을 선택한 다음 카탈로그 탭을 선택합니다. 그런 다음 사용 가능한 확장 목록의 Platform SDK 확장 아래에서 설치 ​를 선택합니다.

SDK를 구성할 때 Edge 구성 ​에서 이전 단계에서 만든 데이터 스트림을 선택합니다.

확장을 설치하려면 저장 ​을 선택합니다.

기본 동의를 설정할 데이터 요소 만들기

SDK 확장을 설치하면 사용자의 기본 데이터 수집 동의 값(collect.val)을 나타내는 데이터 요소를 만들 수 있습니다. 이 기능은 유럽 연합 사용자의 경우 pending, 북미 사용자의 경우 in과 같이 사용자에 따라 다른 기본값을 사용하려는 경우에 유용합니다.

이 사용 사례에서는 다음을 구현하여 사용자의 지역을 기반으로 기본 동의를 설정할 수 있습니다.

  1. 웹 서버에서 사용자 영역을 확인합니다.
  2. 웹 페이지의 script 태그(포함 코드) 앞에 adobeDefaultConsent 변수를 설정하는 별도의 script 태그를 렌더링합니다.
  3. adobeDefaultConsent JavaScript 변수를 사용하는 데이터 요소를 설정하고 이 데이터 요소를 사용자의 기본 동의 값으로 사용하십시오.

사용자의 영역이 CMP에 의해 결정되는 경우 대신 다음 단계를 사용할 수 있습니다.

  1. 페이지에서 "CMP 로드된" 이벤트를 처리합니다.
  2. 이벤트 처리기에서 사용자의 영역을 기준으로 adobeDefaultConsent 변수를 설정한 다음 JavaScript을 사용하여 태그 라이브러리 스크립트를 로드합니다.
  3. adobeDefaultConsent JavaScript 변수를 사용하는 데이터 요소를 설정하고 이 데이터 요소를 사용자의 기본 동의 값으로 사용하십시오.

UI에서 데이터 요소를 만들려면 왼쪽 탐색에서 데이터 요소 ​를 선택한 다음 데이터 요소 추가 ​를 선택하여 데이터 요소 만들기 대화 상자로 이동합니다.

여기에서 adobeDefaultConsent을(를) 기반으로 JavaScript 변수 데이터 요소를 만들어야 합니다. 완료되면 저장 ​을 선택합니다.

데이터 요소가 만들어지면 웹 SDK 확장 구성 페이지로 다시 이동합니다. 개인 정보 섹션에서 데이터 요소에서 제공 ​을 선택하고 제공된 대화 상자를 사용하여 이전에 만든 기본 동의 데이터 요소를 선택합니다.

웹 사이트에 확장 배포

확장 구성을 마치면 웹 사이트에 통합할 수 있습니다. 업데이트된 라이브러리 빌드를 배포하는 방법에 대한 자세한 내용은 태그 설명서의 게시 안내서를 참조하십시오.

동의 변경 명령 만들기 commands

SDK 확장을 웹 사이트에 통합하면 Platform Web SDK setConsent 명령을 사용하여 Platform에 동의 데이터를 전송할 수 있습니다.

setConsent 명령은 다음 두 가지 작업을 수행합니다.

  1. 프로필 저장소에서 직접 사용자의 프로필 속성을 업데이트합니다. 이렇게 해도 데이터 레이크로 데이터가 전송되지 않습니다.
  2. 동의 변경 이벤트의 타임스탬프가 지정된 계정을 기록하는 경험 이벤트를 만듭니다. 이 데이터는 데이터 레이크로 직접 전송되며 시간 경과에 따른 동의 환경 설정 변경을 추적하는 데 사용할 수 있습니다.

setConsent을(를) 호출할 때

사이트에서 setConsent을(를) 호출해야 하는 두 가지 시나리오가 있습니다.

  1. 동의가 페이지에 로드될 때(즉, 모든 페이지 로드 시)
  2. 동의 설정 변경을 감지하는 CMP 후크 또는 이벤트 리스너의 일부

setConsent 구문

setConsent 명령에는 단일 배열 형식 속성이 포함된 페이로드 개체가 필요합니다. consent. consent 배열에는 Adobe 표준에 필요한 동의 필드를 제공하는 개체가 하나 이상 있어야 합니다.

다음 예제 setConsent 호출에는 Adobe 표준에 대한 필수 동의 필드가 표시됩니다.

alloy("setConsent", {
  consent: [{
    standard: "Adobe",
    version: "2.0",
    value: {
      collect: {
        val: "y"
      },
      share: {
        val: "y"
      },
      personalize: {
        content: {
          val: "y"
        }
      },
      metadata: {
        time: "YYYY-10-12T15:52:25+00:00"
      }
    }
  }]
});
페이로드 속성
설명
standard
사용 중인 동의 표준입니다. Adobe 표준의 경우 이 값을 Adobe(으)로 설정해야 합니다.
version
standard 아래에 표시된 동의 표준의 버전 번호입니다. Adobe 표준 동의 처리를 위해 이 값을 2.0(으)로 설정해야 합니다.
value
프로필 활성화 데이터 세트의 동의 필드 구조를 준수하는 XDM 객체로 제공되는 고객의 업데이트된 동의 정보.
NOTE
Adobe(예: IAB TCF)과 함께 다른 동의 표준을 사용하는 경우 각 표준에 대해 consent 배열에 개체를 추가할 수 있습니다. 각 개체는 표시되는 동의 표준에 대해 standard, versionvalue에 대한 적절한 값을 포함해야 합니다.

다음 JavaScript은 웹 사이트에서 이벤트 리스너 또는 CMP 후크에서 콜백으로 사용할 수 있는 동의 환경 설정 변경을 처리하는 함수의 예를 제공합니다.

var setConsent = function () {

  // Retrieve the current consent data.
  var categories = getConsentData();

  // If the script is running on a consent change, generate a new timestamp.
  // If the script is running on page load, set the timestamp to when the consent values last changed.
  var now = new Date();
  var collectedAt = consentChanged ? now.toISOString() : categories.collectedAt;

  //  Map the consent values and timestamp to XDM
  var consentXDM = {
    collect: {
      val: categories.collect !== -1 ? "y" : "n"
    },
    personalize: {
      content: {
        val: categories.personalizeContent !== -1 ? "y" : "n"
      }
    },
    share: {
      val: categories.share !== -1 ? "y" : "n"
    },
    metadata: {
      time: collectedAt
    }
  };

  // Pass the XDM object to the Platform Web SDK
  alloy("setConsent", {
    consent: [{
      standard: "Adobe",
      version: "2.0",
      value: consentXDM
    }]
  });
});

SDK 응답 처리

모든 Platform SDK 명령은 호출의 성공 또는 실패 여부를 나타내는 약속을 반환합니다. 그런 다음 고객에게 확인 메시지를 표시하는 것과 같은 추가 논리에 이러한 응답을 사용할 수 있습니다. 자세한 내용은 명령 응답을 참조하세요.

SDK를 사용하여 setConsent번 호출하면 Platform UI의 프로필 뷰어를 사용하여 데이터가 프로필 스토어에 도달하는지 확인할 수 있습니다. 자세한 내용은 ID별로 프로필 찾아보기의 섹션을 참조하십시오.

다음 단계

이 안내서에 따라 동의 데이터를 Experience Platform으로 보내도록 Platform Web SDK 확장을 구성했습니다. 구현 테스트에 대한 지침은 구현 중인 동의 표준에 대한 설명서를 참조하십시오.

recommendation-more-help
5741548a-2e07-44b3-9157-9c181502d0c5