データストリームの上書きの設定

The edgeConfigOverrides オブジェクトを使用すると、現在のページで実行されるコマンドの設定を上書きできます。 このオーバーライドオブジェクトは、コマンドではなく、ほとんどの Web SDK コマンドに含めることができるオブジェクトです。

このオブジェクトは、国ごとに異なる Web サイトやサブドメインがある場合、または異なるビジネスユニットに固有のデータを保存する複数のExperience Platformサンドボックスがある場合に役立ちます。

データストリーム設定の上書きは、次の 2 つの手順で構成されます。

Web SDK 設定と特定のコマンド ( sendEvent) の場合は、特定のコマンドの上書きが優先されます。

オブジェクトのプロパティ

このオブジェクト内では、次のプロパティを使用できます。

Web SDK タグ拡張機能を使用した Edge Network へのデータストリームの上書きの送信 tag-extension

次のドキュメントを参照してください： datastream の上書きの設定 Web SDK タグ拡張機能から。

Web SDK タグ拡張機能からデータストリームのオーバーライドを設定する場合は、以下の各フィールドを設定します。 データストリーム設定の上書き when タグ拡張の設定.

特定のコマンドのみに上書きを設定する場合は、タグルールのアクション内で各フィールドを設定します。

に別のフィールドが提供されます。 開発, ステージング、および 実稼動 環境。 各環境の各目的のフィールドに必ず入力してください。

Web SDK JavaScript ライブラリを使用した Edge ネットワークへの上書きの送信 library

後 データストリームの上書きの設定 データ収集 UI で、Web SDK JavaScript ライブラリを使用して、上書きを Edge ネットワークに送信できるようになりました。

Web SDK を使用している場合は、 edgeConfigOverrides コマンドは、データストリーム設定の上書きをアクティブ化する 2 番目および最後の手順です。

データストリーム設定の上書きは、edgeConfigOverrides Web SDK コマンドを介して Edge Network に送信されます。このコマンドは、 Edge Network 次のコマンドで、 を使用している場合、 configure コマンドを使用する場合、リクエストごとにオーバーライドが渡されます。

The edgeConfigOverrides コマンドは、に渡されるデータストリームの上書きを作成します。 Edge Network 次のコマンドで、

設定の上書きが configure コマンドで送信される場合、次の Web SDK コマンドに含まれます。

グローバルに指定したオプションは、個々のコマンドの設定オプションで上書きできます。

Web SDK を使用した設定の上書きの送信 sendEvent command send-event

以下の例は、sendEvent コマンド上でどのように設定の上書きが表示されるかを示します。

alloy("sendEvent", {
  xdm: {
    /* ... */
  },
  edgeConfigOverrides: {
    datastreamId: "{DATASTREAM_ID}"
    com_adobe_experience_platform: {
      datasets: {
        event: {
          datasetId: "SampleEventDatasetIdOverride"
        }
      }
    },
    com_adobe_analytics: {
      reportSuites: [
        "MyFirstOverrideReportSuite",
        "MySecondOverrideReportSuite",
        "MyThirdOverrideReportSuite"
        ]
    },
    com_adobe_identity: {
      idSyncContainerId: "1234567"
    },
    com_adobe_target: {
      propertyToken: "63a46bbc-26cb-7cc3-def0-9ae1b51b6c62"
    }
  }
});

Web SDK を使用した設定の上書きの送信 configure command send-configure

以下の例は、configure コマンド上でどのように設定の上書きが表示されるかを示します。

alloy("configure", {
  defaultConsent: "in",
  edgeDomain: "etc",
  edgeBasePath: "ee",
  datastreamId: "{DATASTREAM_ID}",
  orgId: "org",
  debugEnabled: true,
  edgeConfigOverrides: {
    "com_adobe_experience_platform": {
      "datasets": {
        "event": {
          datasetId: "SampleProfileDatasetIdOverride"
        }
      }
    },
    "com_adobe_analytics": {
      "reportSuites": [
        "MyFirstOverrideReportSuite",
        "MySecondOverrideReportSuite",
        "MyThirdOverrideReportSuite"
      ]
    },
    "com_adobe_identity": {
      "idSyncContainerId": "1234567"
    },
    "com_adobe_target": {
      "propertyToken": "63a46bbc-26cb-7cc3-def0-9ae1b51b6c62"
    }
  },
  onBeforeEventSend: function() { /* … */ });
};