文件AEM 6.4Administering 指南

ClientContext client-context

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 管理員
CAUTION
AEM 6.4已結束延伸支援，本檔案不再更新。 如需詳細資訊，請參閱 技術支援期. 尋找支援的版本 此處.
NOTE
客戶端上下文已被ContextHub取代。 如需詳細資訊，請參閱 配置 和 開發人員 檔案。

「用戶端內容」是一種機制，可提供您目前頁面和訪客的特定資訊。 可使用 Ctrl-Alt-c (windows)或 control-option-c (Mac):

clientcontext_alisonparker

在發佈與製作環境中，都會顯示下列相關資訊：

  • 訪客；根據您的執行個體，會要求或衍生特定資訊。
  • 頁面標籤以及目前訪客存取這些標籤的次數（當您將滑鼠移至特定標籤上方時，就會顯示）。
  • 頁面資訊。
  • 技術環境資訊；例如IP位址、瀏覽器和螢幕解析度。
  • 目前已解析的任何區段。

圖示（僅限製作環境中使用）可讓您設定用戶端內容的詳細資訊：

可用的客戶端上下文元件 available-client-context-components

用戶端內容可顯示下列屬性(視使用編輯選取的項目而定):

瀏覽者資訊 顯示下列用戶端資訊：

  • the IP位址
  • 關鍵字 用於搜尋引擎反向連結
  • the 瀏覽器 正在使用
  • the 作業系統 （作業系統）使用
  • 畫面 解析度
  • the 滑鼠X position
  • the 滑鼠Y position

活動資料流 這可提供使用者在各種平台上的社交活動相關資訊；例如，AEM論壇、部落格、評等等。

行銷活動 可讓作者模擬促銷活動的特定體驗。 此元件會覆寫一般促銷活動解析度和體驗選取，以啟用各種排列的測試。

促銷活動解析度通常以促銷活動的優先順序屬性為基礎。 體驗通常會根據區段來選取。

購物車 顯示購物車資訊，包括產品條目（標題、數量、價格格式化等）、解析的促銷活動（標題、消息等） 和憑單（代碼、說明等）。

購物車工作階段存放區也會使用ClientContextCartServlet通知伺服器已解析的促銷變更（根據分段變更）。

一般商店 是顯示商店內容的通用元件。 它是通用儲存屬性元件的較低級別版本。

一般存放區必須以JS轉譯器設定，且轉譯器會以自訂方式顯示資料。

一般儲存屬性 是顯示商店內容的通用元件。 它是通用儲存元件的更高級別版本。

「通用儲存屬性」元件包含一個預設的轉譯器，該轉譯器列出配置的屬性（連同縮圖）。

地理位置 顯示用戶端的經緯度。 它會使用HTML5地理位置API來查詢瀏覽器的目前位置。 這會導致快顯視窗顯示給訪客，瀏覽器會在快顯視窗中詢問訪客是否同意共用其位置。

在Context Cloud中顯示時，元件會使用Google API將地圖顯示為縮圖。 元件須受Google API約束 使用限制.

NOTE
在AEM 6.1中，地理位置存放區不再提供反向地理編碼功能。 因此，地理位置存放區不再擷取目前位置的詳細資訊，例如城市名稱或國家/地區代碼。 使用此存放區資料的區段無法正常運作。 地理位置存放區僅包含位置的經緯度。

JSONP商店 顯示與安裝相關內容的元件。

JSONP標準是JSON的補充，可規避相同的來源政策（使網頁應用程式無法與位於其他網域的伺服器通訊）。 它包含將JSON物件包裝在函式呼叫中，以便能夠從其他網域（這是相同來源原則允許的例外）將其載入。

JSONP儲存區與任何其他儲存區一樣，但它載入來自其他網域的資訊，而不需要擁有代理來取得目前網域的資訊。 請參閱 透過JSONP在用戶端內容中儲存資料.

NOTE
JSONP儲存區不會快取Cookie中的資訊，但會在每次頁面載入時擷取該資料。

