設定Cookie使用情形

AEM提供的服務可讓您設定及控制如何在您的網頁中使用cookie:

• 可設定的伺服器端服務會維護可使用的Cookie清單。
• Javascript API可讓您的Javascript程式碼驗證是否可使用Cookie。

使用此功能可確保您的頁面符合使用者對Cookie使用方式的同意。

設定允許的Cookie

設定AdobeGranite選擇退出服務，以指定在您的網頁上使用Cookie的方式。 下表說明了可配置的屬性。

若要設定服務，您可以使用 Web主控台 或 將OSGi設定新增至存放庫. 下表說明了任何一種方法所需的屬性。 若為OSGi設定，服務PID為 com.adobe.granite.optout.

驗證Cookie使用情形

使用用戶端javascript來呼叫AdobeGranite選擇退出服務，以確認您可以使用Cookie。 使用Granite.OptOutUtil Javascript物件執行下列任一作業：

• 取得Cookie名稱清單，指出該使用者不同意將Cookie用於追蹤用途。
• 取得可使用的Cookie清單。
• 判斷網頁瀏覽器是否包含指出使用者不同意使用Cookie進行追蹤的Cookie。
• 判斷是否可使用特定Cookie。

granite.utils 用戶庫資料夾 提供Granite.OptOutUtil物件。 將下列程式碼新增至您的頁面標題JSP，以包含javascript程式庫的連結：

<ui:includeClientLib categories="granite.utils" />

例如，下列javascript函式會決定在寫入COOKIE_NAME Cookie之前，是否允許使用COOKIE_NAME Cookie:

function writeCookie(value){
   if (!Granite.OptOutUtil.maySetCookie("COOKIE_NAME"))
      return;
   if (value) {
      value = encodeURIComponent(value);
      document.cookie = "COOKIE_NAME=" + value;
   }
}

Granite.OptOutUtil Javascript物件

Granite.OptOutUtil可讓您判斷是否允許使用Cookie。

getCookieNames()函式

傳回Cookie的名稱，若存在，即表示使用者未同意使用Cookie。

參數

無.

傳回

Cookie名稱的陣列。

getWhitelistCookieNames()函式

傳回無論使用者同意為何皆可使用的Cookie名稱。

參數

無.

傳回

Cookie名稱的陣列。

isOptedOut()函式

判斷使用者的瀏覽器是否包含任何表示尚未同意使用Cookie的Cookie。

參數

無.

傳回

的布林值 true 若找到未表示同意的Cookie，則 false 如果沒有cookie表示不同意。

maySetCookie(cookieName)函式

判斷是否可在使用者的瀏覽器上使用特定Cookie。 此函式等同於使用 isOptedOut 函式，並判斷指定的Cookie是否包含在 getWhitelistCookieNames 函式會傳回。

參數

• cookieName:字串。 Cookie的名稱。

傳回

的布林值 true if cookieName 可供使用，或 false if cookieName 無法使用。

Business.Adobe.com 資源

Ecommerce Integrations Auto Text Summarization Embedded Charts Mobile Forms Web Content Management Content Management System