Amplitude Data設定を構成し、管理する

この記事のテーマ：

• Amplitude Dataプロジェクトに関連するすべての設定を理解し、管理できるようになります

設定ページで、次の操作を行います。

• プロジェクトに名前を付け、イベントとプロパティで使用する命名規則を指定する
• メインのすべての変更にチームレビューを必要とするかどうかを指定する
• 使用する環境に合わせてAmplitudeプロジェクトを設定する
• 統合を追加する
• APIトークンを生成する
• Amplitude Dataプロジェクトを削除する

これらの設定と機能は、一般、環境、統合、APIトークン、スキーマ設定の5つの異なるタブに分かれています。それぞれについて以下のセクションで説明します。

注：最初のAmplitude Dataプロジェクトを設定する前に、設定を構成したことを確認してください。

Amplitude Dataの役割と権限

**注：*プロジェクト設定で[Require team reviews to make changes to the main branch]*（メインブランチに変更を行う場合はチームレビューを要求する）オプションが無効になっている場合、メンバーはトラッキングプランを変更することができ、承認を受ける必要はありません。他のすべての権限は同じままです。

[General]（一般）タブ

[General]（一般）タブでは、プロジェクトに名前を付け、イベントとプロパティ命名規則を設定し、メインで変更を行うためのチームレビュー要件を設定し、プロジェクトを削除することができます。また、トラッキングプランの読み取り専用バージョンへの公開リンクを表示して、組織全体の関係者と簡単かつ安全に共有することもできます。

命名規則

Amplitude Dataでは、イベントとプロパティで一貫した命名規則を設定する必要があります。一貫した命名規則がないと、同じ名前で異なる大文字ルールを使用する複数のイベントやプロパティがある可能性があり、読み取りと管理がはるか難しくなる可能性があるためです。

次の命名規則から選択します。

• ローワーケース
• センテンスケース
• タイトルケース
• キャメルケース
• ローワーキャメルケース
• snake_case

さらに、必要に応じて、カスタム命名規則を指定することもできます。

チームレビュー

大規模なチームや組織では、メインに変更があった場合にチームレビューを要求するのは良い方法です。このオプションが選択されている場合、トラッキングプランの変更は、メイン以外のブランチで行う必要があります。承認に必要なレビュアーの数（最大7人）を指定することもできます。

トラッキングプランへの公開リンク

トラッキングプランを共有したい場合は、[General]（一般）タブで提供される公開リンクを使用して共有できます。クリップボードにコピーして、電子メールやSlackメッセージに貼り付けるだけで共有できます。関係者はそれを読むことはできますが、自分で変更を加えることはできません。

公開リンクを有効または無効にすることもできます。これにより、選択したプロジェクトの可用性が変更されます。[Create Public Link]（公開リンクを作成）または*[Delete Public Link]*（公開リンクを削除）をクリックします。

[Environments]（環境）タブ

Amplitude Dataでは、プロジェクトでイベント、プロパティ、ソース、宛先を設定します。トラッキングプランとも呼んでいます。詳しくは、こちらをお読みください。.

これは後ほど説明する環境とは異なります。

混乱しやすいので、覚えておいてください。Amplitude Analytics ではnalyticsではプロジェクトも使用しますが、使い方が異なります。プロダクトからデータを受け取るには、Amplitude Analyticsでプロジェクトを設定しておく必要があります。プロジェクトはデータが流れていく場所であり、そこで分析を行います。

実際、Amplitude Analyticsで少なくとも2つのプロジェクトを持つことがベストプラクティスです。1つは本番用、もう1つは開発用です。このようにして、まず開発プロジェクトを検証してから、承認済みの変更を本番にロールアウトできます。

Amplitude Dataでは、環境はAmplitude Analyticsの特定のプロジェクトとほぼ同じ意味になります。

Amplitude Dataの各プロジェクトには、最大2つの環境を含めることができます。理想的には、1つはデバッグに、もう1つはクリーンな本番データに使用します。

Amplitude Dataでは、[Environments]（環境）タブで2つの環境（本番と開発）とAmplitude プロジェクト間のマッピングを管理します。Amplitude Dataは、ここで入力した情報を使用して、ソースと宛先を設定し、トラッキングプランページでデータを検証し、[Integrations]（統合）タブでスキーマ同期を行います。

各環境で、適切なドロップダウンリストから目的のプロジェクト名を選択します。すべての調整ができたら、[Save]（保存）をクリックします。

[Integrations]（統合）タブ

Amplitude Dataを既存のツールと統合して、分析ワークフローを合理化できます。 プラットフォームを統合するには、名前の横にある*[Connect]（接続）または[Add]*（追加）をクリックします。

[API Tokens]（APIトークン）タブ

APIトークンを使用して、メールアドレスとパスワード以外の資格情報を使用してAmplitude Dataに対して認証します。トークンは、ユーザーが個人的にログインするときに付与されるのと同じ役割と権限をアプリケーションに許可します。

APIトークンを作成するには、[Create Token]（トークンを作成）をクリックします。Amplitude Dataは、トークンを生成し、モーダルウィンドウに表示します。

トークンを後で取得することはできないため、必ずすぐに*[Copy to clipboard]*（クリップボードにコピー）をクリックしてください。

[Schema Settings]（スキーマ設定）タブ

Amplitude Dataは時々、何をすべきかわからないデータをアプリから受け取ることがあります。これは通常、スキーマ違反の結果であり、受信したデータがスキーマで考慮されないことを意味します。これは通常、スキーマを最初に設定したときに、その特定のデータタイプまたは値を計画しなかったためです。

スキーマ設定を構成することで、Amplitudeにこれらの状況を処理する方法を教えることができます。

想定外のイベント、イベントプロパティ、イベントプロパティタイプ、ユーザープロパティ、またはユーザープロパティタイプについては、Amplitude Dataに、unexpected（予期しないもの）としてマークするか、完全にreject（拒否）するかを指示できます。Amplitude Dataは、予期しないものとしてマークされたイベントやプロパティを収集し、このスキーマを購読している全員に通知を送信します。ただし、予期しないデータを拒否することを選択した場合、Amplitude Dataは、拒否されたデータを収集または保存しません。購読者は通知を受け取ります。

[Save]（保存）をクリックして、スキーマ設定に加えた変更を実施します。