設定檔資料 顯示在用戶配置檔案中收集的資訊。 例如性別、年齡、電子郵件地址等。

解析的區段 顯示目前解析的區段（通常取決於用戶端內容中顯示的其他資訊）。 這在設定促銷活動時很有意義。

例如，滑鼠當前是位於窗口的左手部分還是右手部分。 此區段主要用於測試，因為可立即看到變更。

社交圖表 顯示使用者朋友和追隨者的社交圖表。

NOTE
目前，此示範功能需仰賴示範使用者設定檔節點上預先設定的資料集來運作。 例如，請參閱：
/home/users/geometrixx/aparker@geometrixx.info/profile =>朋友屬性

Tag Cloud 顯示在目前頁面上設定的標籤，以及瀏覽網站時收集的標籤。 將滑鼠移至標籤上會顯示目前使用者存取包含該特定標籤之頁面的次數。

NOTE
在DAM資產上設定的標籤若顯示在已造訪的頁面上，則不會計入。

Technographics商店 此元件取決於您的安裝。

已查看的產品 追蹤購物者已檢視的產品。 可以查詢最近查看的產品，或購物車中尚未查看的最近查看的產品。

此會話儲存沒有預設的客戶端上下文元件。

如需詳細資訊，請參閱 詳細的客戶端上下文.

NOTE
頁面資料不再是在用戶端內容中作為預設元件。 如有需要，您可以編輯用戶端內容並新增 一般儲存屬性 元件，然後進行設定以定義 商店 as pagedata.

更改客戶端上下文配置檔案 changing-the-client-context-profile

客戶端上下文允許您交互更改詳細資訊：

  • 變更用戶端內容中使用的設定檔可讓您查看不同使用者在目前頁面會看到的不同體驗。
  • 除了變更使用者設定檔，您還可以變更一些設定檔詳細資訊，以了解不同條件下的頁面體驗差異。

載入新的使用者設定檔 loading-a-new-user-profile

您可以透過下列任一項來變更設定檔：

完成後，您可以 重設設定檔.

使用載入描述檔圖示載入新的訪客描述檔 loading-a-new-visitor-profile-with-the-load-profile-icon

  1. 按一下「載入描述檔」圖示：

  2. 這會開啟對話方塊，您可以在此處選取要載入的設定檔：

    clientcontext_profileloader

  3. 按一下 確定 來載入。

使用選取滑桿載入新的使用者設定檔 loading-a-new-user-profile-with-the-selection-slider

您也可以使用選取滑桿選取描述檔：

  1. 連按兩下代表目前使用者的圖示。 選取器將會開啟，使用箭頭來導覽並查看可用的設定檔：

    clientcontext_profileselector

  2. 按一下您要載入的設定檔。 載入詳細資料時，按一下選取器外部以關閉。

將設定檔重設為目前使用者 resetting-the-profile-to-the-current-user

  1. 使用重設圖示將用戶端內容中的設定檔傳回給目前使用者的設定檔：

變更瀏覽器平台 changing-the-browser-platform

  1. 連按兩下代表瀏覽器平台的圖示。 選取器將會開啟，使用箭頭來導覽並查看可用的平台/瀏覽器：

    clientcontext.browserplatform

  2. 按一下您要載入的平台瀏覽器。 載入詳細資料時，按一下選取器外部以關閉。

變更地理位置 changing-the-geolocation

  1. 連按兩下地理位置圖示。 將會開啟展開的地圖，您可以在此處將標籤拖曳到新位置：

    clientcontext_geomocationrelocation

  2. 按一下地圖外部以關閉。

變更標籤選取項目 changing-the-tag-selection

  1. 連按兩下用戶端內容的「標籤雲端」區段。 對話方塊將會開啟，您可在此選取標籤：

    clientcontext.tagselection

  2. 按一下「確定」以載入到客戶端上下文。

編輯用戶端內容 editing-the-client-context

編輯用戶端內容可用來設定（或重設）某些屬性的值、新增屬性或移除不再需要的屬性。

