このページでは

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は個々のユーザーについてレポートします。 特に指定がない限り、グラフや分析は個々のユーザーデータに基づいています。

多くの場合、これで十分ですが、アカウント、注文ID、グラフなどの集計単位に基づいて作成されたレポートが必要な場合もあります。 Amplitude Accountsアドオンは、グループレベルでそのレポートを提供します。

グループとは、顧客企業、ユーザーチーム、リスナーを含むプレイリストなど、ユーザーの集合が属している可能性があるオブジェクトです。 グループタイプはグループを定義します（organization_id例： 、 account_id、 playlist、 など）company。グループを使用すると、これらの企業の個々のユーザーのみを表示するのではなく、特定のアカウントがプロダクトとどのようにやり取りしているかを把握できます。

このガイドは、アカウントの計測を計画するのに役立つことを目的としています。また、SegmentとSalesforceでAmplitudeアカウントを使用するためのガイダンスも提供しています。

考慮事項

  • アカウントグループとグループプロパティに対する変更は、今後の新しいデータにのみ適用されます。
  • 過去のデータを遡って更新してアカウントグループやグループプロパティを含めることはできません。
  • Amplitudeは、アカウントの実装計画に役立てるために、この計画ワークブックのコピーを作成することをお勧めします。

制限事項

  • プロジェクトごとに最大5種類のグループタイプを計測できます。
  • プロジェクトごとに最大1,000個のアカウントレベルのプロパティを持つことができます。

計装計画

計測グループを作成する前に、イベントレベルのグループとユーザーレベルのグループのどちらを定義すべきかを決定してください。

イベントレベルのグループ

  • ユーザーのジャーニー内の特定のイベントのみを組み込むグループを作成します。
  • Amplitudeはイベントを受信したときにユーザーをグループに割り当てます。
  • イベントを送信するときにイベントペイロードからグループを明示的に削除しない限り、ユーザはグループの一部であり続けます。

ユースケース：

特定のプロダクトに関連するユーザーイベントのみをグループに関連付けることを望む複数プロダクト企業。

Amplitudeはイベントレベルのグループに対して以下のアプローチを採用することを推奨しています。

  • イベントを送信するときに、ユーザーをグループに結び付けます。 ユーザーがグループを離れたり、グループに関連付けられずにイベントを実行したりできる場合は、イベントレベルのグループを使用してください。

  • サーバー側でイベントを送信するには、HTTP V2 API やバッチ API を使用するか、SDK を使用します。

グループの関連付けはユーザーに対して永続しません。 関連するイベントごとにそれを渡してください。

ユーザーレベルのグループ

  • イベントに関係なくユーザーをグループ化します。
  • ユーザーによって実行されたすべてのイベントを特定のグループに帰属させる場合に役立ちます。
  • Amplitudeはユーザーを一度グループに割り当てますが、ユーザーは今後のイベントのためにグループの一部として残ります。 ユーザーレベルのグループからユーザーを削除することはできません。

ユースケース：

「Acme Company」で働くすべてのユーザーを特定のグループに関連付けます。

Amplitudeはユーザーレベルのグループに対して以下のアプローチを採用することを推奨しています。

Identify

identifyコールを使用して、ユーザーをグループに結び付けます。

  • サーバー側で Identify API に送信するか、SDK を使用して識別コールを送信します。

  • 一度設定されると、グループの関連付けはユーザーに対して永久に維持されます。 ユーザーレベルのグループからユーザーを削除することはできません。

グループへの更新は、過去に遡って適用されません。

グループ識別

  • グループ識別コールを使用してグループプロパティを設定および更新します。

  • グループ識別コールをサーバー側でグループ識別APIに送信するか、SDKを使用します。

グループプロパティは、明示的に更新または設定解除されるまで、そのグループに対して保持されます。グループプロパティの更新は、過去に遡って適用されません。

動的グループプロパティ

Amplitudeの動的グループプロパティ機能は、既存のKPIを動的に更新するグループプロパティに変換します。この機能を使用すると、「過去7日間のアクティブユーザー数」や「月間アクティブユーザー数」などのグループプロパティを各グループに追加できます。

この機能の使用方法の詳細と完全な手順については、『動的グループプロパティ』を参照してください。

ベストプラクティス

まずテストプロジェクトを使用する

過去のデータを遡って更新することはできないため、実稼働に移行する前にインストルメンテーションをテストして検証することが重要です。

アカウント実装ワークブックの「タクソノミーとデータQA」タブを使用して、テストのインストルメンテーションを検証します。

グループの値

グループ値は一意である必要があるため、通常は数値です。 Amplitudeでは、人間が読み取り可能で、グループを他のグループと明確に区別できるグループプロパティを送信することをお勧めします。そのため、Amplitudeではこのプロパティによってセグメント化およびグループ化できます。

「アカウント名」グループプロパティを送信するこの例を考えてみましょう。

「アカウント名」プロパティは、人間が読めるバージョンのグループ値に使用できます。

  • グループタイプ：会社
  • グループの価値: 123456789
  • グループプロパティ: アカウント Name = Amplitude

Salesforce連携

