設定檔和變數字彙表
2025年5月5日
- 主題:
- 受眾
此頁面列出在設定檔指令碼中很實用的設定檔、變數和參數。
內建的描述檔
個人資料
附註
user.activeActivities
user.activeCampaigns
user.activeCampaigns
即便他/她並未在目前的工作階段中與促銷活動/活動互動,仍傳回使用者所在所有促銷活動/活動的促銷活動 ID。
user.pcId
user.sessionId
user.categoryAffinity
user.categoryAffinities
傳回訪客已填入的相似性陣列
user.isFirstSession
user.isNewSession
user.daysSinceLastVisit
user.browser
使用者代理程式
user.browserType
傳回瀏覽器型別,例如safari、chrome等。
user.header
所有
user.header
描述檔皆是由 mbox 請求標頭資料內建user.header('x-forwarded-for')
訪客所在網路連線的公開顯示的 IP 位址。
您可以用數種方式取得此資訊,例如whatismyip.com。 IP 位址不是 NAT 位址 (內部位址),其開頭為 10.、192.168. 或 172。
注意: user.header('x-cluster-client-ip')已過時。
您可以用數種方式取得此資訊,例如whatismyip.com。 IP 位址不是 NAT 位址 (內部位址),其開頭為 10.、192.168. 或 172。
注意: user.header('x-cluster-client-ip')已過時。
user.header('host')
網站主機名稱
user.header('cookie')
訪客 cookie 資料
user.header('user-agent')
訪客瀏覽器使用者代理程式
user.header('accept-language')
訪客語言
user.header('accept-encoding')
訪客字元編碼
user.header('accept')
訪客語言和字元編碼
user.header('connection')
伺服器連線。例如: keep-live
user.header('referrer')
訪客目前頁面的網站 URL。不適用於 Internet Explorer。
user.getLocal('param_name');
擷取您使用
user.setLocal
設定的值。user.setLocal('param_name','value')
在設定檔指令碼中建立持續存在的設定檔值。 這些值就像個人資料指令碼一樣持續存在,但您只能在設定它的指令碼中存取它。
user.get('param_name')
user.parameter
持續保存透過設定檔指令碼建立的設定檔屬性。也會參照「系統」設定檔,例如地理位置、造訪次數等。
profile.get('param_name')
取得要在設定檔指令碼中使用的設定檔引數的正確方式是profile.get('param_name')方法。
profile.param('param_name');
profile.parameter('parameter_name');
對 Mbox 參數持續保存是因為其profile. 首碼。
profile.browserTime
訪客的本機瀏覽器時間。如需系統時間,請在描述檔指令碼中建立新的日期物件
profile.averageDaysBetweenVisits
profile.sessionCount
profile.mobile.isTablet
訪客裝置是平板電腦。
注意:此設定檔取代已棄用的舊版瀏覽器為iPad對象類別。 如需詳細資訊,請參閱瀏覽器。
profile.mobile.isMobilePhone
訪客裝置是行動電話。
注意:此設定檔取代已棄用的舊版瀏覽器為iPhone對象類別。 如需詳細資訊,請參閱瀏覽器。
parameter=
使用 mbox 傳遞之其他值的一般詞語,通常為名稱/值配對的形式。除非使用
profile.parameter
或 user.parameter
,否則不會持續保存。URL 變數
landing
referrer
page
landing.url
referrer.url
page.url
landing.domain
referrer.domain
page.domain
landing.protocol
referrer.protocol
page.protocol
landing.param
referrer.param
page.param
landing.query
referrer.query
page.query
地理和行動電信業者設定檔
profile.geolocation.country
profile.geolocation.state
profile.geolocation.city
profile.geolocation.zip
profile.geolocation.dma
profile.geolocation.domainName
profile.geolocation.ispName
profile.geolocation.connectionSpeed
profile.geolocation.mobileCarrier
profile.geolocation.latitude
profile.geolocation.longitude
Mbox 變數
變數
附註
mbox.name
mbox.param('param_name')
自動和每個請求一併傳遞的參數:
- mbox.param('browserHeight')
- mbox.param('browserTimeOffset')
- mbox.param('browserWidth')
- mbox.param('colorDepth')
- mbox.param('mboxXDomain')
- mbox.param('mboxTime')
- mbox.param('screenHeight')
- mbox.param('screenWidth')
與訂單 mbox 一併傳遞的參數:
- mbox.param('orderId')
- mbox.param('orderTotal')
- mbox.param('productPurchasedId')
mbox3rdPartyId
mbox 參數,用來將客戶 ID 同步至 Target 的 mboxPCID。客戶 ID 為您的公司用來追蹤訪客的 ID,例如 CRM ID、會員 ID 或類似的項目。然後可以使用此ID透過設定檔API和客戶屬性來新增資訊。
mboxPageValue
在每個 mbox 呼叫中,會指定一個值給頁面。
mboxDebug
僅用於除錯資訊。新增至頁面URL,at.js會在此頁面尋找它。
mboxOverride.browserIp
設定和實際位置不同的地理區域,讓您可以測試某個項目在其他位置看起來如何。
注意: 只有在測試活動並且不在生產中時,才應該使用 mboxOverride 參數。使用任何 mboxOverride 參數可能造成使用 Analytics for Target (A4T) 時的報表差異。在測試時,您應該使用活動 QA 模式,以在將活動推送至您的即時環境之前,確保您的活動可如預期般運作。
注意: 只有在測試活動並且不在生產中時,才應該使用 mboxOverride 參數。使用任何 mboxOverride 參數可能造成使用 Analytics for Target (A4T) 時的報表差異。在測試時,您應該使用活動 QA 模式,以在將活動推送至您的即時環境之前,確保您的活動可如預期般運作。
客戶屬性
可在描述檔指令碼中參考客戶屬性 ,格式為 crs.get('<Datasource Name>.<Attribute name>')
。
這些屬性也可做為描述檔指令碼中的代號,以及直接用在選件中,不需要先使用描述檔指令碼。Token的格式為: ${crs.datasourceName.attributeName}
。 請注意,應該從任何API呼叫中移除datasourceName
中的空格。
recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654