Client Context 관련 세부 사항 client-context-in-detail

Client Context는 동적으로 조립된 사용자 데이터의 컬렉션을 나타냅니다. 데이터를 사용하여 주어진 상황(콘텐츠 타겟팅)에서 웹 페이지에 표시할 콘텐츠를 결정할 수 있습니다. 이 데이터는 웹 사이트 분석 및 페이지의 모든 JavaScript에도 사용할 수 있습니다.

Client Context는 주로 다음 측면으로 구성됩니다.

독립 실행형 세션 저장소를 만들어 Client Context에 추가하거나 Context Store 구성 요소에 연결된 세션 저장소를 만듭니다. Adobe Experience Manager(AEM)는 즉시 사용할 수 있는 여러 컨텍스트 스토어 구성 요소를 설치합니다. 이러한 구성 요소를 구성 요소의 기반으로 사용할 수 있습니다.

Client Context를 열고, 표시되는 정보를 구성하고, 사용자 환경을 시뮬레이션하는 방법에 대한 자세한 내용은 Client Context을 참조하십시오.

세션 저장소 session-stores

Client Context에는 사용자 데이터를 포함하는 다양한 세션 저장소가 포함되어 있습니다. 저장소 데이터는 다음 소스에서 가져옵니다.

Client Context 프레임워크는 세션 저장소와 상호 작용하여 사용자 데이터를 읽고 쓰고, 저장 이벤트를 수신 및 반응시키는 데 사용할 수 있는 JavaScript API를 제공합니다. 콘텐츠 타겟팅 또는 다른 용도로 사용하는 사용자 데이터에 대한 세션 저장소를 만들 수도 있습니다.

세션 저장소 데이터는 클라이언트에 유지됩니다. Client Context는 서버에 데이터를 다시 쓰지 않습니다. 서버에 데이터를 보내려면 양식을 사용하거나 사용자 지정 JavaScript을 개발하십시오.

각 세션 저장소는 속성-값 쌍의 컬렉션입니다. 세션 저장소는 데이터(모든 종류)의 컬렉션을 나타내며, 개념적인 의미는 디자이너, 개발자 또는 이 두 가지가 모두 결정할 수 있습니다. 다음 예제 JavaScript 코드는 세션 저장소에 포함될 수 있는 프로필 데이터를 나타내는 개체를 정의합니다.

{
  age: 20,
  authorizableId: "aparker@geometrixx.info",
  birthday: "27 Feb 1992",
  email: "aparker@geometrixx.info",
  formattedName: "Alison Parker",
  gender: "female",
  path: "/home/users/geometrixx/aparker@geometrixx.info/profile"
}

세션 저장소는 브라우저 세션 간에 지속되거나, 생성된 브라우저 세션에 대해서만 지속될 수 있습니다.

컨텍스트 저장소 구성 요소 context-store-components

컨텍스트 저장소 구성 요소는 Client Context에 추가할 수 있는 CQ 구성 요소입니다. 일반적으로 컨텍스트 저장소 구성 요소는 연결된 세션 저장소의 데이터를 표시합니다. 그러나 컨텍스트 저장소 구성 요소가 표시하는 정보는 세션 저장소 데이터로 제한되지 않습니다.

컨텍스트 저장소 구성 요소에는 다음 항목이 포함될 수 있습니다.

Context Store에 추가할 수 있는 설치된 Context Store 구성 요소에 대한 설명은 사용 가능한 클라이언트 컨텍스트 구성 요소를 참조하십시오.

타깃팅된 컨텐츠 전달 targeted-content-delivery

프로필 정보는 타겟팅된 콘텐츠를 전달하는 데에도 사용됩니다.

페이지에 Client Context 추가 adding-client-context-to-a-page

Client Context 구성 요소를 웹 페이지의 본문 섹션에 포함시켜 Client Context를 활성화합니다. 클라이언트 컨텍스트 구성 요소 노드의 경로는 /libs/cq/personalization/components/clientcontext입니다. 구성 요소를 포함하려면 페이지의 body 요소 바로 아래에 있는 페이지 구성 요소의 JSP 파일에 다음 코드를 추가하십시오.

<cq:include path="clientcontext" resourceType="cq/personalization/components/clientcontext"/>

clientcontext 구성 요소를 사용하면 페이지에서 Client Context를 구현하는 클라이언트 라이브러리를 로드할 수 있습니다.

