Client Context JavaScript API client-context-javascript-api

CQ_Analytics.ClientContextMgr cq-analytics-clientcontextmgr

CQ_Analytics.ClientContextMgr物件是包含一組自我註冊工作階段存放區的單一物件，並提供註冊、持續和管理工作階段存放區的方法。

擴充CQ_Analytics.PersistedSessionStore。

方法 methods

getRegisteredStore(name) getregisteredstore-name

傳回指定名稱的工作階段存放區。 另請參閱存取工作階段存放區。

引數

傳回

CQ_Analytics.SessionStore物件，代表指定名稱的工作階段存放區。 指定名稱不存在存放區時傳回null。

register(sessionstore) register-sessionstore

向Client Context註冊工作階段存放區。 完成時引發storeregister和storeupdate事件。

引數

傳回

沒有傳回值。

CQ_Analytics.ClientContextUtils cq-analytics-clientcontextutils

提供監聽工作階段存放區啟用和註冊的方法。 另請參閱檢查工作階段存放區是否已定義及初始化。

方法 methods-1

onStoreInitialized(storeName， callback， delay) onstoreinitialized-storename-callback-delay

註冊當工作階段存放區初始化時所呼叫的回呼函式。 對於已初始化多次的存放區，請指定回呼延遲，使回呼函式只呼叫一次：

例如，工作階段存放區是以JSON物件為基礎，並透過JSON要求擷取。 可能的初始化案例如下：

當延遲設定為true或數毫秒時，方法會先等候再呼叫回呼方法。 如果在傳遞延遲之前觸發另一個初始化事件，則會等到超過延遲時間再觸發初始化事件。 這可讓等候觸發第二個初始化事件，並在最佳情況下呼叫回呼函式。

引數

傳回

沒有傳回值。

onStoreRegistered(storeName， callback) onstoreregistered-storename-callback

註冊在註冊工作階段存放區時所呼叫的回呼函式。 將存放區註冊到CQ_Analytics.ClientContextMgr時，會發生註冊事件。

引數

傳回

沒有傳回值。

CQ_Analytics.JSONPStore cq-analytics-jsonpstore

包含JSON資料的非持續性工作階段存放區。 資料會從外部JSONP服務擷取。 使用getInstance或getRegisteredInstance方法建立此類別的執行個體。

擴充CQ_Analytics.JSONStore。

屬性 properties

如需繼承的屬性，請參閱CQ_Analytics.JSONStore和CQ_Analytics.SessionStore 。

方法 methods-2

另請參閱CQ_Analytics.JSONStore和CQ_Analytics.SessionStore以瞭解繼承的方法。

getInstance(storeName， serviceURL， dynamicData， deferLoading， loadingCallback) getinstance-storename-serviceurl-dynamicdata-deferloading-loadingcallback

建立CQ_Analytics.JSONPStore物件。

引數

傳回

新的CQ_Analytics.JSONPStore物件，或如果storeName為null則為null。

getServiceURL() getserviceurl

擷取此物件用於擷取JSON資料的JSONP服務URL。

引數

無。

傳回

代表服務URL的字串；若未設定服務URL，則為null。

load(serviceURL， dynamicData， callback) load-serviceurl-dynamicdata-callback

呼叫JSONP服務。 JSONP URL是尾碼為給定回呼函式名稱的服務URL。

引數

傳回

沒有傳回值。

registerNewInstance(storeName， serviceURL， dynamicData， callback) registernewinstance-storename-serviceurl-dynamicdata-callback

建立CQ_Analytics.JSONPStore物件，並將存放區註冊到Client Context。

引數

傳回

已註冊的CQ_Analytics.JSONPStore物件。

setServiceURL(serviceURL) setserviceurl-serviceurl

設定用於擷取JSON資料的JSONP服務URL。

引數

傳回

沒有傳回值。

CQ_Analytics.JSONStore cq-analytics-jsonstore

JSON物件的容器。 建立此類別的例項，以建立包含JSON資料的非持續性工作階段存放區：

myjsonstore = new CQ_Analytics.JSONStore

您可以定義一組資料，在初始化時填入存放區。

擴充CQ_Analytics.SessionStore。

屬性 properties-1

STOREKEY storekey

用來識別存放區的金鑰。 使用getInstance方法擷取此值。

STORENAME storename

存放區的名稱。 使用getInstance方法擷取此值。

方法 methods-3

如需繼承的方法，另請參閱CQ_Analytics.SessionStore 。

clear() clear

移除工作階段存放區資料，並移除所有初始化屬性。

引數

無。

傳回

沒有傳回值。

getInstance(storeName， jsonData) getinstance-storename-jsondata

以指定名稱建立CQ_Analytics.JSONStore物件，並以指定JSON資料初始化（呼叫initJSON方法）。

引數

傳回

cq_Analytics.JSONStore物件。

getJSON() getjson

擷取工作階段存放區的JSON格式資料。

引數

無。

傳回

以JSON格式表示存放區資料的物件。

