ClientContext

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

在發佈和作者環境中，它都會顯示以下資訊：

• 訪客；視您的例項而定，會要求或衍生特定資訊。
• 頁面標籤和目前訪客存取這些標籤的次數（當您將滑鼠移至特定標籤上方時，會顯示此點）。
• 頁面資訊。
• 有關技術環境的資訊；例如IP位址、瀏覽器和螢幕解析度。
• 目前已解決的任何區段。

圖示（僅在作者環境中提供）允許您配置客戶端上下文的詳細資訊：

• 編
  輯新頁面將會開啟，供您 編輯、新增或移除描述檔屬性。

• 載
  入您可 以從描述檔清單中選取並載入您要 測試的描述檔。

• 重
  設您可 以重設 目前使用者的描述檔。

可用的客戶端上下文元件

「客戶端上下文」可顯示以下屬性（取決於使用Edit選擇的內容）:

Surfer 資訊顯示下列用戶端資訊：

• IP位址
• 用於 搜尋引擎反向連結的關鍵字
• 使用​browser
• 使用的​OS（作業系統）
• 螢幕​解析度
• 滑鼠X​位置
• 滑鼠Y​位置

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

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

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

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

購物車作業商店也會使用ClientContextCartServlet通知伺服器已解決的促銷變更（根據區段變更）。

通用 商店是顯示商店內容的通用元件。它是通用商店屬性元件的低階版本。

Generic Store必須設定JS轉譯器，以自訂方式顯示資料。

通用商店 屬性是顯示商店內容的通用元件。它是Generic Store元件的更高級別版本。

「一般商店屬性」元件包含預設轉譯器，列出已設定的屬性（連同縮圖）。

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

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

JSONP StoreA元件，可顯示與您的安裝相關的內容。

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

JSONP商店和其他商店一樣，但是它會載入來自其他網域的資訊，而不需要擁有目前網域上該資訊的代理程式。 請參閱透過JSONP將資料儲存在用戶端內容中的範例。

描述 檔資料顯示在使用者描述檔中收集的資訊。例如，性別、年齡、電子郵件地址等。

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

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

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

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

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

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

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

如需詳細資訊，請參閱詳細資訊中的「用戶端內容」。

更改客戶端上下文配置檔案

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

• 變更「用戶端內容」中使用的描述檔可讓您查看不同使用者在目前頁面上看到的不同體驗。
• 除了變更使用者描述檔外，您也可以變更一些描述檔詳細資訊，以檢視不同條件下的頁面體驗差異。

載入新用戶配置檔案

您可以透過下列任一方式變更描述檔：

• 使用載入圖示
• 使用選取滑桿

完成後，您可以重設描述檔。

使用載入描述檔圖示載入新訪客描述檔

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

   

2. 這將開啟該對話框，您可以在此處選擇要載入的配置檔案：

   

3. 按一下​確定​載入。

使用選擇滑塊載入新用戶配置檔案

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

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

   

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

將配置檔案重置為當前用戶

1. 使用重設圖示，將用戶端內容中的描述檔傳回至目前使用者的描述檔：

   

變更瀏覽器平台

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

   

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

更改地理位置

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

   

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

變更標籤選擇

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

   

2. 按一下「確定」以載入「用戶端內容」。

編輯客戶端上下文

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

編輯屬性詳細資訊

編輯用戶端內容可用來設定（或重設）特定屬性的值。 這可讓您測試特定藍本（對segmentation和促銷活動特別有用）。

添加屬性元件

開啟​ClientContext設計頁​後，也可以使用可用元件​添加​全新屬性（元件列在側鍵上，或列在​拖曳元件或資產此處<a6/>後開啟的​插入新元件​對話框中）7/>包裝盒：

刪除屬性元件

開啟​ClientContext設計頁​後，如果不再需要，也可以​Remove​屬性。 其中包括現成可用的屬性；Reset​如果已移除這些項目，將重新建立這些項目。

透過JSONP在用戶端內容中儲存資料

請依照此範例，使用JSONP Store內容儲存元件，將外部資料新增至「用戶端內容」。 然後，根據該資料的資訊建立區段。 此示例使用WIPmania.com提供的JSONP服務。 該服務根據Web客戶端的IP地址返回地理位置資訊。

此範例使用Geometrixx Outdoors範例網站來存取「用戶端內容」並測試建立的區段。 只要頁面已啟用「用戶端內容」，您就可以使用不同的網站。 （請參閱將客戶端上下文添加到頁面。）

添加JSONP儲存元件

將JSONP Store元件添加到Client Context中，並使用它檢索和儲存有關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 Store元件拖動到Client Context。

   

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

6. 在「JSONP服務URL」方塊中，輸入下列URL，然後按一下「擷取商店」:

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

   該元件調用JSONP服務並列出返回資料包含的所有屬性。 清單中的屬性是將可在用戶端內容中使用的屬性。

   

7. 按一下「確定」。

8. 返回Geometrixx Outdoors首頁並重新整理頁面。 Client Context現在包含來自JSONP Store元件的資訊。

   

建立區段

使用您使用JSONP儲存元件建立的會話儲存中的資料。 區段會使用作業商店的緯度和目前日期來判斷是否是客戶所在位置的冬季時間。

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

2. 在資料夾樹狀結構中，按一下「工具／區段」資料夾，然後按一下「新增>新資料夾」。 指定下列屬性值，然後按一下「建立」:

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

3. 選取「我的區段」檔案夾，然後按一下「新增>新增頁面」:

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

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

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

   

6. 連按兩下元件以開啟編輯對話方塊，指定下列屬性值，然後按一下「確定」:

   • 商店：wipmania
   • 屬性名稱：緯度
   • 運算元：大於
   • 屬性值：30

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

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