プロキシセッションリプレイリクエスト
SDKネットワークトラフィックがAmplitudeに到達する前に独自のドメインを通過する必要がある場合は、セッションリプレイのリクエストをプロキシします。ブラウザでは、ブラウザスクリプトをホストすることとは独立して、リクエストをプロキシできます。 iOSとAndroid SDKは、リプレイアップロード用のカスタムURLをサポートしています。
プロキシAPI呼び出し
SDKのネットワークリクエストを自社サーバー経由でルーティングすることで、amplitude.comリクエストがエンドポイントに直接送信されることはありません。プロキシサーバーはリクエストを受信し、それをAmplitudeのデフォルトエンドポイントに転送し、Amplitudeの応答を変更せずに返します。
プロキシの仕組み
最小限のプロキシ実装は以下のことを行う必要があります。
- カスタムURLでSDKからのリクエストを受け入れます。
- リクエスト本文全体とすべてのヘッダー(
Hostを除く)を対応するAmplitudeエンドポイントに転送します。 - ステータスコード、ヘッダー、本文など、SDKに対するAmplitudeの応答を変更せずに返します。
プロキシは透過型にする必要があります。リクエストまたはレスポンスのペイロードを削除、変更、またはバッファリングしないでください。 SDKは再試行を処理するため、プロキシがその処理を行う必要はありません。
APIキーはサーバー側に保持
ダウンストリームサービス用にAuthorizationヘッダーを挿入する必要がある場合は、APIキーをクライアント側のコードにハードコードするのではなく、プロキシにヘッダーを挿入してください。サーバー側にヘッダーを挿入すると、認証情報がブラウザからアクセスできないようになります。
オプションの分析SDKプロキシ
分析SDKは、個別の取り込みエンドポイントとリモート設定エンドポイントを使用します。実装で分析イベントもキャプチャされる場合は、「プロキシ 分析 SDK リクエスト」を参照してください。
セッションリプレイ:ブラウザ(プラグインおよびスタンドアロンSDK)
セッションリプレイは、キャプチャされたデータを送信し、別のエンドポイントを通じてリモート設定を取得します。 各リクエストを、お客様の地域の対応するAPIエンドポイントに転送します。
| 設定オプション | 目的 |
|---|---|
trackServerUrl | Point replayのアップロードをプロキシに指定します。 |
configServerUrl | リモート設定リクエストをプロキシに指定します。 |
セッションリプレイプラグイン:
sessionReplayPlugin({
trackServerUrl: 'https://replay.yourdomain.com/sessions/v2/track',
configServerUrl: 'https://replay.yourdomain.com/config'
});
セッションリプレイスタンドアロン SDK:
sessionReplay.init('API_KEY', {
trackServerUrl: 'https://replay.yourdomain.com/sessions/v2/track',
configServerUrl: 'https://replay.yourdomain.com/config'
});
セッションリプレイ:モバイル(iOSおよびAndroid)
iOS SDKとAndroid SDKは、カスタムサーバーURLを設定するときに、リプレイのアップロードをプロキシに送信します。 SDKをプロキシ上の完全なアップロードURLにポイントし、プロキシに各リクエストを、クエリ文字列、ヘッダー、ボディを変更しないまま、https://api-sr.amplitude.com/sessions/v2/track(US)またはhttps://api-sr.eu.amplitude.com/sessions/v2/track(EU)に転送させます。カスタムサーバーURLは、デフォルト設定をserverZone上書きします。
| SDK | 設定オプション | 最小バージョン |
|---|---|---|
| iOSプラグイン、スタンドアロンSDK、ミドルウェア、Segmentプラグイン | UploadConfig(serverUrl:) | 0.14.0 |
| Androidプラグイン、スタンドアロンSDK、およびSegmentプラグイン | serverUrl | サポートされているすべてのバージョン |
| Androidミドルウェア | SessionReplayMiddleware.Builder.serverUrl() | 0.33.0 |
モバイルSDKは、Amplitudeから直接リモート設定を取得します。 これらは、カスタムリモート設定URLをまだサポートしていません。
iOSプラグイン:
let config = AmplitudeSwiftSessionReplayPlugin.Config(
sampleRate: 1.0,
uploadConfig: UploadConfig(serverUrl: "https://replay.yourdomain.com/sessions/v2/track")
)
amplitude.add(plugin: AmplitudeSwiftSessionReplayPlugin(config: config))
Androidプラグイン:
val sessionReplayPlugin = SessionReplayPlugin(
context = applicationContext,
sampleRate = 1.0,
serverUrl = "https://replay.yourdomain.com/sessions/v2/track"
)
amplitude.add(sessionReplayPlugin)
Androidミドルウェア:
val sessionReplayMiddleware = SessionReplayMiddleware.Builder(amplitude)
.sampleRate(1.0)
.serverUrl("https://replay.yourdomain.com/sessions/v2/track")
.build()
amplitude.addEventMiddleware(sessionReplayMiddleware)
React NativeおよびFlutterセッションリプレイSDKは、カスタムプロキシURLをサポートしていません。このserverZoneオプションでは、Amplitudeの米国またはEUデータセンターを選択し、リクエストはAmplitudeに直接送信されます。
コンテンツセキュリティポリシー(CSP)
アプリでコンテンツセキュリティポリシーを設定している場合は、セルフホスト型ファイルやプロキシ型エンドポイントに切り替える際にポリシーを更新してください。
| ディレクティブ | デフォルト(Amplitude CDN) | セルフホスティングを使用 |
|---|---|---|
script-src | https://cdn.amplitude.com | 独自のファイルサービスドメイン |
connect-src | https://api-sr.amplitude.com (米国) または https://api-sr.eu.amplitude.com(EU) | お客様のプロキシドメイン (複数可) |
worker-src | blob: | セッションリプレイのWebワーカーで必要となるため、blob:を保持してください |
CSPの例(完全セルフホスト型):
Content-Security-Policy: script-src 'self' https://assets.yourdomain.com; connect-src 'self' https://analytics.yourdomain.com https://replay.yourdomain.com; worker-src 'self' blob:;
お客様のプロキシはAmplitudeの米国またはEUエンドポイントへのルーティングを処理するため、CSPはお客様のドメインを参照するだけで済みます。 同じ政策が両方の地域で機能しています。
これは役に立ちましたか?
For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.