계정 수준의 보고를 사용하려면 먼저 계측을 수행해야 합니다. 프로세스에 포함되는 특정 단계는 데이터를 Amplitude에 어떻게 전송하는지에 따라 달라집니다.
그룹을 계측하고 나면 새로운 드롭다운이 특정 차트의 차트 제어판 오른쪽 모듈에 나타납니다. 그런 다음 계정 수준의 보고를 수행하고, 사용자 또는 그룹이 트리거한 이벤트를 볼지 여부를 지정할 수 있습니다.
참고: Amplitude는 프로젝트당 그룹 유형을 5개로 제한합니다.
SDK
어떤 SDK를 사용하는지에 따라 다음 특정 지침을 따라서 Amplitude의 SDK에서 계정 수준의 보고를 설정할 수 있습니다.
식별 API
Amplitude 서버측에 데이터를 전송하는 경우 식별 개체에 groups 키를 사용하세요. 이렇게 하면 특정 그룹의 사용자가 연결됩니다. Amplitude의 식별 API를 통해 그룹을 계측하는 방법을 자세히 알아보려면 식별 API 문서를 읽어 보세요.
HTTP API
Amplitude 서버측에 데이터를 전송하는 경우 이벤트 개체에 groups 키를 사용하세요. 이렇게 하면 이벤트 수준의 그룹(특정 이벤트에만 지속되는 그룹)이 추가됩니다. Amplitude의 HTTP API를 통해 그룹을 계측하는 방법을 자세히 알아보려면 HTTP API 문서를 읽어 보세요.
Segment
참고: Segment <> Amplitude 클라우드(Segment의 서버측 소스 또는 번들형이 아닌 클라이언트측 통합) 및 기기 모드 통합(번들형 Segment-Amplitude 통합)에서 이제 Segment의 group 호출을 통해 그룹 유형과 그룹 속성을 설정할 수 있습니다. Segment 문서에서 자세히 알아보세요.
Segment를 통해 Amplitude에서 그룹 유형을 설정하려면 다음 Amplitude 옵션 설정을 활성화하고 적절한 값을 제공해야 합니다.
- Group Type Trait: 원하는 그룹 유형이 Segment
group호출의 어떤 특징에 포함되는지 지정합니다. - Group Value Trait: 원하는 그룹 값이 Segment
group호출의 어떤 특징에 포함되는지 지정합니다.
예를 들어 다음과 같은 코드가 있다고 가정해 보겠습니다.
analytics.group("placeholder", {
groupType: "org name", // Segment trait "groupType" groupValue: "Amplitude", // Segment trait "groupValue" employees: "120" // group property });
Segment의 Amplitude 옵션 설정은 다음과 같이 나타납니다.
이 통합에서는 Amplitude의 그룹 유형으로 'org name'을 생성하고 현재 사용자를 'org name' = 'Amplitude'와 연결합니다.
참고: 그룹 호출에서 무엇을 groupID로 전달하는지(위 코드의 "placeholder")는 중요하지 않습니다. Amplitude 쪽에서는 아무 것에도 매핑되지 않기 때문입니다.
계측 코드를 통해 그룹 속성을 설정하려면 Segment에 Segment <> Amplitude 클라우드 모드 통합을 사용하는 소스가 하나 이상 있어야 합니다(Segment의 서버 라이브러리 및 번들형이 아닌 클라이언트측 통합). 사용자 속성 [Amplitude] Library = segment를 포함하는 Amplitude의 데이터는 클라우드 모드 통합을 통해 전송됩니다. 이 사용자 속성을 사용하여 각 Segment 소스에 대해 Amplitude에 설치한 통합 유형을 확인할 수 있습니다. 또는 Amplitude SDK의 함수를 호출하여 그룹 속성을 설정할 수도 있습니다.
analytics.ready(function() { var groupIdentify = new amplitude.Identify().set('employees', 100); amplitude.getInstance().groupIdentify('orgId', '1234', groupIdentify);
});
group 호출에 전달되는 모든 추가 특성은 Amplitude에 그룹 속성으로 표시됩니다. 예를 들어 위 코드의 employees는 Amplitude에서 그룹으로 설정되지 않습니다.
그룹 식별 API를 사용하여 그룹 생성하기
그룹 식별 API를 사용하면 원하는 모든 그룹 속성과 연결된 새로운 그룹을 생성하거나 기존 그룹의 그룹 속성을 업데이트할 수 있습니다. 예시 요청에서 매개변수와 키는 기울임꼴로 처리되어 있습니다. 밑줄 친 값은 특별히 원하는 매개변수로 교체해야 하는 값입니다.
또한 그룹 속성 작업($set, $setOnce, $add, $append, $unset)은 이 그룹 식별 API에서 지원됩니다.
형식 요청
다음과 같이 2개의 요청 매개변수를 사용하여 POST 또는 GET 요청을 https://api.amplitude.com/groupidentify에 전송합니다.
| 매개변수 | 설명 |
|---|---|
| api_key(필수) |
프로젝트 설정 페이지의 API 키입니다. '040062a5d38552315b98302ba4f2f' |
| identification(필수) | 단일 JSON 식별 개체입니다(필드는 아래를 확인). |
예시 요청(단일)
curl --data 'api_key=040062a5d38552315b98302ba4f2f' --data 'identification={"group_properties":{"org csm":"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_properties":{"org csm":"Lucas","org plan":"Enterprise","org owner":"Luis"},"group_value":"success","group_type":"org id"},{"group_properties":{"org csm":"Sarah","org plan":"Growth","org owner":"Sandy"},"group_value":"1234","group_type":"org id"}]' https://api.amplitude.com/groupidentify
참고: 여기에 나열된 업로드 제한은 이 요청에 적용됩니다.
identification 매개변수에 대한 키
다음 키는 JSON 식별 개체에서 전송될 수 있습니다. group_type과 group_value는 모두 필수 요소입니다.
| 키 | 설명 |
|---|---|
|
group_type(필수) string |
그룹의 유형(계정 또는 회사)입니다.
|
|
group_value(필수) string |
위 그룹 유형의 특정 값입니다. "group_type" : "org id", "group_value" : "12345678" or "group_type" : "account name", "group_value" : "Acme Corp" |
|
group_properties(선택 사항) dictionary |
그룹에 연결된 추가 데이터를 나타내는 키-값 쌍의 딕셔너리입니다. 각 개별 값은 Amplitude 대시보드에 그룹 세그먼트로 표시됩니다. 속성 값을 배열에 저장할 수 있으며, 날짜 값은 문자열 값으로 변환됩니다. 또한 그룹 속성 작업( {"arr" : "10000", "cs": ["Justin", "Ben"], "renewal_date": “01/01/2018" } |