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

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

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

전제 조건

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

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

이 안내서의 설치 단계에는 태그 확장 및 웹 애플리케이션에 어떻게 설치되는지를 제대로 이해할 필요가 있습니다. 자세한 내용은 다음 설명서를 참조하십시오.

데이터 스트림 설정

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

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

데이터 스트림 필드
샌드박스 데이터 스트림을 설정하는 데 필요한 스트리밍 연결 및 데이터 세트가 포함된 플랫폼 sandbox의 이름입니다.
스트리밍 인렛 Experience Platform에 유효한 스트리밍 연결입니다. 기존 스트리밍 유입구가 없는 경우 스트리밍 연결 만들기에서 자습서를 참조하십시오.
이벤트 데이터 세트 SDK를 사용하여 이벤트 데이터를에 보낼 계획인 XDM ExperienceEvent 데이터 세트. Platform 데이터 스트림을 만들려면 이벤트 데이터 세트를 제공해야 하지만, 이벤트를 통해 전송된 동의 데이터는 다운스트림 적용 워크플로우에서 적용되지 않습니다.
프로필 데이터 세트 이전에서 만든 고객 동의 필드가 있는 Profile 사용 데이터 세트.

완료되면 화면 맨 아래에서 저장 을 선택하고 추가 프롬프트를 따라 구성을 완료합니다.

Platform Web SDK 설치 및 구성

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

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

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

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

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

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

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

사용자의 영역이 CMP로 결정된 경우, 대신 다음 단계를 사용할 수 있습니다.

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

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

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

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

웹 사이트에 확장 배포

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

동의 변경 명령

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

중요

setConsent 명령은 프로필 저장소에서 직접 데이터만 업데이트하며 Data Lake로 데이터를 전송하지 않습니다.

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

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

Platform SDK 명령의 일반적인 구문에 대한 소개는 명령 실행에 있는 문서를 참조하십시오.

setConsent 명령에는 두 개의 인수가 필요합니다.

  1. 명령 유형을 나타내는 문자열(이 경우 "setConsent")
  2. 단일 배열 형식 속성을 포함하는 페이로드 개체입니다. consent consent 배열에는 Adobe 표준에 필요한 동의 필드를 제공하는 개체가 하나 이상 있어야 합니다.

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

alloy("setConsent", {
  consent: [{
    standard: "Adobe",
    version: "2.0",
    value: {
      collect: {
        val: "y"
      },
      share: {
        val: "y"
      },
      personalize: {
        content: {
          val: "y"
        }
      },
      metadata: {
        time: "2020-10-12T15:52:25+00:00"
      }
    }
  }]
});
페이로드 속성 설명
standard 사용 중인 동의 표준입니다. Adobe 표준의 경우 이 값을 Adobe(으)로 설정해야 합니다.
version standard에 표시된 동의 표준의 버전 번호입니다. Adobe 표준 동의 처리를 위해서는 이 값을 2.0 로 설정해야 합니다.
value 고객이 프로필 사용 데이터 집합의 동의 필드의 구조를 준수하는 XDM 개체로 제공하는 고객의 업데이트된 동의 정보입니다.
노트

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 명령 실행 안내서의 성공 또는 실패 처리에 대한 섹션을 참조하십시오.

SDK로 setConsent 호출을 성공적으로 수행한 후에는 플랫폼 UI의 프로필 뷰어를 사용하여 데이터가 프로필 저장소에 랜딩되는지 확인할 수 있습니다. 자세한 내용은 ID로 프로필 검색의 섹션을 참조하십시오.

다음 단계

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

이 페이지에서는