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 Web SDK 설치 및 구성

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

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

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

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

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

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

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

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

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

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

웹 사이트에 확장 배포

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

동의 변경 명령 만들기 commands

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

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

setConsent을(를) 호출할 때

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

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"
      }
    }
  }]
});

다음 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 확장을 구성했습니다. 구현 테스트에 대한 지침은 구현 중인 동의 표준에 대한 설명서를 참조하십시오.