Client Context UI는 작성자 인스턴스에서만 사용할 수 있습니다.

Client Context 확장 extending-client-context

Client Context를 확장하려면 세션 저장소를 작성하고 선택적으로 저장소 데이터를 표시합니다.

세션 저장소 만들기 creating-a-session-store

Client Context에서 추가하고 검색해야 하는 데이터에 대한 세션 저장소를 만듭니다. 일반적으로 다음 절차를 사용하여 세션 저장소를 생성합니다.

personalization.stores.kernel 클라이언트 라이브러리에 JavaScript을 포함하면 Client Context 프레임워크가 로드될 때 저장소가 생성됩니다.

세션 저장소 유형 types-of-session-stores

세션 저장소는 브라우저 세션 중에 생성되어 사용할 수 있거나 브라우저 저장소 또는 쿠키에서 유지됩니다. Client Context JavaScript API는 두 가지 유형의 데이터 저장소를 나타내는 여러 클래스를 정의합니다.

API는 JSON 데이터 또는 JSONP 데이터 저장에 특화된 다음 클래스의 확장도 제공합니다.

세션 저장소 개체 만들기 creating-the-session-store-object

클라이언트 라이브러리 폴더의 JavaScript은 세션 저장소를 생성하고 초기화합니다. 컨텍스트 저장소 관리자를 사용하여 세션 저장소를 등록해야 합니다. 다음 예제에서는 CQ_Analytics.SessionStore 개체를 만들고 등록합니다.

//Create the session store
if (!CQ_Analytics.MyStore) {
    CQ_Analytics.MyStore = new CQ_Analytics.SessionStore();
    CQ_Analytics.MyStore.STOREKEY = "MYSTORE";
    CQ_Analytics.MyStore.STORENAME = "mystore";
    CQ_Analytics.MyStore.data={};
}
//register the session store
if (CQ_Analytics.ClientContextMgr){
    CQ_Analytics.ClientContextMgr.register(CQ_Analytics.MyStore)
}

다음 예제에서는 JSON 데이터를 저장하기 위해 CQ_Analytics.JSONStore 개체를 만들고 등록합니다.

if (!CQ_Analytics.myJSONStore) {
    CQ_Analytics.myJSONStore = CQ_Analytics.JSONStore.registerNewInstance("myjsonstore",{});
}

컨텍스트 저장소 구성 요소 만들기 creating-a-context-store-component

Client Context에서 세션 저장소 데이터를 렌더링할 컨텍스트 저장소 구성 요소를 만듭니다. 작성되면 컨텍스트 저장소 구성 요소를 Client Context로 드래그하여 세션 저장소의 데이터를 렌더링할 수 있습니다. 컨텍스트 저장소 구성 요소는 다음 항목으로 구성됩니다.

제공된 컨텍스트 저장소 구성 요소 확장 extending-the-provided-context-store-components

AEM에서는 확장할 수 있는 genericstore 및 genericstoreproperties 컨텍스트 저장소 구성 요소를 제공합니다. 저장소 데이터 구조에 따라 확장할 구성 요소가 결정됩니다.

Sidekick에서 모양 구성 configuring-the-appearance-in-sidekick

Client Context를 편집할 때 컨텍스트 저장소 구성 요소가 Sidekick에 나타납니다. 모든 구성 요소와 마찬가지로 클라이언트 컨텍스트 구성 요소의 componentGroup 및 jcr:title 속성은 구성 요소의 그룹 및 이름을 결정합니다.

componentGroup 속성 값이 Client Context인 모든 구성 요소가 기본적으로 Sidekick에 나타납니다. componentGroup Sidekick에 다른 값을 사용하는 경우 디자인 모드를 사용하여 속성에 수동으로 추가해야 합니다.

컨텍스트 저장소 구성 요소 인스턴스 context-store-component-instances

컨텍스트 저장소 구성 요소를 Client Context에 추가하면 구성 요소 인스턴스를 나타내는 노드가 /etc/clientcontext/default/content/jcr:content/stores 아래에 만들어집니다. 이 노드에는 구성 요소의 편집 대화 상자를 사용하여 구성된 속성 값이 포함되어 있습니다.

Client Context가 초기화되면 이러한 노드가 처리됩니다.

연결된 세션 저장소 초기화 initializing-the-associated-session-store

