このページでは

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.

プロパティグループの使用

プロパティグループによって、イベントプロパティのセットが1つの再利用可能な単位にバンドルされるため、各プロパティを個別に追加するのではなく、1つのステップでそれらすべてをイベントに追加できます。グループを更新すると、Amplitudeデータはそのグループを使用するすべてのイベントに変更を適用します。これにより、各イベントを手動で編集する必要がなくなり、複雑なトラッキングプランで一貫性を保つことができます。

プロパティグループは、イベントごとに設定を繰り返すことなく、同じプロパティセットを多くのイベントに追加したい場合に使用します。イベントではなくアカウントなどのビジネスエンティティに関するプロパティを追跡するには、代わりにデータ > グループにある独自の機能であるグループプロパティを使用してください。

たとえば、音楽アプリのトラッキングマネージャーは、曲に関連するイベントの作成を効率化する方法を必要としている場合があります。 これらのイベントにはそれぞれ次のプロパティがあります。

  • albumName
  • artistName
  • genre
  • recordLabel
  • releaseDate
  • songDuration
  • songTitle

これらのイベントごとにプロパティを個別に追加する代わりに、追跡計画マネージャーはこれらのプロパティを独自のプロパティグループに追加できます。 これらのプロパティを含む新しい曲関連イベントを作成するたびに、グループ全体をイベントに追加するだけで済みます。

もう1つの利点は、プロパティを編集または更新するたびに(プロパティ値は除く)、その編集内容がそのプロパティが属するグループが含まれるすべてのイベントに引き継がれることです。

たとえば、トラッキングマネージャーがrecordLabelプロパティをテキスト文字列から数値コードに変更して、レコードラベルの標準化されたデータベースと一致させたいとします。Amplitudeデータに変更を加えるとすぐに、そのプロパティはSongsプロパティグループを使用するすべてのイベントで更新されます。

また、プロパティグループを使用することで、イベントに対して同じプロパティのイテレーションを確実に使用できるようになります。Amplitudeデータでは、プロパティに複数のイテレーションが存在する場合があり、イベントにプロパティを追加する際に混乱を招くことがあります。

プロパティグループを作成する

プロパティグループを作成するには、次の手順に従います。

  1. プロパティ > イベントプロパティに移動し、プロパティグループをクリックします。
  2. + プロパティグループを作成をクリックします。
  3. フライアウト ウィンドウで、グループの名前を入力します。 次に、必要に応じて説明とタグを追加します。
  4. + プロパティを追加をクリックして、このプロパティグループにプロパティを追加します。
  5. ドロップダウンメニューからイベントプロパティを選択します。 見つかるまでスクロールすることも、名前が表示されるまで検索ボックスに名前を入力することもできます。
  6. プロパティグループに含めるすべてのプロパティを追加するまで、前の手順を繰り返します。 Amplitudeは進捗状況を自動的に保存します。

イベントにプロパティグループを追加する

イベントにプロパティグループを追加するには、次の手順に従います。

  1. イベントで、リストにある目的のイベントの名前をクリックします。イベントのフライアウトウィンドウが開きます。
  2. 詳細タブで、プロパティセクションを見つけ、+ プロパティを追加をクリックします。
  3. 表示されるドロップダウン リストでは、既存のプロパティ グループが最初に表示されます。 必要なものを見つけてクリックします。

グループ内のいずれかのプロパティがイベントの直接プロパティとして既に存在している場合、Amplitude データは影響を受けるプロパティとイベントをリストアップした確認ダイアログを表示します。直接マッピングを削除し、代わりにグループを通じてこれらのプロパティを提供することを確認してください。 プロパティは、影響を受けるすべてのイベントに対して稼働状態を維持します。 これは再編成であり、削除ではありません。

プロパティグループのプロパティを変更するには、次の手順を実行します。

  1. プロパティに移動し、プロパティグループをクリックします。
  2. 変更したいグループが見つかるまでスクロールして、そのグループをクリックします。そのフライアウトウィンドウが表示されます。
  3. 変更を加えてください。 変更はすべてのイベントまたはソースに適用されます。

このグループを使用するイベントの直接プロパティとして既に存在するグループにプロパティを追加する場合、Amplitudeデータは確認ダイアログを表示し、影響を受けるイベントを一覧で表示します。直接マッピングを削除し、代わりにグループを通じてプロパティを提供することを確定します。

これは、アクティブなイベントとトラッキングプランに含まれるイベントプロパティにのみ適用されます。 また、カスタムイベントには適用されません。

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