Amplitudeの実装を本番環境向けに準備する

Amplitudeの実装を本番環境にリリースする前に、後で変更するのが難しい3つの決定事項を確定させておいてください:データを送信するプロジェクトの数、ユーザーの同意の処理方法、ブラウザイベントをプロキシ経由でルーティングするかどうか。各セクションでは、1つの決定について説明し、その決定に関する完全なガイドにリンクしています。

プロジェクトを1つ使用するか、プラットフォームごとに1つ使用するかを決定します。

クロスプラットフォームのインストルメンテーションは、すべてのプラットフォーム(ウェブ、iOS、Android)から1つのプロジェクトにイベントを送信します。 これは、プラットフォーム間で頻繁なユーザーのクロスオーバーを予想する場合や、プラットフォーム間での行動を分析したい場合に理にかなっています。そのためには、ユーザーIDを収集する必要があります。 すべてのプラットフォームの合計を1つのビューで取得でき、プラットフォームにまたがるファネルやリテンションチャートも利用できます。

個別のプラットフォームのインストルメンテーションでは、各プラットフォームを独自のプロジェクトに送信します。 これは、アプリが各プラットフォーム上でスタンドアロンとして機能し、クロスオーバー分析は重要ではない場合に意味があります。

各アプローチのトレードオフについては、クロスプラットフォームのインストルメンテーションと個別プラットフォームのインストルメンテーションを参照してください。

クッキーと同意管理を設定する

プロダクトでデータを追跡する前にユーザーの同意が必要な場合は、リリース前にBrowser SDKのクッキー、ストレージ、およびオプトインまたはオプトアウトの動作を設定してください。フランスのCNIL規制を含むBrowser SDK 2の設定については、クッキーと同意管理を参照してください。

プロキシを使用して、広告ブロッカーによって失われるイベントを減らします。

ユーザーのブラウザにある広告ブロッカーは、Amplitudeイベントをドロップすることがあります。 Amplitudeは、この状況を回避するためにプロキシサーバーを使用することを推奨しています。 プロキシは、イベントをAmplitudeに転送する前に、your.domain.com/amplitudeのような独自のドメインを通じて中継します。

Amplitudeプロキシをデプロイした後、Browser SDKの接続先をそのプロキシに指定してくださいserverUrl。SDKはAmplitudeのデフォルトのエンドポイントに対してのみ自動的に圧縮を有効にするため、enableRequestBodyCompressionをtrueに設定します:

ts
amplitude.init(API_KEY, {
  serverUrl: "https://your-proxy.example.com/events",
  enableRequestBodyCompression: true,
});

プロキシサーバーは、gzip圧縮されたリクエスト本文をサポートし、Content-Encoding: gzipヘッダーを処理する必要があります。

リモート設定リクエストでは、別の設定を使用します。 これらもプロキシするには、remoteConfig.serverUrlを設定します:

ts
amplitude.init(AMPLITUDE_API_KEY, {
  remoteConfig: {
    serverUrl: "https://your-proxy.example.com/config",
  },
});

プロキシサービスを構築するには、ドメインプロキシを使用してイベントをリレーしてください。

これは役に立ちましたか?

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.

このページでは