Show Menu
主題×

設定SDK

SDK的設定是使用命令 configure 完成。
configure 永遠 是第 一個調用的命令。
alloy("configure", {
  "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
  "orgId":"ADB3LETTERSANDNUMBERS@AdobeOrg"
});

在配置期間可以設定許多選項。 所有選項皆可在下方找到,依類別分組。

一般選項

edgeConfigId

類型
必填
預設值
字串
您指派的設定ID,會將SDK連結至適當的帳戶和設定。 在單一頁面中設定多個例項時,您必須為每個例項設 edgeConfigId 定不同的例項。

context

類型
必填
預設值
字串陣列
["web", "device", "environment", "placeContext"]
指出要自動收集哪些上下文類別,如「自動資訊」 中所述 。 如果未指定此配置,則預設情況下會使用所有類別。

debugEnabled

類型
必填
預設值
布林值
false
指出是否應啟用除錯。 將此配置設 true 置為啟用以下功能:
功能
函數
同步驗證
驗證針對架構收集的資料,並在下列標籤下的回應中傳回錯誤: collect:error OR success
控制台記錄
啟用除錯訊息,以便顯示在瀏覽器的JavaScript主控台中

edgeDomain

類型
必填
預設值
字串
beta.adobedc.net
用於與Adobe服務互動的網域。 只有當您有第一方網域(CNAME),可代理Adobe Edge基礎架構的請求時,才會使用此功能。

orgId

類型
必填
預設值
字串
Your assigned Experience Cloud organization ID. 在頁面內設定多個例項時,您必須為每個例項設 orgId 定不同的例項。

資料彙集

clickCollectionEnabled

類型
必填
預設值
布林值
true
指出是否應自動收集與連結點按次數關聯的資料。 對於符合連結點按資格的點按,會收 集下列Web Interaction 資料:
屬性
說明
連結名稱
由連結內容決定的名稱
連結URL
標準化URL
連結類型
設為下載、退出或其他

onBeforeEventSend

類型
必填
預設值
函數
()=>未定義
設定此設定,以設定在每個事件傳送前呼叫的回呼。 包含該欄位的對 xdm 像將發送到回調。 修改 xdm 對象以更改發送內容。 在回呼中,物 xdm 件已在event命令中傳遞資料,並自動收集資訊。 有關此回呼的時間安排和示例的詳細資訊,請參 閱全局修改事件

隱私權選項

個人化選項

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。 這有助於轉換至使用AEP Web SDK,而網站的某些部分可能仍在使用Visitor.js。 此外,如果頁面上已定義訪客API,SDK將查詢訪客API以取得ECID。 這可讓您使用AEP Web SDK來建立雙標籤頁面,而且仍有相同的ECID。

thirdPartyCookiesEnabled

類型
必填
預設值
布林值
true
啟用Adobe協力廠商Cookie的設定。 SDK可將訪客ID保留在協力廠商內容中,以便讓相同的訪客ID可跨網站使用。 如果您有多個網站或想要與合作夥伴共用資料,這項功能會很有用;但是,有時出於隱私權原因並不需要這麼做。