[Alpha]{class="badge informative"}

edgeConfigOverrides （Server SDK、configure）

このページでは、Server SDK configure メソッドのedgeConfigOverridesについて説明します。 Web SDKについては、edgeConfigOverridesを参照してください。

edgeConfigOverrides オブジェクトを使用すると、インスタンスが送信するすべてのリクエストのデータストリーム設定を上書きできます。 例えば、データストリームのデフォルトとは異なるExperience Platform データセット、Analytics レポートスイート、またはTarget プロパティにデータを送信できます。 これは、1つのサーバーがデータストリームを共有する複数のweb サイトまたは事業部を処理する場合に便利です。 1つのイベントの設定を上書きするには、代わりにsendEvent🔗のedgeConfigOverrides オブジェクトを使用してください。

データストリーム設定を上書きするには、次の2つの手順を実行します。

configureでedgeConfigOverridesを設定すると、インスタンスからのすべてのリクエストと、インスタンスが作成するすべてのforRequest ハンドルからのすべてのリクエストに適用されます。 次のメソッドも、1回の呼び出しに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

上書きできるのは、データストリーム設定で許可されている設定のみです。 ​ データストリーム設定の上書きを参照してください。