配置平台Web SDK

SDK的配置是使用 configure 的子菜單。

重要

configure總是 第一個命令叫做。

alloy("configure", {
  "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg"
});

在配置過程中可以設定許多選項。 所有選項都可在下面找到,按類別分組。

常規選項

edgeConfigId

注意

邊緣配置已重新標籤為資料流。 資料流ID與配置ID相同。

類型 必填 預設值
字串 None

您分配的配置ID,它將SDK連結到相應的帳戶和配置。 在單頁內配置多個實例時,必須配置其他實例 edgeConfigId 例。

context

類型 必填 預設值
字串陣列 ["web", "device", "environment", "placeContext"]

指示要自動收集的上下文類別(如所述) 自動資訊。 如果未指定此配置,則預設使用所有類別。

debugEnabled

類型 必填 預設值
布爾型 false

指示是否啟用調試。 將此配置設定為 true 啟用以下功能:

功能 函數
控制台日誌記錄 允許調試消息顯示在瀏覽器的JavaScript控制台中

edgeDomain

使用第一方域填充此欄位。 有關詳細資訊,請參閱 文檔

域類似於 data.{customerdomain.com} 網址為:{customerdomain.com}。

edgeBasePath

用於與Adobe服務通信和交互的edgeDomain之後的路徑。 通常,只有在不使用預設生產環境時才會更改。

類型 必填 預設值
字串 e

orgId

類型 必填 預設值
字串

您分配的 Experience Cloud 組織ID。 在頁內配置多個實例時,必須配置其他實例 orgId 例。

資料收集

clickCollectionEnabled

類型 必填 預設值
布爾型 true

指示是否自動收集與連結按一下相關聯的資料。 請參閱 自動連結跟蹤 的子菜單。 如果連結包含下載屬性或連結以檔案副檔名結尾,則也會將其標籤為下載連結。 下載連結限定詞可以使用規則運算式進行配置。 預設值為 "\\.(exe|zip|wav|mp3|mov|mpg|avi|wmv|pdf|doc|docx|xls|xlsx|ppt|pptx)$"

onBeforeEventSend

類型 必填 預設值
函數 (=>未定義)

配置在發送每個事件之前調用的回調。 帶欄位的對象 xdm 已發送到回調。 要更改發送的內容,請修改 xdm 的雙曲餘切值。 在回電中, xdm 對象已在event命令中傳遞了資料,並自動收集了資訊。 有關此回調時間的詳細資訊和示例,請參見 全局修改事件

隱私選項

類型 必填 預設值
物件 "in"

設定用戶的預設同意。 如果尚未為用戶保存同意首選項,則使用此設定。 其他有效值為 "pending""out"。 此預設值不會永續到用戶的配置檔案。 僅當在以下情況下才更新用戶的配置檔案 setConsent

  • "in":設定此設定或未提供值時,工作將在未經用戶同意首選項的情況下進行。
  • "pending":設定此設定後,工作將排入隊列,直到用戶提供同意首選項。
  • "out":設定此設定後,工作將被丟棄,直到用戶提供同意首選項。
    在提供用戶的首選項後,根據用戶的首選項繼續或中止工作。 請參閱 支援同意 的子菜單。

個性化選項

prehidingStyle

類型 必填 預設值
字串

用於建立CSS樣式定義,該定義在從伺服器載入個性化內容時隱藏網頁的內容區域。 如果未提供此選項,則SDK在載入個性化內容時不會嘗試隱藏任何內容區域,這可能會導致「閃爍」。

例如,如果網頁上的元素的ID為 container在從伺服器載入個性化內容時要隱藏其預設內容,請使用以下預隱藏樣式:

  prehidingStyle: "#container { opacity: 0 !important }"

受眾選項

cookieDestinationsEnabled

類型 必填 預設值
布爾型 true

啟用 Audience Manager cookie目標,允許根據段限定設定cookie。

urlDestinationsEnabled

類型 必填 預設值
布爾型 true

啟用 Audience Manager URL目標,它允許基於段限定觸發URL。

標識選項

idMigrationEnabled

類型 必填 預設值
布爾型 true

如果為true,則SDK讀取並設定舊的AMCV Cookie。 此選項有助於過渡到使用Adobe Experience PlatformWeb SDK,而站點的某些部分可能仍使用Visitor.js。 如果訪問者API在頁面上定義,則SDK將查詢訪問者API以獲取ECID。 此選項使您能夠使用Adobe Experience PlatformWeb SDK進行雙標籤頁面,並且仍然具有相同的ECID。

thirdPartyCookiesEnabled

類型 必填 預設值
布爾型 true

啟用Adobe第三方Cookie的設定。 SDK可以將訪問者ID保留在第三方上下文中,以使同一訪問者ID能夠跨站點使用。 如果您有多個站點,或希望與合作夥伴共用資料,請使用此選項;但是,有時出於隱私原因,不需要此選項。

本頁內容