init.js.jsp 파일을 구성 요소에 추가하여 컨텍스트 저장소 구성 요소가 사용하는 세션 저장소를 초기화하는 JavaScript 코드를 생성합니다. 예를 들어 초기화 스크립트를 사용하여 구성 요소에 대한 구성 속성을 검색하고 이를 사용하여 세션 저장소를 채웁니다.

생성된 JavaScript은 작성자 및 게시 인스턴스 모두에서 페이지 로드 시 Client Context가 초기화되면 페이지에 추가됩니다. 이 JSP는 컨텍스트 저장소 구성 요소 인스턴스가 로드되고 렌더링되기 전에 실행됩니다.

코드는 파일의 MIME 형식을 text/javascript(으)로 설정해야 합니다. 그렇지 않으면 실행되지 않습니다.

다음 절차에서는 init.js.jsp 스크립트 파일을 만들고 올바른 MIME 유형을 설정하는 코드를 추가합니다. 저장소 초기화를 수행하는 코드가 따릅니다.

genericstoreproperties 구성 요소에 대한 세션 저장소 데이터 렌더링 rendering-session-store-data-for-genericstoreproperties-components

일관된 형식을 사용하여 Client Context에 세션 저장소 데이터를 표시합니다.

속성 데이터 표시 displaying-property-data

개인화 taglib은 세션 저장소의 속성 값을 표시하는 personalization:storePropertyTag 태그를 제공합니다. 태그를 사용하려면 JSP 파일에 다음 코드 행을 포함하십시오.

<%@taglib prefix="personalization" uri="https://www.day.com/taglibs/cq/personalization/1.0" %>

태그는 다음 형식을 갖습니다.

<personalization:storePropertyTag propertyName="property_name" store="session_store_name"/>

propertyName 특성은 표시할 저장소 속성의 이름입니다. store 특성은 등록된 저장소의 이름입니다. 다음 예제 태그는 profile 저장소의 authorizableId 속성 값을 표시합니다.

<personalization:storePropertyTag propertyName="authorizableId" store="profile"/>

HTML 구조 html-structure

