[Alpha]{class="badge informative"}

edgeConfigOverrides (伺服器SDK, configure)

此頁面說明伺服器SDK configure方法中的edgeConfigOverrides。 若為Web SDK,請參閱edgeConfigOverrides.

edgeConfigOverrides物件可讓您覆寫執行個體傳送之每個要求的資料流設定。 例如,您可以將資料傳送至資料流預設值以外的其他Experience Platform資料集、Analytics報表套裝或Target屬性。 當一部伺服器處理共用資料流的多個網站或業務單位時,這會很有用。 若要覆寫單一事件的設定,請改用sendEvent🔗中的edgeConfigOverrides物件。

覆寫資料流設定需要兩個步驟:

  1. 定義您設定資料流時要允許的覆寫。 如需指示,請參閱資料流設定覆寫。
  2. 在程式碼中設定edgeConfigOverrides物件。

當您在configure中設定edgeConfigOverrides時,它會套用至執行個體以及執行個體建立的每個forRequest控制代碼的每個要求。 下列方法也接受單一呼叫的edgeConfigOverrides物件:

如果方法呼叫包含它自己的edgeConfigOverrides物件,SDK會針對該呼叫將其與configure中的物件結合。 對於每個最上層屬性(例如com_adobe_analytics),方法呼叫的值會取代來自configure的整個值。 您僅在configure中設定的頂層屬性仍適用。

例如,如果configure設定com_adobe_analytics和com_adobe_target,而sendEvent呼叫只設定com_adobe_analytics,則該事件使用來自sendEvent的com_adobe_analytics和來自configure的com_adobe_target。 巢狀內嵌在頂層屬性中的屬性不會合併,因此請包含您需要的每個巢狀屬性,例如enabled和reportSuites。

範例

下列範例會覆寫每個請求的Experience Platform資料集、Analytics報表套裝和Target屬性:

await alloy.configure({
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  edgeCredentials: {
    clientId: process.env.ADOBE_CLIENT_ID,
    clientSecret: process.env.ADOBE_CLIENT_SECRET,
    scopes: process.env.ADOBE_SCOPES.split(",")
  },
  edgeConfigOverrides: {
    com_adobe_experience_platform: {
      datasets: {
        event: {
          datasetId: "64b6f930753dd41ca8d4fd77"
        }
      }
    },
    com_adobe_analytics: {
      reportSuites: ["examplersid1", "examplersid2"]
    },
    com_adobe_target: {
      propertyToken: "01dbc634-07c1-d8f9-ca69-b489a5ac5e94"
    }
  }
});

支援的覆寫 properties

屬性
類型
說明
com_adobe_experience_platform.enabled
布林值
決定是否將資料傳送至Adobe Experience Platform。
com_adobe_experience_platform.datasets.event.datasetId
字串
接收事件資料的資料集。
com_adobe_experience_platform.com_adobe_edge_ode.enabled
布林值
決定是否將資料傳送至Offer Decisioning。
com_adobe_experience_platform.com_adobe_edge_segmentation.enabled
布林值
決定是否將資料傳送至「Edge分段」。
com_adobe_experience_platform.com_adobe_edge_destinations.enabled
布林值
決定是否將資料傳送至Edge目的地。
com_adobe_experience_platform.com_adobe_edge_ajo.enabled
布林值
決定是否將資料傳送至Adobe Journey Optimizer。
com_adobe_analytics.enabled
布林值
決定是否將資料傳送至Adobe Analytics。
com_adobe_analytics.reportSuites
字串陣列
接收Analytics資料的報表套裝。
com_adobe_audience_manager.enabled
布林值
決定是否將資料傳送至Adobe Audience Manager。
com_adobe_identity.idSyncContainerId
整數
要使用的Audience Manager協力廠商ID同步容器。 需要com_adobe_audience_manager.enabled為true。
com_adobe_target.enabled
布林值
決定是否將資料傳送至Adobe Target。
com_adobe_target.propertyToken
字串
Adobe Target屬性的Token。
com_adobe_launch_ssf.enabled
布林值
決定是否將資料傳送至事件轉送。

您只能覆寫在資料流設定中允許的設定。 請參閱資料流組態覆寫。

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