アカウントレベルレポートを設定する

アカウントレベルレポートを使用する前に、インストルメント化する必要があります。プロセスに関連する特定のステップは、Amplitudeにデータを送信する方法によって異なります。

グループをインストルメント化すると、新しいドロップダウンは、特定のチャートのチャートコントロールパネルの右側モジュールに表示されます。 次に、アカウントレベルレポートを実行し、ユーザーまたはグループによってトリガーされたイベントを表示するかどうかを指定できます。

**注：**Amplitudeには、プロジェクトごとに5つのグループタイプに制限があります。

SDK

AmplitudeのSDKでアカウントレベルレポートを設定するには、使用しているSDKに応じて、次の特定の指示に従ってください。

• Android SDK
• iOS SDK
• JavaScript SDK

APIを識別する

Amplitudeサーバーサイドにデータを送信する場合は、識別オブジェクトでグループキーを使用します。 これは、特定のグループの特定のユーザーを関連付けます。 AmplitudeのIdentify APIを介してグループをインストルメント化する方法の詳細については、APIドキュメントを識別するを参照してください。

HTTP API

Amplitudeサーバーサイドにデータを送信する場合は、イベントオブジェクトでグループキーを使用します。 これは、イベントレベルグループ（その特定のイベントにのみ固執するグループ）を追加します。 AmplitudeのHTTP APIを介してグループをインストルメント化する方法の詳細については、HTTP APIドキュメントを参照してください。

セグメント

**注：**Segment<> Amplitudeクラウド（セグメントのサーバーサイドソースまたはバンドルされていないクライアントサイド統合のいずれか）とデバイスモード統合（バンドルされたSegment-Amplitude統合）は、セグメントのグループコールを通じて、グループタイプとグループプロパティの両方を設定できるようになりました。 詳細については、セグメントドキュメントを参照してください。

セグメントを介してAmplitudeでグループタイプを設定するには、次のAmplitude先設定を有効にし、適切な値を提供する必要があります。

• **グループタイプトレイト：**これは、セグメントグループコールで、目的のグループタイプを含むトレイトを指定します。
• **グループ値トレイ：**これは、セグメントグループコールで、目的のグループ値を含むトレイトを指定します。

例えば、次のコードがある場合：

analytics.group("placeholder", {
    groupType: "org name", // Segment trait "groupType"     groupValue: "Amplitude", // Segment trait "groupValue"    employees: "120" // group property});

そして、これは、セグメントのAmplitude先設定で：

次に、統合は、Amplitudeでグループタイプとして組織名を作成し、org name = Amplitudeで現在のユーザーを関連付けます。

**注：**この値はAmplitudeの側で何もマッピングされていないため、グループコールでgroupID（上記のコードで、「プレースホルダー」）として渡す内容は、重要ではありません。

インストルメンテーションコードを介してグループプロパティを設定するには、Segment <> Amplitudeクラウドモード統合（Segmentのサーバーライブラリとバンドルされていないクライアントサイド統合）を使用して、Segmentで少なくとも1つのソースが必要です。 ユーザープロパティ [Amplitude] Library = segmentを有するAmplitudeのデータは、クラウドモードインテグレーションを介して送信されます。 このユーザープロパティを使用して、Amplitudeにインストールした統合のタイプを、それぞれのセグメントソースで検証できます。 あるいは、Amplitude SDKの関数を呼び出して、グループプロパティを設定することもできます。

analytics.ready(function() {     var groupIdentify = new amplitude.Identify().set('employees', 100);    amplitude.getInstance().groupIdentify('orgId', '1234', groupIdentify);
});

グループコールに渡す追加のトレイトは、Amplitudeにグループプロパティとして表示されます。 例えば、上記のコードから、従業員は、Amplitudeでグループプロパティとして設定されます。

セグメントのグループメソッドを使用して、グループとグループプロパティを設定できます。 このメソッドを介して、すべてのユーザーイベントには、グループが含まれることに注意してください。 つまり、このコールは、イベントレベルグループよりも、ユーザーレベルグループ（CompanyIDなど）を設定する方が適切であることを意味します。

セグメントのトラックコールでグループを設定する場合は、イベントをグループにアサインできますが、コール内でグループプロパティを設定して更新することはできません。グループプロパティを送信するには、セグメント統合の外で、Amplitude グループ識別APIを直接コールします。

セグメントのトラックコールを介してグループをアサインするには、セグメント先設定内のマッピングタブに移動し、そこでアサインします。

グループ識別APIを使用してグループを作成する

グループ識別APIを使用して、すべての期待されるグループプロパティで紐付けられた新しいグループを作成するか、既存のグループのグループプロパティを更新できます。サンプルリクエストでは、パラメータとキーはイタリック化されています。下線値は、特に関心のあるパラメータで置き換える必要があるものです。

さらに、グループプロパティ操作（$set、$setOnce、$add、$append、$unset）は、このグループ識別APIでサポートされています。

リクエストフォーマット

以下二つのリクエストパラメーターと共に、リクエストをPOSTまたはGETをhttps://api.amplitude.com/groupidentifyに送信します：

リクエスト例（単独）

curl --data '*api\_key*=040062a5d38552315b98302ba4f2f'--data '*identification*={"*group\_properties*":{"org csc":"Lucas","org plan":"Enterprise","org owner":"Luis"},"*group\_value*":"1234","*group\_type*":"org id"}' https://api.amplitude.com/groupidentify

リクエスト例（バッチ）

curl --data '*api\_key*=040062a5d38552315b98302ba4f2f'--data '*identification*=[{"*group\_propert*ies":{"org csc":"Lucas","org plan":"Enterprise","org owner":"Luis"},"group_*v*alue":"success","group_t*ype*":"org id"},{"g*roup\_propert*ies":"org csc":"Sarah","org plan":"Growth","org owner":"Sandy"},"g*rou*p_*value*":"1234","group_type":"org id"}]' https://api.amplitude.com/groupidentify

注：ここにリストされているアップロード制限は、これらのリクエストに適用されます。

識別パラメータのキー

次のキーは、JSON識別オブジェクト内で送信できます。group_typeとgroup_valueの両方が必須であることに注意してください。