Salesforce連携を使用している場合は、連携とGroup Identify APIの両方を使用してグループプロパティを設定および更新できます。

  • グループ識別APIを使用して、Salesforceでは利用できないグループプロパティを設定したり、Salesforce連携を使用してプロパティを同時に操作したりできます。
  • Amplitudeのグループ値は、Salesforceとの同期に使用されるキーです。 この連携を使用したりグループプロパティをプルしたりするには、Amplitudeのグループ値がSalesforceに存在している必要があります。
  • Amplitudeは毎日ジョブを実行します（毎朝UTC時間）。このジョブは、集荷日が現在の日付であるすべてのグループプロパティを更新します。Salesforceとの連携が有効になると、最初の同期は翌日の朝（UTC）に実行されます。
  • 同期間隔は、毎日、毎週、毎月、または特定の日数など、希望の日数に変更できます。 たとえば、最後の更新日が2017年9月1日で、間隔が7日である場合、次の収集日は2017年9月8日です。

Segment 連携

Segmentはまた、イベントレベルまたはユーザーレベルでグループを構造化することも可能で、インストルメンテーションのアプローチはお客様のアプローチによって異なります。

Amplitudeアクション

Amplitude (Actions)のSegmentドキュメント：

このコンテンツはSegmentのドキュメントから提供されており、高レベルのものです。グループとセグメントを使用する方法の詳細については、セグメントのドキュメントを参照してください。

AmplitudeのグループをSegmentで使用するには、以下のアクション設定を有効にし、機能するために必要なデータ値を必ず含める必要があります。これらの設定は、Segmentグループの特性からAmplitudeグループのタイプと値へのマッピングとして機能します。

  • 「Amplitude Group Type」：これは、Group呼び出しのどのトレイトにAmplitudeの「グループタイプ」が含まれているかを指定します。つまり、この方法によって、どのトレイトをグループタイプとして使用すべきかをSegmentに伝えることができます。
  • 「Amplitude Group Value」：これは、Group呼び出しのどのトレイトにAmplitudeの「グループ値」が含まれているかを指定します。これは、グループ値としてどのトレイトを使用するかをSegmentに伝える方法です。

イベントレベルのグループの場合、Amplitudeの送信先にあるトラック、スクリーン、ページコールのマッピングを更新して、「グループ」キーと値のペアを含めるようにしてください（例： group type - group value）。ユーザーレベルのグループの場合、「グループ」キーと値のペアを含めるようにIdentifyコールのマッピングを更新してください。グループのプロパティを送信するには、Group Identifyユーザーのマッピングを更新します。

Amplitude (Actions) 送信先に関する詳細な手順については、Segmentドキュメントを参照してください。

Amplitude Classic

Amplitude（クラシック）のセグメントドキュメント

このコンテンツは、Segmentのドキュメントから提供されており、高レベルのものです。 グループとセグメントを使用する方法の詳細については、セグメントのドキュメントを参照してください。

ユーザーレベルのグループ

ユーザーレベルのグループ送信を有効にするには、Segmentを使用しているお客様はまずグループコールを設定する必要があります。グループコールを構成している場合は、Segmentで次の送信先設定を有効にする必要があります。これらの設定は、Segmentグループの特性からAmplitudeグループのタイプと値へのマッピングとして機能します。

  • Amplitudeグループタイプトレイト：これは、Group呼び出しのどのトレイトがAmplitudeの「グループタイプ」を含むかを指定します。 つまり、この方法は、グループタイプとしてどのトレイトを使用するかをSegmentに伝える方法です。
  • Amplitudeグループ値トレイト：これは、Group呼び出しのどのトレイトがAmplitudeの「グループ値」を含むかを指定します。 これは、どのトレイトをグループ値として使用するかをSegmentに伝える方法です。

たとえば、「Amplitudeグループタイプトレイト」group_typeとして、「Amplitudeグループ値トレイト」としてnameを指定した場合、サンプルグループコールは次のように構造化されます。

js
analytics.group("082108b9-f41d-486g-9d2d-b5ab68bb3d5o", {
  group_type: "Organization",
  name: "ExampleCorp, LLC",
  employees: "20",
  email: "hello@example.com",
});

この例では、group_type name、employees 、email のグループプロパティを作成しています。

「Amplitudeグループのタイプ/値のトレイト」を指定しなかった場合、またはトレイトのいずれかがコールで提供されていなかった場合：

  • Segmentは、ユーザーをタイプが「[Segment] Group」で値が「(Group Id)」のグループに関連付けます。
  • このグループに関連付けられているプロパティはありません。

イベントレベルのグループ

また、Segmentを使用してイベントレベルのグループを設定することもできます。つまり、グループの指定は記録している特定のイベントにのみ適用され、ユーザーに永続することはありません。グループは、Amplitudeに表示したいgroupType-groupValueペアに対応するキーと値のペアを持つインテグレーション固有groupsのプロパティを提供することで指定できます。

js
analytics.track("Clicked Benefits Dropdown", {
  dropdownColor: "blue";
},
{
  integrations: {
    Amplitude: {
      groups: {
        onboarding_cohort: "Summer 2022"
      }
    }
  }
});

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