コンテンツにスキップ

グローバルコンテキスト（Global Context）¶

Global Context は、設定後に生成される RUM イベントに付加され、テナント、バージョンチャネル、実験グループなどの安定したビジネスディメンションの記録に適しています。

API の選択¶

API	説明	戻り値
`setGlobalContextProperty(key, value)`	単一フィールドの追加または上書き	なし
`setGlobalContext(context)`	Global Context 全体の置き換え	なし
`getGlobalContext()`	現在の Global Context のコピーを取得	Object
`removeGlobalContextProperty(key)`	単一フィールドの削除	なし
`clearGlobalContext()`	すべての Global Context をクリア	なし

setGlobalContext() は Context 全体を置き換えます

1 つのフィールドのみを更新する場合は、setGlobalContextProperty() を使用し、他のモジュールが既に設定したフィールドを上書きしないようにしてください。

NPM の例¶

import { datafluxRum } from "@cloudcare/browser-rum"

datafluxRum.setGlobalContextProperty("tenant_id", "tenant-42")
datafluxRum.setGlobalContext({
  tenant_id: "tenant-42",
  release_channel: "stable"
})

const context = datafluxRum.getGlobalContext()
console.log(context)

datafluxRum.removeGlobalContextProperty("release_channel")
datafluxRum.clearGlobalContext()

CDN の例¶

同期ロード非同期ロード

if (window.DATAFLUX_RUM) {
  window.DATAFLUX_RUM.setGlobalContextProperty("tenant_id", "tenant-42")
  const context = window.DATAFLUX_RUM.getGlobalContext()
  console.log(context)
}

window.DATAFLUX_RUM.onReady(function () {
  window.DATAFLUX_RUM.setGlobalContextProperty("tenant_id", "tenant-42")
  const context = window.DATAFLUX_RUM.getGlobalContext()
  console.log(context)
})

フィールド設計の推奨事項¶

安定した意味の明確なキーを使用してください（例：tenant_id、release_channel）。
タイムスタンプや乱数などの高基数値は、汎用的な分析ディメンションとして使用しないでください。
パスワード、トークン、ID 番号などの機密情報は書き込まないでください。
Context は設定後に生成されるイベントにのみ影響し、既に報告されたデータは変更しません。

検証¶

フィールドを設定した後、View、Action、または API リクエストを 1 回トリガーし、対応するエクスプローラーでイベントに tenant_id が含まれていることを確認してください。古いイベントにこのフィールドがない場合は、Context がイベント発生前に設定されているかどうかを確認してください。