編輯屬性詳細資訊 editing-property-details

編輯用戶端內容可用來設定（或重設）特定屬性的值。 這可讓您測試特定藍本(對 細分 和 行銷活動)。

clientcontext_alisonparker_edit

新增屬性元件 adding-a-property-component

在您開啟 ClientContext設計頁面 ​您也可以 新增 使用可用元件的全新屬性(元件會列在sidekick上或從 插入新元件 對話方塊，在 將元件或資產拖曳至此處 框):

clientcontext_alisonparker_new

移除屬性元件 removing-a-property-component

在您開啟 ClientContext設計頁面 ​您也可以 移除 屬性（若不再需要）。 這包括現成可用的屬性； 重設 如果移除，將會恢復這些。

透過JSONP在用戶端內容中儲存資料 storing-data-in-client-context-via-jsonp

請依照此示例使用JSONP儲存上下文儲存元件將外部資料添加到客戶端上下文。 接著，根據該資料中的資訊建立區段。 此示例使用WIPmania.com提供的JSONP服務。 該服務基於Web客戶端的IP地址返回地理位置資訊。

此範例使用Geometrixx Outdoors範例網站來存取「用戶端內容」並測試建立的區段。 只要頁面已啟用「用戶端內容」，您就可以使用不同的網站。 (請參閱 新增用戶端內容至頁面.)

添加JSONP儲存元件 add-the-jsonp-store-component

將JSONP儲存元件添加到客戶端上下文，並使用它檢索和儲存有關Web客戶端的地理位置資訊。

  1. 開啟AEM製作例項上Geometrixx Outdoors網站的英文首頁。 (http://localhost:4502/content/geometrixx-outdoors/en.html)。

  2. 若要開啟「用戶端內容」，請按Ctrl-Alt-c(windows)或control-option-c(Mac)。

  3. 按一下「客戶端上下文」頂部的編輯表徵圖以開啟「客戶端上下文設計器」。

  4. 將JSONP儲存元件拖曳至用戶端內容。

    chlimage_1-40

  5. 按兩下元件以開啟編輯對話方塊。

  6. 在「JSONP服務URL」框中，輸入以下URL，然後按一下「提取儲存」：

    https://api.wipmania.com/jsonp?callback=${callback}

    元件會呼叫JSONP服務，並列出傳回資料包含的所有屬性。 清單中的屬性是那些將在客戶端上下文中可用的屬性。

    chlimage_1-274

  7. 按一下「確定」。

  8. 返回Geometrixx Outdoors首頁並重新整理頁面。 用戶端內容現在包含來自JSONP儲存元件的資訊。

    chlimage_1-275

建立區段 create-the-segment

使用您使用JSONP儲存元件建立的工作階段存放區資料。 區段會使用工作階段存放區的緯度和目前日期，判斷是否為用戶端位置的冬季時間。

  1. 在網頁瀏覽器中開啟工具主控台(http://localhost:4502/miscadmin#/etc)。

  2. 在資料夾樹中，按一下「工具/分段」資料夾，然後按一下「新增>新增資料夾」。 指定下列屬性值，然後按一下「建立」：

    • 名稱：mysegments
    • 標題：我的區段

  3. 選取「我的區段」資料夾，然後按一下「新增>新增頁面」：

    1. 在「Title（標題）」中，鍵入Winter。
    2. 選取「區段」範本。
    3. 按一下建立。

  4. 以滑鼠右鍵按一下「冬季」區段，然後按一下「開啟」。

  5. 將「一般商店屬性」拖曳至預設的AND容器。

    chlimage_1-41

  6. 按兩下元件以開啟編輯對話框，指定以下屬性值，然後按一下確定：

    • 商店：維馬尼亞
    • 屬性名稱：latitude
    • 運算子：大於
    • 屬性值：30

  7. 將指令碼元件拖曳至相同的AND容器，並開啟其編輯對話方塊。 添加以下指令碼，然後按一下「確定」：

    3 < new Date().getMonth() < 12

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8