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.
Amplitude データ設定を管理する
Amplitude データ設定ページでは、名前付けやスキーマのルールからインテグレーション、APIトークン、アクセス許可まで、Amplitude データプロジェクトを設定および管理できます。これらの設定は次の目的で使用できます。
- プロジェクトに名前を付け、イベントやプロパティに使用する命名規則を指定します。
- メインへのすべての変更についてチームレビューを要求するかどうかを指定します。
- Amplitudeプロジェクトをお客様の環境に合わせて設定してください。
- 統合を追加します。
- APIトークンを生成します。
- Amplitude Dataプロジェクトを削除します。
これらの設定と機能は、「全般」、「環境」、「インテグレーション」、「APIトークン」、および「スキーマ設定」という5つのタブに表示されます。この記事では、各タブについて説明します。
最初のAmplitude データプロジェクトを設定する前に、設定を構成してください。
Amplitude データの役割と権限
Role-based Access Controls (RBAC)
エンタープライズ組織でRole-based Access Controls (RBAC) が有効になっている場合は、利用可能なデータロールと権限を確認してください。
| 役割 | 権限 |
|---|---|
| 管理者 | ワークスペース設定の構成、トラッキングプランの変更の承認、およびトラッキングプランの修正を行います。 |
| マネージャー | トラッキングプランの変更を承認し、トラッキングプランを修正してください。 |
| メンバー | 承認のためにトラッキングプランを変更します。 |
| ビューア | トラッキングプランを表示し、コメントを付けることができます。 |
また、データ管理アクセスを制限しながら、Amplitudeの他のエリアに対するアクセス権を同じにすることもできます。 詳細については、「権限」タブを参照してください。
プロジェクト設定で [メインブランチを変更するにはチームレビューが必要] オプションを無効にすると、メンバーはトラッキングプランを変更できますが、承認は必要ありません。その他のすべてのアクセス権は同じままです。
全般
「一般」タブでは、プロジェクト名、イベントとプロパティの命名規則、メインでの変更に対するチームレビュー要件を設定したり、プロジェクトを削除したりできます。 また、ここではトラッキングプランの読み取り専用バージョンへの公開リンクがある場所でもあるため、組織内の関係者と共有できます。
命名規則
Amplitude データでは、イベントとプロパティに一貫した命名規則が必要です。これがないと、複数のイベントやプロパティが同じ名前を共有し、大文字と小文字が異なる場合があるため、トラッキングプランの読み取りや管理が困難になります。
カスタム命名規則を指定するか、次のいずれかを選択します。
- 小文字です。
- センテンスケース。
- タイトルケース。
- キャメルケース
- lowerCamelCase です。
- スネークケース。
チームレビュー
大規模なチームや組織の場合、メインに加えられた変更についてチームレビューを義務付けます。このオプションを使用すると、メイン以外のブランチでトラッキングプランを変更できます。承認に必要なレビューアの人数を指定します。最大7人です。
トラッキングプランへの公開リンク
追跡計画を共有するには、[全般] タブの公開リンクを使用してください。 それをクリップボードにコピーして、メールまたはSlackメッセージに貼り付けます。関係者はそれを読むことはできますが、変更を加えることはできません。
また、公開リンクを有効または無効にすることもできます。これにより、選択したプロジェクトの可用性が変わります。 [公開リンクを作成] または [公開リンクを削除] をクリックします。
統合
Amplitudeデータと既存のツールを統合することで、アナリティクスワークフローを合理化できます。プラットフォームを統合するには、その名前の横にある [接続] または [追加] をクリックします。
APIトークン
APIトークンを使用して、メールアドレスとパスワード以外の資格情報を使用してAmplitudeデータへの認証を行います。トークンは、ユーザーが個人的にログインしたときに持っているのと同じ役割と権限を使用することをアプリケーションに許可します。
API トークンを作成するには、トークンを作成 をクリックします。Amplitudeデータがトークンを生成し、それをモーダルウィンドウに表示します。
トークンは後で取得できないため、すぐに「クリップボードにコピー」をクリックしてください。
スキーマ設定
Amplitudeデータは、アプリケーションからデータを受信したが、そのデータをどのように扱えばよいかわからない場合があります。これは通常、スキーマ違反の結果です。つまり、スキーマは受信したデータを考慮していません。 これは通常、スキーマを最初に設定する際に特定のデータ型や値を計画していない場合に発生します。
スキーマ設定を構成して、Amplitudeにこれらの状況への対処方法を指示してください。
計画外のイベント、イベントプロパティ、イベントプロパティタイプ、ユーザープロパティ、またはユーザープロパティタイプが発生した場合、Amplitude データにそれらを予期しないものとしてマークするか、完全に拒否するよう指示してください。Amplitude データは予期しないイベントやプロパティをすべて取り込み、このスキーマに登録されているすべての人に通知を送信します。予期しないデータを拒否した場合、Amplitude Dataは拒否されたデータを取り込んだり保存したりしませんが、加入者は引き続き通知を受け取ります。
保存 をクリックして、スキーマ設定に対する変更を適用します。
[権限]タブ
データアクセス権の制限により、データ管理機能を実行できるユーザーは制限されます。 たとえば、ほとんどのユーザーにメンバーの役割を与え、ダッシュボードやグラフを作成できるようにしたいと考えていますが、カスタムイベントの作成やその他のデータ管理機能はマネージャーや管理者に限定できます。
[権限] タブで、選択したロールに制限を追加して、データ管理アクセスを制限します。ただし、これらのロールに対する他の権限は変更されません。
Amplitude データのアクセス制限の下で、以下のオプションから選択して、プロジェクトごとにアクセス権を閲覧者レベルに制限します。
- デフォルトの制限を使用します。
- メンバーを制限します。
- メンバーとマネージャーを制限します。
次に、「保存」をクリックします。
権限制限はエンタープライズユーザーのみが利用できます。「権限」タブにアクセスできるのは管理者だけです。
他のプロジェクトにコピーする
現在の権限制限設定を別のプロジェクトに適用するには、「他のプロジェクトにコピー」をクリックします。
自動キャプチャ
Amplitude Dataの自動キャプチャ設定を使用すると、Analytics Browser SDKの設定をAmplitude内から直接変更できます。そのため、コードの変更やリリースなしで変更を加えることができます。 これらの設定は、ウェブサイト上のSDK初期化コードでローカルに定義したすべての設定とマージされます。
可用性
自動キャプチャ設定は、Amplitude Browser SDK バージョン 2.10.0 以降を使用し、かつfetchRemoteConfigが有効になっているプロジェクトで利用できます。
リモート設定を無効にするには、fetchRemoteConfig を false に設定します。無効にfetchRemoteConfigしても、データ設定のリモート設定オプションは無効になりません。
リモート設定(デフォルト)
SDK バージョン 2.16.1 以降では、fetchRemoteConfig がデフォルトで有効になります。
仕組み
fetchRemoteConfig が有効な状態で SDK が初期化されると、SDK はプロジェクトの API キーを使用して Amplitude のサーバーから設定を取得します。これらのリモート設定は、サイトで定義した任意のローカル設定と統合されます。 マージ後、SDK は、この組み合わせた設定を使用するすべてのプラグインとともに初期化を完了します。 リモート設定はサイト上のページの読み込み時間に影響しませんが、SDK の初期化時間に影響を与える可能性があります。
設定タイムアウト
Amplitude のサーバーから設定をロードするのに 5 秒以上かかる場合、SDK は初期化時に設定されたローカル設定にフォールバックします。
[設定] ページでは、各設定カテゴリに 3 つのオプションがあります。
- デフォルト:SDK 内のローカル設定をそのまま保持します。UI の設定はこれを上書きしません。
- オン:ローカル設定を上書きし、カテゴリを true に設定します。カテゴリ内のすべての設定(エレメントの相互作用など)は、UI の設定に従います。
- [Off]:ローカル設定を上書きし、カテゴリをfalseに設定します。
セッション追跡の無効化
セッションリプレイを使用する場合は、セッションリプレイ SDK のバージョンが 1.12.1 以降であることを確認してください。
UI経由で行った変更は、10分後に有効になります。
要素のインタラクション
エレメントの相互作用を有効にすると、いくつかのオプションが表示されます。
| オプション | 目的 |
|---|---|
| CSS セレクターの許可リスト | ユーザーが操作する要素(リンクやフォーム要素など)のセレクター。ユーザーが操作するカスタム要素や標準以外の要素がある場合は、ここでそれらを指定してください。 |
| アクションクリック許可リスト | Amplitudeは、ユーザーが要素をクリックし、かつそのクリックによってページまたはDOMの変更が発生した場合にのみ、このリスト内の要素を追跡します。 |
| ページURL許可リスト | Amplitudeが要素のクリックや変更イベントを追跡するURLまたはURLパターン(globまたは正規表現を使用)を指定します。 |
| データ属性プレフィックス | データ属性の接頭辞を指定します(例:data-amp-track)。Amplitudeはこれらの属性の値をイベントプロパティとして保存します。 |
また、ゾーニングインサイトはエレメントの相互作用データを使用して、ページの定義済み領域内のエンゲージメントを分析します。 ゾーニングインサイトを使用するには、ここまたはブラウザSDKの初期化時に要素のインタラクションを有効にしてください(オプションで許可リストを設定することもできます)。
イベント量を減らす
これらのオプションは、イベント量を制御するのに役立ちます。アクションクリック許可リストは、デッドクリックを無視することで、関連するインタラクションを追跡しながらボリュームを削減するための最も効率的な方法です。
これは役に立ちましたか?