Show Menu
TOPICS×

옵트인 서비스 설정

Experience Cloud 솔루션(옵트인에서 카테고리라고도 함)에 사용되는 단일 참조 지점으로 옵트인 서비스를 구현하여 방문자의 장치에 쿠키를 작성할지 여부를 결정합니다.
옵트인 서비스는 ECID(Experience Cloud ID)와 함께 번들로 제공되는 JavaScript 라이브러리이며, 전역
adobe
개체에서
adobe.optIn
개체로 Visitor JS에 있습니다. 설치된 옵트인 서비스를 사용하면 방문자가 Adobe 솔루션에 한꺼번에 옵트인할 수 있는지 여부 또는 각 솔루션의 권한을 얻기 위해 솔루션을 순서대로 표시할지 여부를 지정할 수 있습니다. 옵트인 서비스 동의 관리 기능을 사용하여 특정 개인 정보 보호 요구 사항에 맞게 다양한 구성을 구현할 수 있습니다.
옵트인 서비스를 사용하면 방문자가 Adobe 솔루션에 한꺼번에 옵트인할 수 있는지 여부 또는 각 솔루션의 권한을 얻기 위해 솔루션을 순서대로 표시할지 여부를 지정할 수 있습니다. 고객이 승인 프로세스를 완료하고 기록하면 모든 Adobe 솔루션에서 CMP 방문자 승인을 검색하여 관련된 동의 호출에 응답할 수 있습니다.

전제 조건

  1. ECID 버전 4.0.
    최신 ECID 릴리스를 다운로드 합니다.
  2. 지원 라이브러리:
    • ECID 4.0 이상
    • AppMeasurement 2.11 이상
    • DIL 9.0
    • AT.js 버전 1.7.0
    • AT.js Launch 확장 버전 9.0
    • Analytics의 경우 확장 1.6이 포함된 App Measurement 2.11
    • Target의 경우 확장 0.9.1
  3. 옵트인에서 사용할 동의 관리 프레임워크를 잘 알아두고 추가 사전 요구 사항을 파악합니다.
  4. 회사의 개인 정보 요구 사항은 GDPR 준수를 위해 선택하는 방법에 따라 달라집니다. 회사 개인 정보 팀이 사전 동의 상태에서 안전하게 사용할 수 있는 라이브러리를 파악합니다.
Adobe Launch 를 사용하는 경우 Opt-in extension to configure Opt-in service.

옵트인 카테고리

방문자의 옵트인 환경 설정은 각 솔루션이 카테고리로 표시되는 Adobe Experience Cloud 솔루션을 기준으로 합니다. 카테고리는
adobe.OptInCategories
개체에서 제공하며, 예를 들어 여기서는 ECID 구성 요소를
adobe.OptInCategories
.
ECID
구문을 사용하는 키-값 쌍으로 전달됩니다. 다음은
adobe.OptInCategories
에 대한 정의입니다.
옵트인 설정은 카테고리별로 유지 관리되며, 각 Experience Cloud 솔루션은 카테고리로 나타냅니다.
adobe.OptInCategories = { AAM: "aam", TARGET: "target", ANALYTICS: "aa", ECID: "ecid", };
옵트인 서비스를 사용하면 사이트에서 사용되는 각 Adobe 솔루션에 대한 방문자의 권한 환경 설정을 지정할 수 있습니다. 이 개체에는 방문자 설정을 승인된 카테고리별로 저장하고 순차적 흐름을 지원하는 라이브러리가 포함되어 있습니다. 여기서 승인 프로세스는 한 번에 하나씩 각 카테고리에 대한 "확인" 또는 "거부" 환경 설정을 수신합니다. 전체 또는 개별 솔루션으로 옵트인할 솔루션/카테고리를 설정할 수 있습니다.
모든 Adobe 솔루션의 클라이언트측 라이브러리는 옵트인 서비스에 종속되며, 솔루션에 권한이 부여되지 않은 경우 쿠키를 생성하지 않습니다. 옵트인은 현재 방문자에 대한 동의 설정을 제공하고 업데이트하는 다양한 방법을 지원합니다. 이 섹션에서는 옵트인 서비스 환경 설정을 지정하는 예를 제공합니다. 함수 및 매개 변수의 전체 목록은 옵트인 API 참조 를 참조하십시오.
옵트인 서비스 구성은 전역
adobe
개체를 인스턴스화하는 Visitor JS
getInstance()
함수에 제공됩니다. 다음은 옵트인 서비스에 대한 Visitor JS 구성 설정 목록입니다.
전역
Visitor
개체의 초기화에서 옵트인 구성 예제
// FORMAT: Object<adobe.OptInCategories enum: boolean> var preOptInApprovalsConfig = {}; preOptInApprovals[adobe.OptInCategories.ANALYTICS] = true; // FORMAT: Object<adobe.OptInCategories enum: boolean> // If you are storing the OptIn permissions on your side (in a cookie you manage or in a CMP), // you have to provide those permissions through the previousPermissions config. // previousPermissions will overwrite preOptInApprovals. var previousPermissionsConfig = {}; previousPermissionsConfig[adobe.OptInCategories.AAM] = true; previousPermissionsConfig[adobe.OptInCategories.ANALYTICS] = false; Visitor.getInstance("YOUR_ORG_ID", { "doesOptInApply": true, // NOTE: This can be a function that evaluates to true or false. "preOptInApprovals": preOptInApprovalsConfig, "previousPermissions": previousPermissionsConfig, "isOptInStorageEnabled": true });
동의 변경 사항 처리
방문자는 사용자 사이트를 경험할 때 언제든지 환경 설정을 처음으로 지정하거나 CMP를 사용하여 환경 설정을 변경할 수 있습니다. Visitor JS가 초기 설정으로 초기화되면 방문자의 권한을 변경할 수 있습니다. 동의 함수 관리 목록에 대해서는 동의 변경 을 참조하십시오.

