設定資料流覆寫

Last update: Tue Nov 05 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

開發人員

edgeConfigOverrides物件可讓您覆寫目前頁面上執行之命令的組態設定。此覆寫物件不是命令，而是您可以包含在大多數Web SDK命令中的物件。

如果您在不同國家/地區擁有不同的網站或子網域，或您擁有多個Experience Platform沙箱來儲存不同業務單位的特定資料時，此物件相當實用。

IMPORTANT

如需資料流覆寫的詳細端對端設定指示，請參閱資料流設定覆寫檔案。

資料流設定覆寫分為兩個步驟：

首先，您必須在Datastreams UI的資料流設定頁面中定義資料流設定覆寫。如需如何設定覆寫的說明，請參閱資料流設定覆寫檔案。
在UI中設定資料流覆寫後，您必須透過下列其中一種方式將覆寫傳送給Edge Network：
- 透過Web SDK 標籤擴充功能。
- 透過sendEvent或configure Web SDK命令。
- 透過Mobile SDK sendEvent命令。

如果您同時在Web SDK設定和特定命令（例如sendEvent）中設定覆寫，則特定命令中的覆寫優先。

NOTE

如果您想要設定覆寫以停用 Experience Cloud服務，您必須確定該服務在資料流設定中是第一個啟用。請參閱有關如何設定資料串流的檔案，以取得有關如何將服務新增至資料串流的詳細資訊。

透過Web SDK標籤擴充功能將資料流覆寫傳送至Edge Network tag-extension

如需詳細的設定指示，請參閱有關Web SDK標籤擴充功能中設定資料流覆寫的檔案。

如果您想從Web SDK標籤延伸設定資料流覆寫，請在設定標籤延伸時設定 資料流設定覆寫 下的每個所需欄位。

使用您的Adobe ID憑證登入experience.adobe.com。
導覽至 資料彙集 > 標籤。
選取所需的標籤屬性。
導覽至 擴充功能，然後按一下Adobe Experience Platform Web SDK卡片上的設定。
向下捲動至 資料流設定覆寫 區段。設定每個所需的覆寫值。
按一下儲存，然後發佈您的變更。

如果您只想為特定命令設定覆寫，請在標籤規則的動作中設定每個所需欄位。

使用您的Adobe ID憑證登入experience.adobe.com。
導覽至 資料彙集 > 標籤。
選取所需的標籤屬性。
導覽至規則，然後選取所要的規則。
在動作下，選取現有動作或建立動作。
將擴充功能下拉式清單欄位設為 Adobe Experience Platform Web SDK，並將動作型別設為 傳送事件。
向下捲動至標示為 資料流設定覆寫 的區段。
將此區段中的每個欄位設定為所需的覆寫值。
按一下 保留變更，然後執行您的發佈工作流程。

為開發、暫存和生產環境提供了單獨的欄位。請務必填寫每個環境的每個所需欄位。

透過Web SDK JavaScript資料庫將覆寫傳送至Edge Network library

在資料收集UI中設定資料流覆寫後，您現在可以透過Web SDK JavaScript資料庫將覆寫傳送給Edge Network。

如果您使用Web SDK，透過edgeConfigOverrides命令傳送覆寫至Edge Network是啟動資料流設定覆寫的第二個也是最後一個步驟。

透過 edgeConfigOverridesWeb SDK 命令傳送資料流設定覆寫到 Edge Network。這個命令會建立資料流覆寫，這些覆寫會在下一個命令上傳遞到Edge Network。如果您使用configure命令，則會針對每個要求傳遞覆寫。

edgeConfigOverrides命令會建立資料串流覆寫，這些覆寫會在下一個命令上傳遞至Edge Network。

設定覆寫和 configure 命令一起傳送時，會隨附在下列 Web SDK 命令中。

個別命令的設定選項可能會覆寫全域指定的選項。

透過Web SDK `sendEvent`命令傳送設定覆寫 send-event

以下範例顯示sendEvent呼叫支援的所有動態資料流設定選項。

如果您的資料流設定已啟用所有支援的服務，則下列範例將覆寫此設定並停用所有服務（請參閱每個服務上的enabled: false設定）。

alloy("sendEvent", {
  renderDecisions: true,
  edgeConfigOverrides: {
    datastreamId: "bfa8fe21-6157-42d3-b47a-78310920b39d",
    com_adobe_experience_platform: {
      enabled: false,
      datasets: {
        event: {
          datasetId: "64b6f949a8a6891ca8a28911",
        },
      },
      com_adobe_edge_ode: {
        enabled: false,
      },
      com_adobe_edge_segmentation: {
        enabled: false,
      },
      com_adobe_edge_destinations: {
        enabled: false,
      },
      com_adobe_edge_ajo: {
        enabled: false,
      },
    },
    com_adobe_analytics: {
      enabled: false,
      reportSuites: ["ujslconfigoverrides3"],
    },
    com_adobe_identity: {
      idSyncContainerId: 34374,
    },
    com_adobe_target: {
      enabled: false,
      propertyToken: "f3fd55e1-a06d-8650-9aa5-c8356c6e2223",
    },
    com_adobe_audience_manager: {
      enabled: false,
    },
    com_adobe_launch_ssf: {
      enabled: false,
    },
  },
});

參數

說明

renderDecisions

edgeConfigOverrides.datastreamId

使用此參數讓單一要求可前往和 configure 命令所定義的資料流不同的資料流。

edgeConfigOverrides.com_adobe_experience_platform

定義Experience Platform服務的動態資料流設定。

edgeConfigOverrides.com_adobe_experience_platform.enabled

定義是否將事件傳送至Experience Platform服務。

edgeConfigOverrides.com_adobe_experience_platform.datasets

定義用於事件的資料集。

edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_ode.enabled

定義是否將事件傳送至Offer decisioning服務。

edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_segmentation.enabled

定義是否將事件傳送至邊緣劃分服務。

edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_destinations.enabled

定義是否將事件資料傳送至邊緣目的地。

edgeConfigOverrides.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_identity.idSyncContainerId

您要用於Audience Manager的第三方ID同步容器。若要讓此ID同步容器運作，您必須將com_adobe_audience_manager.enabled設定為true。否則，會停用Audience Manager服務。

com_adobe_target.enabled

定義是否將事件資料傳送至Adobe Target。

com_adobe_target.propertyToken

Adobe Target目的地屬性的Token。

com_adobe_audience_manager.enabled

定義是否將事件資料傳送至Audience Manager服務。

com_adobe_launch_ssf

定義是否將事件資料傳送至伺服器端轉送。

透過Web SDK `configure`命令傳送設定覆寫 send-configure

下面的範例會顯示在 configure 命令時設定覆寫可能的情況。