`advertising` （網頁SDK） advertising

最後更新： 2026年11月6日

建立對象：

中繼
開發人員

advertising物件會設定Web SDK與Adobe Advertising的整合。網頁SDK會使用這些設定來測量點進和閱覽轉換，並將廣告ID新增至事件。

點進轉換：不需要設定。當訪客到達具有s_kwcid或ef_id查詢字串引數的頁面時，Web SDK會記錄點進轉換。
瀏覽轉換：在advertiserSettings中至少需要一個已啟用的廣告商。 Web SDK會收集可用的廣告ID，並傳送這些廣告商的瀏覽轉換次數。

在訪客同意前，Web SDK不會處理廣告轉換或設定廣告Cookie。 Advertising元件包含在標準Web SDK資料庫中。如果您建立自訂組建，請包含Advertising元件。

屬性 properties

屬性

類型

預設

說明

enabled

布林值

true

在執行階段開啟或關閉Adobe Advertising。請參閱在執行階段關閉Advertising。適用於Web SDK 2.37.0或更新版本。

dspEnabled

布林值

false

如果您使用Adobe Advertising Demand-side Platform (DSP)，請設為true。當true時，檢視轉換包含ID5和RampID通用ID （如果您設定id5PartnerId或rampIdJSPath）。

advertiserSettings

物件陣列

要測量其檢視轉換的廣告商。每個物件都包含advertiserId字串和enabled布林值，兩者都是必要的。 Web SDK僅使用enabled設為true的廣告商。

id5PartnerId

字串

您組織的ID5合作夥伴ID。此設定可讓Web SDK收集ID5通用ID。

rampIdJSPath

字串

您組織的LiveRamp RampID JavaScript程式碼的路徑(ats.js)。此設定允許Web SDK收集RampID通用ID。

範例 example

alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  advertising: {
    dspEnabled: true,
    advertiserSettings: [
      { advertiserId: "12345", enabled: true },
      { advertiserId: "67890", enabled: false }
    ],
    id5PartnerId: "1234",
    rampIdJSPath: "https://example.com/ats.js"
  }
});

在執行階段關閉Advertising enabled

將advertising.enabled設為false可關閉Adobe Advertising而不從程式庫中移除Advertising元件。當enabled為false時，Web SDK：

不傳送點進或閱覽轉換。
即使在sendEvent命令將handleAdvertisingData設為"auto"或"wait"，也不會將廣告ID新增至事件。
不會進行瀏覽者ID、ID5或RampID呼叫，因此不會載入廣告指令碼或iframe。
不會讀取或寫入廣告Cookie。現有的廣告Cookie保持不變。

當enabled為false時，Web SDK會忽略advertising物件中的其他屬性。

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

enabled屬性只接受布林值。其他值（例如字串"true"或"false"）會導致configure命令失敗。

當您想要關閉Advertising而不重建程式庫，或有條件地開啟或關閉（例如針對特定頁面）時，請使用此屬性。若要從程式庫完全移除Advertising程式碼，請改為從自訂組建中排除Advertising元件。

將廣告ID新增至事件 handle-advertising-data

依預設，Web SDK不會將廣告ID新增至您使用sendEvent傳送的事件。若要新增這些值，請在sendEvent命令中將advertising.handleAdvertisingData設定為下列其中一個值：

"disabled"：預設值。網頁SDK不會將廣告ID新增至事件。
"auto"： Web SDK新增已收集的廣告ID，例如先前轉換的ID。
"wait"： Web SDK也會嘗試收集尚未提供的廣告ID，並在傳送事件之前短暫等候。

alloy("sendEvent", {
  xdm: {
    eventType: "web.webpagedetails.pageViews"
  },
  advertising: {
    handleAdvertisingData: "auto"
  }
});

只有當訪客已提供同意、advertiserSettings中至少啟用一個廣告商，而且頁面URL不包含點進引數時，Web SDK才會將廣告ID新增至事件。

使用Web SDK標籤擴充功能設定Advertising tag-extension

您可以使用Adobe Advertising設定，在網頁SDK標籤擴充功能中設定這些設定。

recommendation-more-help

experience-platform-help-collection

advertising （網頁SDK） advertising