init() init

清除工作階段存放區，並使用初始化屬性將其初始化。 將初始化旗標設為true，然後引發initialize和update事件。

引數

無。

傳回

沒有傳回的資料。

initJSON(jsonData， doNotClear) initjson-jsondata-donotclear

從JSON物件中的資料建立初始化屬性。 您可以選擇移除所有現有的初始化屬性。

屬性的名稱衍生自JSON物件中的資料階層。 以下範常式式碼代表JSON物件：

{
A: "valueA",
B: {
     B1: "valueBB1"
    }
}

在此範例中，會在存放區中建立下列屬性：

A: "valueA"
B/B1: "valueBB1"

引數

傳回

沒有傳回值。

registerNewInstance(storeName， jsonData) registernewinstance-storename-jsondata

以指定名稱建立CQ_Analytics.JSONStore物件，並以指定JSON資料初始化（呼叫initJSON方法）。 新物件會自動向Clickstream Cloud Manager註冊。

引數

傳回

cq_Analytics.JSONStore物件。

CQ_Analytics.Observable cq-analytics-observable

引發事件並允許其他物件接聽這些事件並做出反應。 擴充此類別的類別可能會引發事件，進而導致呼叫接聽程式。

方法 methods-4

addListener(event， fct， scope) addlistener-event-fct-scope

註冊事件的監聽器。 另請參閱建立接聽程式以回應工作階段存放區更新。

引數

傳回

沒有傳回值。

removeListener(event， fct) removelistener-event-fct

移除事件的指定事件處理常式。

引數

傳回

沒有傳回值。

CQ_Analytics.PersistedJSONPStore cq-analyics-persistedjsonpstore

從遠端JSONP服務擷取之JSON物件的持續容器。

擴充CQ_Analytics.PersistedJSONStore。

方法 methods-5

如需繼承方法，另請參閱CQ_Analytics.PersistedJSONStore 。

getInstance(storeName， serviceURL， dynamicData， deferLoading， loadingCallback) getinstance-storename-serviceurl-dynamicdata-deferloading-loadingcallback-1

建立CQ_Analytics.PersistedJSONPStore物件。

引數

傳回

新的CQ_Analytics.PersistedJSONPStore物件，或Null （如果storeName為Null）。

getServiceURL() getserviceurl-1

擷取此物件用於擷取JSON資料的JSONP服務URL。

引數

無。

傳回

代表服務URL的字串；若未設定服務URL，則為null。

load(serviceURL， dynamicData， callback) load-serviceurl-dynamicdata-callback-1

呼叫JSONP服務。 JSONP URL是尾碼為給定回呼函式名稱的服務URL。

引數

傳回

沒有傳回值。

registerNewInstance(storeName， serviceURL， dynamicData， callback) registernewinstance-storename-serviceurl-dynamicdata-callback-1

建立CQ_Analytics.PersistedJSONPStore物件，並將存放區註冊到Client Context。

引數

傳回

已登入的CQ_Analytics.PersistedJSONPStore物件。

setServiceURL(serviceURL) setserviceurl-serviceurl-1

設定用於擷取JSON資料的JSONP服務URL。

引數

傳回

沒有傳回值。

CQ_Analytics.PersistedJSONStore cq-analytics-persistedjsonstore

JSON物件的持續容器。

延伸CQ_Analytics.PersistedSessionStore。

屬性 properties-2

STOREKEY storekey-1

用來識別存放區的金鑰。 使用getInstance方法擷取此值。

STORENAME storename-1

存放區的名稱。 使用getInstance方法擷取此值。

方法 methods-6

另請參閱CQ_Analytics.PersistedSessionStore以瞭解繼承的方法。

getInstance(storeName， jsonData) getinstance-storename-jsondata-1

以指定名稱建立CQ_Analytics.PersistedJSONStore物件，並以指定JSON資料初始化（呼叫initJSON方法）。

引數

傳回

cq_Analytics.PersistedJSONStore物件。

getJSON() getjson-1

擷取工作階段存放區的JSON格式資料。

引數

無。

傳回

以JSON格式表示存放區資料的物件。

initJSON(jsonData， doNotClear) initjson-jsondata-donotclear-1

從JSON物件中的資料建立初始化屬性。 您可以選擇移除所有現有的初始化屬性。

屬性的名稱衍生自JSON物件中的資料階層。 以下範常式式碼代表JSON物件：

{
A: "valueA",
B: {
     B1: "valueBB1"
    }
}

在此範例中，會在存放區中建立下列屬性：

A: "valueA"
B/B1: "valueBB1"

引數

傳回

沒有傳回值。

registerNewInstance(storeName， jsonData) registernewinstance-storename-jsondata-1

以指定名稱建立CQ_Analytics.PersistedJSONStore物件，並以指定JSON資料初始化（呼叫initJSON方法）。 新物件會自動註冊到Client Context Manager。

引數

傳回

cq_Analytics.PersistedJSONStore物件。

