context

context屬性是字串陣列,可決定Web SDK可自動收集的內容。 雖然此資料可提供絕佳價值,但若省略其中部分資料,則可讓您遵守組織的隱私權政策。

內容關鍵字和XDM元素

如果您包含指定的上下文關鍵字,Web SDK會自動填入其所有關聯的XDM元素。 如果您想在允許其他專案時省略特定的XDM專案,可以使用onBeforeEventSend清除個別值。 如果您在頁面上傳送多個事件,Web SDK會在每SendEvent呼叫中包含這些欄位。

網頁

"web"​關鍵字會收集有關目前頁面的資訊。

維度
說明
XDM 路徑
範例值
頁面 URL
目前頁面的URL。
xdm.web.webPageDetails.URL
https://example.com/index.html
反向連結URL
造訪的上一個頁面的URL。
xdm.web.webReferrer.URL
http://example.org/linkedpage.html

裝置

"device"​關鍵字會收集使用者裝置的相關資訊。

維度
說明
XDM 路徑
範例值
熒幕高度
熒幕的高度(畫素)。
xdm.device.screenHeight
900
熒幕寬度
熒幕的寬度(畫素)。
xdm.device.screenWidth
1440
熒幕方向
熒幕方向。
xdm.device.screenOrientation
landscapeportrait

環境

"environment"​關鍵字會收集有關使用者瀏覽器的資訊。

維度
說明
XDM 路徑
範例值
環境類型
體驗出現的環境型別。 網頁SDK一律將此欄位設為browser
xdm.environment.type
browser
檢視區高度
瀏覽器內容區域的高度(畫素)。
xdm.environment.browserDetails.viewportHeight
679
檢視區寬度
瀏覽器內容區域的寬度(畫素)。
xdm.environment.browserDetails.viewportWidth
642

地標內容

"placeContext"​關鍵字會收集有關使用者位置的資訊。

維度
說明
XDM 路徑
範例值
當地時間
一般使用者的本機時間戳記,採用簡化的ISO 8601格式,沒有時區位移。
xdm.placeContext.localTime
YYYY-07-04T12:08:56
當地時區位移
使用者的當地時間與UTC偏移的分鐘數。
xdm.placeContext.localTimezoneOffset
360
國家/地區代碼
一般使用者的國家/地區代碼。
xdm.placeContext.geo.countryCode
US
州/省
一般使用者的省/市/自治區代碼。
xdm.placeContext.geo.stateProvince
CA
緯度
一般使用者位置的緯度。
xdm.placeContext.geo._schema.latitude
37.3307447
經度
一般使用者位置的經度。
xdm.placeContext.geo._schema.longitude
-121.8945965
iana時區
一般使用者的IANA時區。 包含在程式庫2.32.0版或更新版本中。
xdm.placeContext.ianaTimezone
America/Denver

時間戳記

"timestamp"​關鍵字會收集有關事件時間戳記的資訊。 此內容一律包含在內,無法移除。

維度
說明
XDM 路徑
範例值
事件的時間戳記
使用者的UTC時間戳記,使用簡化的延伸ISO 8601格式。
xdm.timestamp
YYYY-08-07T22:47:17.129Z

實作詳細資料

implementationDetails​關鍵字會收集用來收集事件之SDK版本的相關資訊。

維度
說明
XDM 路徑
範例值
名稱
軟體開發套件(SDK)識別碼。 此欄位會使用URI來改善不同軟體程式庫所提供的識別碼之間的唯一性。
xdm.implementationDetails.name
使用獨立程式庫時,值為https://ns.adobe.com/experience/alloy。 當資料庫作為標籤延伸的一部分使用時,值為https://ns.adobe.com/experience/alloy+reactor
版本
軟體開發套件(SDK)版本。
xdm.implementationDetails.version
使用獨立程式庫時,值為程式庫版本。 當將程式庫用作標籤擴充功能的一部分時,值為程式庫版本和使用+聯結的標籤擴充功能版本。 例如,如果程式庫版本是2.1.0,而標籤延伸版本是2.1.3,則值將是2.1.0+2.1.3
環境
收集資料的環境。 使用JavaScript資料庫時,此欄位一律設為browser
xdm.implementationDetails.environment
browser

