그룹 식별 API

그룹 식별 API를 사용하여 특정 그룹의 속성을 설정하거나 업데이트할 수 있습니다.Amplitude 계정 추가 기능을 사용하면 그룹 수준에서 분석 기능을 사용할 수 있습니다. 그룹은 고객 회사, 사용자 팀 또는 청취자가 있는 재생 목록과 같이 사용자 집합이 속할 수 있는 객체입니다. 그룹을 사용하면 개별 사용자가 상호 작용하는 방식이 아닌 계정이 제품과 어떻게 상호 작용하는지를 이해할 수 있습니다.

지역

기본 URL은 프로젝트의 데이터 상주 위치에 따라 달라집니다. 이 페이지의 모든 예제에서 프로젝트가 Amplitude의 EU 데이터 센터를 사용하지 않는 한 기본 URL을 사용하십시오. 이 경우 이 표의 EU 기본 URL을 사용하십시오.

이 API는 이벤트 수집 호스트 api2.amplitude.com(기본값) 또는 api.eu.amplitude.com(EU)를 사용합니다. 다른 Amplitude API는 다른 호스트 이름을 사용합니다(예: api.amplitude.com, core.amplitude.com, data-api.amplitude.com, 또는 experiment.amplitude.com). https://analytics.amplitude.com 호스트 이름은 수집 엔드포인트가 아닌 분석 웹 앱(브라우저 UI)입니다.

데이터 상주	기본 URL
기본값	`https://api2.amplitude.com`
EU	`https://api.eu.amplitude.com`

고려 사항

업데이트는 향후 이벤트에만 영향을 미치며 과거 이벤트를 업데이트하지는 않습니다.
이벤트당 최대 5개의 고유 그룹 유형과 총 10개의 그룹을 추적할 수 있습니다.
요청당 최대 그룹 identify 수는 1024개입니다.
요청당 최대 그룹 속성 수는 1024개입니다.
요청당 최대 바이트 크기는 1MB입니다.

요청

그룹 속성을 설정하거나 업데이트합니다.

POST https://api2.amplitude.com/groupidentify

curl --location --request POST '<https://api2.amplitude.com/groupidentify>' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'api_key=<API_KEY>' \
--data-urlencode 'identification=[{"group_properties":{"org csm":"Lucas","org plan":"Enterprise","org owner":"Luis"},"group_type":"Seller","group_value":"12345678"}]'

필수 매개 변수

이름	설명
`api_key`	프로젝트 API 키입니다.
`identification`	단일 JSON 식별 객체 또는 각각 하나의 식별을 나타내는 JSON 객체의 배열입니다.

식별 매개변수 키

키	유형	설명	예제
`group_type`	문자열	그룹 유형입니다.	`"org name"`, `"org id"`
`group_value`	문자열	`group_type`의 특정 값 중 하나입니다.	`"group_type":"org id","group_value":"12345678"` 또는 `"group_type":"account name","group_value":"Acme Corp"`
`group_properties`	객체입니다.	그룹에 연결된 데이터를 나타내는 키-값 쌍의 사전입니다. 각 고유한 값은 Amplitude 대시보드에 그룹 세그먼트로 표시됩니다. 속성 값을 배열에 저장할 수 있습니다. Amplitude는 날짜 값을 문자열 값으로 변환합니다. 다음 작업 표를 참조하십시오.	`{"arr": "10000", "cs": ["Justin", "Ben"], "renewal_date": "01/01/2018"}`

group_properties 는 다음 작업을 지원합니다.

작업	설명
`$set`	특성의 값을 설정합니다.
`$setOnce`	특성 값을 설정하고 특성 값을 재정의하지 않도록 합니다.
`$add`	숫자 속성에 숫자 값을 추가합니다.
`$append and $prepend`	그룹 속성 배열에 값을 추가하거나 그 앞에 추가합니다.
`$unset`	속성을 제거합니다.

상태 코드

코드	메시지
200	성공
400	잘못된 요청입니다. 자세한 내용은 오류 메시지를 참조하십시오.

이 내용이 도움이 되었나요?