personalization.ui 클라이언트 라이브러리 폴더(https://experienceleague.adobe.com/etc/clientlibs/foundation/personalization/ui/themes/default?lang=ko)는 Client Context가 HTML 코드의 형식을 지정하는 데 사용하는 CSS 스타일을 제공합니다. 다음 코드는 저장소 데이터를 표시하는 데 사용할 제안된 구조를 보여 줍니다.

<div class="cq-cc-store">
   <div class="cq-cc-thumbnail">
      <div class="cq-cc-store-property">
           <!-- personalization:storePropertyTag for the store thumbnail image goes here -->
      </div>
   </div>
   <div class="cq-cc-content">
       <div class="cq-cc-store-property cq-cc-store-property-level0">
           <!-- personalization:storePropertyTag for a store property goes here -->
       </div>
       <div class="cq-cc-store-property cq-cc-store-property-level1">
           <!-- personalization:storePropertyTag for a store property goes here -->
       </div>
       <div class="cq-cc-store-property cq-cc-store-property-level2">
           <!-- personalization:storePropertyTag for a store property goes here -->
       </div>
       <div class="cq-cc-store-property cq-cc-store-property-level3">
           <!-- personalization:storePropertyTag for a store property goes here -->
       </div>
   </div>
   <div class="cq-cc-clear"></div>
</div>

/libs/cq/personalization/components/contextstores/profiledata 컨텍스트 저장소 구성 요소는 이 구조를 사용하여 프로필 세션 저장소의 데이터를 표시합니다. cq-cc-thumbnail 클래스는 축소판 이미지를 배치합니다. cq-cc-store-property-level*x* 클래스는 영숫자 데이터의 형식을 지정합니다.

genericstore 구성 요소에 대한 세션 저장소 데이터 렌더링 rendering-session-store-data-for-genericstore-components

genericstore 구성 요소를 사용하여 저장소 데이터를 렌더링하려면 다음을 수행해야 합니다.

genericstore 세션 저장소 식별 identifying-the-genericstore-session-store

개인화 taglib은 세션 저장소의 속성 값을 표시하는 personalization:storePropertyTag 태그를 제공합니다. 태그를 사용하려면 JSP 파일에 다음 코드 행을 포함하십시오.

<%@taglib prefix="personalization" uri="https://www.day.com/taglibs/cq/personalization/1.0" %>

태그는 다음 형식을 갖습니다.

<personalization:storeRendererTag store="store_name"/>

세션 저장소 렌더러 메서드 구현 implementing-the-session-store-renderer-method

세션 저장소에는 구성 요소를 렌더링해야 할 때마다 호출되는 "renderer" 메서드가 필요합니다. renderer 함수는 두 개의 매개 변수를 사용하여 호출됩니다.

세션 저장소와 상호 작용 interacting-with-session-stores

JavaScript을 사용하여 세션 스토어와 상호 작용합니다.

세션 저장소 액세스 accessing-session-stores

저장소에 데이터를 읽거나 쓸 세션 저장소 개체를 가져옵니다. CQ_Analytics.ClientContextMgr은(는) 저장소 이름을 기반으로 저장소에 대한 액세스 권한을 제공합니다. 가져온 후에는 CQ_Analytics.SessionStore 또는 CQ_Analytics.PersistedSessionStore의 메서드를 사용하여 저장소 데이터와 상호 작용합니다.

다음 예제에서는 profile 저장소를 가져온 다음 저장소에서 formattedName 속성을 검색합니다.

function getName(){
   var profilestore = CQ_Analytics.ClientContextMgr.getRegisteredStore("profile");
   if(profilestore){
      return profilestore.getProperty("formattedName", false);
   } else {
      return null;
   }
}

세션 저장소 업데이트에 대한 리스너 생성 creating-a-listener-to-react-to-a-session-store-update

세션은 실행 이벤트를 저장하므로 이러한 이벤트를 기반으로 리스너를 추가하고 이벤트를 트리거할 수 있습니다.

세션 저장소는 Observable 패턴을 기반으로 합니다. [addListener](/docs/experience-manager-65/content/implementing/developing/personlization/client-context/ccjsapi.md#addlistener-event-fct-scope) 메서드를 제공하는 CQ_Analytics.Observable을(를) 확장합니다.

다음 예제에서는 profile 세션 저장소의 update 이벤트에 수신기를 추가합니다.

var profileStore = ClientContextMgr.getRegisteredStore("profile");
if( profileStore ) {
  //callback execution context
  var executionContext = this;

  //add "update" event listener to store
  profileStore.addListener("update",function(store, property) {
    //do something on store update

  },executionContext);
}

세션 저장소가 정의 및 초기화되었는지 확인하는 중 checking-that-a-session-store-is-defined-and-initialized

세션 저장소는 데이터로 로드되고 초기화될 때까지 사용할 수 없습니다. 다음 요소는 세션 저장소 사용 가능 시점에 영향을 줄 수 있습니다.

사용 가능한 경우에만 세션 저장소에 액세스하려면 CQ_Analytics.ClientContextUtils 개체의 onStoreRegistered 및 onStoreInitialized 메서드를 사용하십시오. 이러한 메서드를 사용하면 세션 등록 및 초기화 이벤트에 반응하는 이벤트 리스너를 등록할 수 있습니다.

다음 예제에서는 profile 세션 저장소의 onStoreRegistered 이벤트를 사용합니다. 저장소가 등록되면 세션 저장소의 update 이벤트에 수신기가 추가됩니다. 스토어가 업데이트되면 페이지의 <div class="welcome"> 요소 콘텐츠가 profile 스토어의 이름으로 업데이트됩니다.

//listen for the store registration
CQ_Analytics.ClientContextUtils.onStoreRegistered("profile", listen);

//listen for the store's update event
function listen(){
 var profilestore = CQ_Analytics.ClientContextMgr.getRegisteredStore("profile");
    profilestore.addListener("update",insertName);
}

//insert the welcome message
function insertName(){
 $("div.welcome").text("Welcome "+getName());
}

//obtain the name from the profile store
function getName(){
 var profilestore = CQ_Analytics.ClientContextMgr.getRegisteredStore("profile");
 if(profilestore){
  return profilestore.getProperty("formattedName", false);
    } else {
        return null;
    }
}

sessionpersistence 쿠키에서 속성 제외 excluding-a-property-from-the-sessionpersistence-cookie

PersistedSessionStore의 속성이 지속되지 않도록 하려면(즉, sessionpersistence 쿠키에서 제외) 속성을 지속된 세션 저장소의 비지속된 속성 목록에 추가하십시오.

[CQ_Analytics.PersistedSessionStore.setNonPersisted(propertyName)](/docs/experience-manager-65/content/implementing/developing/personlization/client-context/ccjsapi.md#setnonpersisted-name) 보기

CQ_Analytics.ClientContextUtils.onStoreRegistered("surferinfo", function(store) {
  //this will exclude the browser, OS and resolution properties of the surferinfo session store from the
  store.setNonPersisted("browser");
  store.setNonPersisted("OS");
  store.setNonPersisted("resolution");
});

장치 슬라이더 구성 configuring-the-device-slider

조건 conditions

현재 페이지에는 해당 모바일 페이지가 있어야 합니다. 이는 페이지에 모바일 롤아웃 구성으로 구성된 LiveCopy가 있는 경우에만 결정됩니다(rolloutconfig.path.toLowerCase에 mobile이(가) 포함되어 있습니다).

구성 configuration

데스크탑 페이지에서 모바일로 전환하는 경우:

예:

window.CQMobileSlider["geometrixx-outdoors"] = {
  //CSS used by desktop that need to be removed when mobile
  DESKTOP_CSS: [
    "/etc/designs/${app}/clientlibs_desktop_v1.css"
  ],

  //CSS used by mobile that need to be removed when desktop
  MOBILE_CSS: [
    "/etc/designs/${app}/clientlibs_mobile_v1.css"
  ],

  //id of the content that needs to be removed when mobile
  DESKTOP_MAIN_ID: "main",

  //id of the content that needs to be removed when desktop
  MOBILE_MAIN_ID: "main",

  //body classes used by desktop that need to be removed when mobile
  DESKTOP_BODY_CLASS: [
    "page"
  ],

  //body classes used by mobile that need to be removed when desktop
  MOBILE_BODY_CLASS: [
    "page-mobile"
  ]
};

예제: 사용자 지정 컨텍스트 저장소 구성 요소 만들기 example-creating-a-custom-context-store-component

이 예제에서는 외부 서비스에서 데이터를 검색하고 이를 세션 저장소에 저장하는 컨텍스트 저장소 구성 요소를 만듭니다.

geoloc 구성 요소 추가 add-the-geoloc-component

CQ 응용 프로그램을 만들고 geoloc 구성 요소를 추가합니다.

Geoloc 편집 대화 상자 만들기 create-the-geoloc-edit-dialog

컨텍스트 저장소 구성 요소에는 편집 대화 상자가 필요합니다. geoloc 편집 대화 상자에는 구성할 속성이 없음을 나타내는 정적 메시지가 포함되어 있습니다.

초기화 스크립트 만들기 create-the-initialization-script

geoloc 구성 요소에 init.js.jsp 파일을 추가하고, 이 파일을 사용하여 세션 저장소를 생성하고 위치 데이터를 검색한 다음 저장소에 추가합니다.

init.js.jsp 파일은 Client Context가 페이지에 의해 로드될 때 실행됩니다. 이 시간까지 Client Context JavaScript API가 로드되어 스크립트에 사용할 수 있습니다.

geoloc 세션 저장소 데이터 렌더링 render-the-geoloc-session-store-data

Client Context에서 스토어 데이터를 렌더링하도록 geoloc 구성 요소의 JSP 파일에 코드를 추가합니다.

클라이언트 컨텍스트에 구성 요소 추가 add-the-component-to-client-context

페이지가 로드될 때 초기화되도록 위치 저장소 구성 요소를 Client Context에 추가합니다.

Client Context에서 위치 정보 보기 see-the-location-information-in-client-context

편집 모드로 Geometrixx Outdoors 홈 페이지를 연 다음 Client Context를 열어 위치 저장소 구성 요소의 데이터를 봅니다.

사용자 지정된 클라이언트 컨텍스트 만들기 creating-a-customized-client-context

두 번째 클라이언트 컨텍스트를 작성하려면 분기를 복제하십시오.

/etc/clientcontext/default

사용자 지정된 클라이언트 컨텍스트를 사용하려면 속성을 편집합니다
path
페이지 템플릿에 포함된 클라이언트 컨텍스트 구성 요소의 디자인 스타일에서. 예를 들어 를 의 표준 위치로 사용합니다.
/libs/cq/personalization/components/clientcontext/design_dialog/items/path