高平均資訊量使用者端提示 high-entropy-client-hints

"highEntropyUserAgentHints"​關鍵字會收集使用者裝置的詳細資訊。 此資料包含在傳送至Adobe之請求的HTTP標頭中。 資料到達Edge網路後,XDM物件會填入其個別的XDM路徑。 如果您在sendEvent呼叫中設定個別XDM路徑,則其優先於HTTP標頭值。

如果您在設定您的資料流時使用裝置查詢,則資料可以清除掉,以支援裝置查詢值。 某些使用者端提示欄位和裝置查詢欄位不得存在於相同點選中。

屬性
說明
HTTP 標題
XDM 路徑
範例
作業系統版本
作業系統的版本。
Sec-CH-UA-Platform-Version
xdm.environment.browserDetails.
userAgentClientHints.platformVersion
10.15.7
架構
底層CPU架構。
Sec-CH-UA-Arch
xdm.environment.browserDetails.
userAgentClientHints.architecture
x86
裝置型號
使用的裝置名稱。
Sec-CH-UA-Model
xdm.environment.browserDetails.
userAgentClientHints.model
Intel Mac OS X 10_15_7
位元
基礎CPU架構支援的位元數。
Sec-CH-UA-Bitness
xdm.environment.browserDetails.
userAgentClientHints.bitness
64
瀏覽器供應商
建立瀏覽器的公司。 低平均資訊量提示Sec-CH-UA也會收集這個專案。
Sec-CH-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.vendor
Google
瀏覽器名稱
使用的瀏覽器。 低平均資訊量提示Sec-CH-UA也會收集這個專案。
Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.brand
Chrome
瀏覽器版本
瀏覽器的重要版本。 低平均資訊量提示Sec-CH-UA也會收集這個專案。 系統不會自動收集精確的瀏覽器版本。
Sec-UA-Full-Version-List
xdm.environment.browserDetails.
userAgentClientHints.version
105

如需詳細資訊,請參閱使用者代理程式使用者端提示

單次Analytics反向連結 one-time-analytics-referrer

"oneTimeAnalyticsReferrer"​關鍵字只會在頁面的第一個非決策sendEvent呼叫上將反向連結值傳送到Adobe Analytics。 此內容關鍵字的主要使用案例是防止Adobe Analytics中的Referrer維度被主要用於Analytics和Target整合的點選膨脹。

如果指定的sendEvent命令使用決定事件型別(decisioning.propositionFetchdecisioning.propositionDisplaydecisioning.propositionInteract),則計算頁面上的前sendEvent個時會忽略它。 如果頁面上的反向連結值變更,並且觸發另一個sendEvent,則新的反向連結值會包含在承載中。 此條件可讓此功能搭配單頁應用程式使用。

偵測到重複的反向連結值時,資料庫會將data.__adobe.analytics.referrer設定為空字串("")。
將此資料物件欄位設定為空字串,實際上可在點選到達Adobe Analytics時清除值,因為資料物件會覆寫任何XDM物件同等欄位。這不會影響XDM物件,如果您在資料流中包含多項服務,可讓該資料繼續傳送至Experience Platform資料集。

實作

執行configure命令時設定context字串陣列。 如果您在設定SDK時省略此屬性,則預設會收集除"highEntropyUserAgentHints""oneTimeAnalyticsReferrer"以外的所有內容資訊。 如果您想要收集高平均資訊量使用者端提示,或您想要從資料收集中忽略其他內容資訊,請設定此屬性。 字串可以包含在任何順序中。

TIP
如果您想要收集所有內容資訊,包括高平均資訊量使用者端提示,您必須在context陣列字串中包含每個值。 預設context值會省略"highEntropyUserAgentHints""oneTimeAnalyticsReferrer";如果您設定context屬性,則任何省略的值都不會收集資料。
alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  context: ["web", "device", "environment", "placeContext", "highEntropyUserAgentHints", "oneTimeAnalyticsReferrer"]
});

使用網頁SDK標籤擴充功能收集內容資訊

請參閱Web SDK標籤擴充功能檔案中資料收集組態設定下的內容設定

recommendation-more-help
experience-platform-help-collection