옵트인 워크플로우

옵트인 서비스는 두 개 이상의 요청 주기를 통해 권한을 수집할 수 있고 환경 설정이 한 번에 하나씩 제공되는 워크플로우를 지원합니다. 다음 함수를 사용하여 **​에
shouldWaitForComplete
true를 제공하면 솔루션에서 한 개 카테고리 또는 전체 카테고리의 서브 세트에 대한 동의를 수집한 다음, 다음 카테고리 또는 카테고리의 서브 세트에 대한 동의를 수집할 수 있습니다.
adobe.optIn.status
속성은 첫 번째 호출부터
adobe.optIn.complete()
가 흐름 끝에서 호출될 때까지
보류
​됩니다. 호출되면 상태는
complete
​로 설정됩니다.
adobe.optIn.approve(['AAM', 'ECID'], true); adobe.optIn.deny(['ANALYTICS'], true); adobe.optIn.complete();
워크플로우 구성 설정 을 참조하십시오.

방문자의 옵트인 권한 검사

방문자가 자신의 권한을 변경할 때 옵트인 서비스의 변경 사항과 동의 저장 내용을 동기화하기 위해서는 결과 권한에 대한 통찰력이 필요합니다. 권한 함수 를 사용하여 방문자의 환경 설정을 검사합니다. 예를 들면 다음과 같습니다.
fetchPermissions 샘플
optIn.fetchPermissions(function (permissions) { // Here you can check if your category has been approved or not. // We recommend using optIn.isApproved() to check for permissions because it abstracts out the details of knowing exactly how the permissions list looks like. if (adobe.optIn.isApproved(MY_CATEGORY) { sendBeacon(); // Or something } }); OR: You can pass in shouldAutoSubscribe as true, your callback will be used to subscribe to all OptIn events going forward: function callback() { if (adobe.optIn.isApproved(MY_CATEGORY) { sendBeacon(); // Or something } } optIn.fetchPermissions(callback, true);
이 문서에 언급된 함수, 속성 또는 구성에 대한 자세한 내용은 API 설명서 를 참조하십시오.

방문자 환경 설정 저장

옵트인 서비스는 개발 환경 또는 CRM을 사용할 수 없는 환경에 맞게 동의 환경 설정을 저장하는 옵션을 제공합니다. 구성 속성
isOptInStorageEnabled
true
​로 지정하면 옵트인 서비스를 트리거하여 도메인 내에 방문자의 시스템에 대한 쿠키를 생성합니다.
adobe.optIn
개체는 상태를 저장하지 않으며, 저장 메커니즘을 제공하지 않습니다. 대신 사용자 지정 데이터를 저장할 수 있는 경우 기존의 CMP(동의 관리 플랫폼)에 있는 Adobe 동의 설정을 관리하도록 설계되었습니다. 또는 방문자 브라우저의 쿠키에 방문자 환경 설정을 저장할 수 있습니다. 사용자의 환경 설정을 옵트인 서비스에 제공하는 두 가지 옵션이 있습니다.
  • 사용자 동의 지속성 솔루션이 방문자의 브라우저에서 CMP이든, 쿠키이든 간에 방문자 환경 설정을 적시에 검색할 수 있도록 허용하는 경우, 방문자 초기화 중에 그러한 환경 설정을 옵트인 서비스에 제공할 수 있습니다.
  • 그러나 검색이 오래 걸릴 수 있는 경우 또는 비동기 프로세스로 최상의 서비스를 제공할 수 있는 경우에는 그러한 설정이 성공적으로 로드되면 서비스의
    approve()
    함수를 사용하여 설정을 제공할 수 있습니다.