CQ_Analytics.PersistedSessionStore cq-analytics-persistedsessionstore

屬性和值的容器。 資料會使用CQ_Analytics.SessionPersistence持續儲存。 建立此類別的執行個體以建立持續的工作階段存放區：

mypersistedstore = new CQ_Analytics.PersistedSessionStore

擴充CQ_Analytics.SessionStore。

屬性 properties-3

STOREKEY storekey-2

預設值為key。

方法 methods-7

如需繼承的方法，請參閱CQ_Analytics.SessionStore 。

當使用繼承的方法clear、setProperty、setProperties、removeProperty來變更存放區資料時，除非已變更的屬性標示為notPersisted，否則會自動保留變更。

getStoreKey() getstorekey

擷取STOREKEY屬性。

引數

無

傳回

STOREKEY屬性的值。

isPersisted(name) ispersisted-name

決定是否保留資料屬性。

引數

傳回

如果屬性持續存在，則布林值為true；如果值不是持續屬性，則值為false。

persist() persist

儲存工作階段存放區。 預設持續性模式使用瀏覽器localStorage，使用ClientSidePersistence做為名稱( window.localStorage.set("ClientSidePersistance", store);)

如果localStorage無法使用或無法寫入，則會將存放區保留為視窗的屬性。

完成時引發persist事件。

引數

無

傳回

沒有傳回值。

reset(deferEvent) reset-deferevent

從存放區移除所有資料屬性，並保留存放區。 選擇性地不在完成時引發udpate事件。

引數

傳回

沒有傳回值。

setNonPersisted(name) setnonpersisted-name

將資料屬性標示為未保留。

引數

傳回

沒有傳回值。

cq_Analytics.SessionStore cq-analytics-sessionstore

CQ_Analytics.SessionStore代表工作階段存放區。 建立此類別的執行個體以建立工作階段存放區：

mystore = new CQ_Analytics.SessionStore

擴充CQ_Analytics.Observable。

屬性 properties-4

STORENAME storename-2

工作階段存放區的名稱。 使用getName擷取此屬性的值。

方法 methods-8

addInitProperty(name， value) addinitproperty-name-value

將屬性和值新增至工作階段存放區初始化資料。

使用loadInitProperties以初始化值填入工作階段存放區資料。

引數

傳回

沒有傳回值。

clear() clear-1

從存放區移除所有資料屬性。

引數

無。

傳回

沒有傳回值。

getData(excluded) getdata-excluded

傳回存放區資料。 可選擇性地從資料中排除名稱屬性。 如果存放區的資料屬性不存在，則呼叫init方法。

引數

已排除： （選用）要從傳回資料排除的屬性名稱陣列。

傳回

屬性及其值的物件。

getInitProperty(name) getinitproperty-name

擷取資料屬性的值。

引數

傳回

資料屬性的值。 如果工作階段存放區不包含指定名稱的屬性，則會傳回null。

getName() getname

傳回工作階段存放區的名稱。

引數

無。

傳回

代表存放區名稱的字串值。

getProperty(name， raw) getproperty-name-raw

傳回屬性的值。 值會傳回為原始屬性或XSS篩選值。 如果存放區的資料屬性不存在，則呼叫init方法。

引數

傳回

資料屬性的值。

getPropertyNames（已排除） getpropertynames-excluded

傳回工作階段存放區包含的屬性名稱。 如果存放區的資料屬性不存在，則呼叫init方法。

引數

已排除： （選用）要從結果中忽略的屬性名稱陣列。

傳回

代表工作階段屬性名稱的String值陣列。

getSessionStore() getsessionstore

傳回附加到目前物件的工作階段存放區。

引數

無。

傳回

此

init() init-1

將存放區標示為已初始化，並引發initialize事件。

引數

無。

傳回

沒有傳回值。

isInitialized() isinitialized

指出工作階段存放區是否已初始化。

引數

無。

傳回

如果儲存區已初始化，則值為true；如果儲存區未初始化，則值為false。

Loadinitproperties(obj， setValues) loadinitproperties-obj-setvalues

將指定物件的屬性新增至工作階段存放區的初始化資料。 也可以將物件資料新增至存放區資料。

引數

傳回

沒有傳回值。

removeProperty(name) removeproperty-name

從工作階段存放區移除屬性。 完成時引發update事件。 如果存放區的資料屬性不存在，則呼叫init方法。

引數

傳回

沒有傳回值。

reset() reset

還原資料存放區的初始值。 預設實施只會移除所有資料。 完成時引發update事件。

引數

無。

傳回

沒有傳回值。

setProperties(properties) setproperties-properties

設定多個屬性的值。 完成時引發update事件。 如果存放區的資料屬性不存在，則呼叫init方法。

引數

傳回

沒有傳回值。

setProperty(name， value) setproperty-name-value

設定屬性的值。 完成時引發update事件。 如果存放區的資料屬性不存在，則呼叫init方法。

引數

傳回

沒有傳回值。